TortoiseHg - Part2

automation++

TortoiseHg – Part 2


Oprettelse af versionskontrolInden vi gennemgår hvordan man får underlagt sit Automation Studio projekt versionskontrol, så lad os lige se på filstrukturen i et projekt, og hvilke dele der skal versionsstyres. Det er vigtigt kun at versionsstyre de filer der reelt kræves, da commits ellers bliver meget uoverskuelige og repository fylder unødigt meget.


BinariesOutput fra compileren - Bør IKKE versionsstyres.

DiagnosisDiagnostiske elementer som trace konfigurationer - Versionsstyres normalt ikke.

LogicalProjektets egentlige kildekode – Skal altid versionsstyres.

PhysicalProjektets hardware konfigurationer, evt SafeLogic projekt med mere - Skal altid versionsstyres.

TempMidlertidige filer – Bør IKKE versionsstyres.


LastuserInformation om sidste user der har haft projektet åbnet - Bør IKKE versionsstyres.

[Projektnavn].apjProjektfil – Skal altid versionsstyres

[Projektnavn].isopenMidlertidig fil der kun findes så længe projektet er åbent i Automation Studio – Bør IKKE versionsstyres.

[brugernavn].setIndeholder information om projektes status da det sidste var åbnet – F.eks hvilken filer der var åbne - Versionsstyres normalt ikke.

Oprettelse af versionskontrol

Praktisk eksempel


Trin 1 – Nyt repositoryDette eksempel antager, at der allerede er installeret TortoiseHg på computeren

- Link til download kan findes i TortoiseHg – Part 1 indlægget i automation++.

-Vælg altid engelsk som installationssprog.

• Højreklik på projektets mappe og vælge ”TortoiseHg – Create Repository Here”.


Trin 2 – Nyt repository - fortsat

• En dialogboks som ses nedenfor dukker op. Hvis der ikke allerede er klikket af i ”Add special files”, skal dette gøres. Hgignore filen benyttes til at fortælle TortoiseHg hvilken filer i projektmappen den skal ignorere, og altså undlade at versionsstyre.

• Klikkes ”Show in Workbench after init” af, så vil Workbench automatisk åbne efter repositoryet er lavet.

• Klik på ”Create”


Trin 3 – Åbn repository i Workbench

• Hvis ikke der var valgt automatisk åbning i Workbench efter repository init i Trin 2, så åbnes Workbench ved at højreklikke på projektmappen, og vælge ”Hg Workbench”. Læg mærke til det grønne flueben i mappen, der viser at projektet nu er underlagt versionsstyring.


Trin 4 – Projektet i Workbench• Workbench ser ud som vist her. I venstre side vælges mellem repositories, hvis man

har flere projekter under versionskontrol.• Øverst til højre ses oversigten over commits – Øverst vises altid ”Working folder”. Her

har vi endnu ingen commits.• Nederst til højre ses listen over ændrede/nye filer – Her vises samtlige filer i

projektmappen som nye, unversioned (vist med lyserød farve), da vi endnu ikke har comittet første gang.


Trin 5 – hgignore• I trin 4 så vi at alle filer i MyProject mappen blev vist som unversioned i Workbench. Vi

ønsker ikke at comitte alle disse filer. Derfor åbner vi .hgignore filen i en teksteditor (f.eks notepad), og tilføjer de mapper og filer/filtype som vi ønsker at TortoiseHg skal ignorere. Syntaxen for mapper og filtyper kan ses her. Husk at gemme filen.


Trin 6 – Opdater Workbench• Klik på refresh knappen i workbench

• Vi vil nu se at fil-listen fra trin 4 vil opdatere sig og afspejle vores .hginore fil. Alle elementerne der er listet i .hgignore filen vises nu ikke længere, men kun de filer vi rent faktisk ønsker at versionsstyre (logical, physical, .apj...) Læg mærke til at .hgignore filen selv også er listet.


Trin 7 – First commit• Nu er vi klar til at lave vores første commit. Vælg alle filerne, skriv en beskrivelse til.

• Vælg ”Add” for de untracked filer.• Tryk på ”Commit”


Trin 9 – Tjek commit• Nu har vi lavet vores første commit, og projektet er nu under versionsstyring. Vores

commit har fået rev nr 0. Øverst vises altid Working Directory, som er det aktuelle indhold i projektmappen. Det er vigtigt at lave commits ofte når man udvikler. En versionsstyring hvor der først committes efter 14 dages udvikling, har ingen værdi.

• Laves der en ændring i en fil under versionskontrol, vil de ændrede filer kunne ses når vi står på Working Directory. De ændrede filer vil stå må blå tekst, og de konkrete rettelser i filen kan ses nederst i højre hjørne. Disse ændringer kan så tilføjes i et nyt commit.


Vores Automation Studio projekt er nu under versionskontrol. I TortoiseHg Part 3 vil vi se på hvordan man benytter branches i TortoiseHg og hvordan man ruller frem og tilbage mellem sine committede revisioner.


Dette eksempel er lavet med følgende komponenter:

Automation Studio 4.2.1.214

TortoiseHg version 2.10

automation++

YOUR GLOBAL PARTNER FOR AUTOMATION EXCELLENCE

Engineering

TortoiseHg - Part2