automation++ - uge 20

1. automation++
TortoiseHg – Part 2

2. TortoiseHg – Part 2
Oprettelse af versionskontrol
Inden 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.

3. TortoiseHg – Part 2
Binaries
Output fra compileren - Bør IKKE versionsstyres.
Diagnosis
Diagnostiske elementer som trace konfigurationer - Versionsstyres normalt ikke.
Logical
Projektets egentlige kildekode – Skal altid versionsstyres.
Physical
Projektets hardware konfigurationer, evt SafeLogic projekt med mere - Skal altid
versionsstyres.
Temp
Midlertidige filer – Bør IKKE versionsstyres.

4. TortoiseHg – Part 2
Lastuser
Information om sidste user der har haft projektet åbnet - Bør IKKE versionsstyres.
[Projektnavn].apj
Projektfil – Skal altid versionsstyres
[Projektnavn].isopen
Midlertidig fil der kun findes så længe projektet er åbent i Automation Studio – Bør IKKE
versionsstyres.
[brugernavn].set
Indeholder information om projektes status da det sidste var åbnet – F.eks hvilken filer der
var åbne - Versionsstyres normalt ikke.

5. Oprettelse af versionskontrol
Praktisk eksempel

6. TortoiseHg – Part 2
Trin 1 – Nyt repository
Dette 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”.

7. TortoiseHg – Part 2
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”

8. TortoiseHg – Part 2
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.

9. TortoiseHg – Part 2
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.

10. TortoiseHg – Part 2
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.

11. TortoiseHg – Part 2
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.

12. TortoiseHg – Part 2
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”

13. TortoiseHg – Part 2
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.

14. TortoiseHg – Part 2
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.

15. TortoiseHg – Part 2
Dette eksempel er lavet med følgende komponenter:
Automation Studio 4.2.1.214
TortoiseHg version 2.10

16. automation++
YOUR GLOBAL PARTNER FOR
AUTOMATION EXCELLENCE