Repository navigation
Sourcetree
Om te beginnen met werken aan een GitHub project, moet je het clonen. Ga naar het project op de GitHub website, en vind de groene "Code" knop op de hoofdpagina. Hier kan je de URL van de repository kopiëren.
Dan kan je Sourcetree openen en ga je naar de "Clone"-pagina.
Daar kan je de URL plakken in de eerste tekstinvoer (Source Path) en kies je een locatie in de tweede tekstinvoer (Destination Path). De locatie zou een lege map moeten zijn op jouw apparaat. Daarna kan je op "Clone" drukken.
Het eerste wat je moet doen wanneer je iets wilt doen op Sourcetree, is fetchen. Fetchen checkt voor updates van bestanden in Git, zodat je niet per ongeluk iets binnenhaalt wat je niet wilt en het bestaan ervan niet van wist. Doe dit door op "Fetch" te drukken en dan op "OK".
Aan de linkerkant kan je alle branches vinden van het project. Onder "Branches" staan al jouw lokale branches (de gene op jouw apparaat). Onder "Remotes" staan alle online branches (de gene op GitHub). Alle remote branches beginnen met origin/, maar dat hoef je nooit in te typen.
Om van branch te wisselen, dubbelklik op de branchnaam. Wanneer je dubbelklikt op een remote branch, wordt ie automatisch gekopieerd naar je lokale branches.
Wanneer je van branch wisselt, zorg ervoor dat Unity volledig is afgesloten! (Uitgezonderd Unity Hub)
Als je nog niet-gecommitted veranderingen hebt, zal het wisselen falen. In dat geval, als je echt moet wisselen zonder te committen, kan je je veranderingen Stashen.
Wanneer je begint met werken aan een nieuwe user story, moet je een nieuwe branch aanmaken. Alle nieuwe branches moeten afstammen van de develop branch. Dus let goed op dat je op deze branch zit wanneer je een nieuwe branch aanmaakt.
Dus wanneer je op develop zit, druk op "Branch" in het menu.
Daarna kan je een naam geven voor de branch. Zorg ervoor dat het aan de naamgeving voldoet.
Wanneer er een nieuwe versie van jouw branch beschikbaar is, wat betekent dat er nieuwe/veranderde bestanden staan op GitHub, dan kan je die veranderingen binnenhalen naar je lokale branch. Nadat je gefetched hebt, kan je zien of er iets te pullen is door te kijken of er een nummer staat op de "Pull" knop. Druk op "Pull" en dan "OK" om de veranderingen binnen te halen.
Stashen is niet aangeraden, maar kan nuttig zijn wanneer het echt nodig is. Stashen is wanneer je je bestanden waar je aan werkt aan de kant zet en bewaard voor later, in plaats van ze te committen.
Wanneer je "Stash" indrukt kan je een naam voor je stash geven. Dit kan een korte naam zijn over waar je mee bezig was.
Je opgeslagen stashes komen onder "Stashes" te staan aan de linkerkant. Druk op rechtermuisknop op de stashnaam om de bestanden toe te voegen aan je huidige branch of verwijder de stash en alle veranderingen die erin staan.
Wanneer je klaar bent met iets of je wilt je huidige werk op de remote branch zetten, dan moet je je werk committen. Aan de linkerkant onder "Workspace" kan je naar "File Status" gaan. Daar kan je je veranderde bestanden zien en ze stagen/committen.
Stagen betekent het selecteren van bestanden die je wilt committen en pushen. Meestal wil je dat voor alle bestanden, en dan kan je op "Stage All" drukken. Je kan ook bestanden in het onderste vlak selecteren en op "Stage Selected" drukken om alleen die bestanden te stagen. De bestanden die zijn gestaged (dus die je gaat committen) komen in het bovenste vlak te staan.
Daarna kan je een commit bericht volgens de commit conventies in de tekstinvoer onderaan invoeren. Je kan ook de checkbox aanvinken om automatisch te pushen.
Nadat je je bestanden hebt gecommitted, kan je ze pushen naar de remote branch. Dit zal de bestanden online op GitHub veranderen naar die van jou.
Wanneer je bestanden van een andere branch nodig hebt of je moet de laatste versie van develop pullen naar jouw huidige branch, dan kan je branches mergen. Om een branch naar jouw huidige branch te mergen, druk op "Merge" in het menu.
Daarna krijg je een scherm waar je de branch/commit kan selecteren die je wilt mergen naar jouw branch. De nieuwste versie van develop is altijd origin/develop. Als je een branch hebt geselecteerd, druk dan op "OK".
Bij een merge conflict zijn er problemen met het samenvoegen van twee verschillende versies van hetzelfde bestand. Dit kan gebeuren en is niet erg. Nadat je geprobeerd hebt om iets te mergen, krijg je dan deze error in beeld.
Druk op "Sluiten" en ga weer naar "File Status". Daar in het onderste vlak staan nu de bestanden die een conflict hebben.
Om een conflict op te lossen, druk met de rechtermuisknop op een bestand en ga naar "Resolve Conflicts". Daar kan je kiezen tussen "Resolve Using 'Mine'" en "Resolve Using 'Theirs'". Dat betekent dat je het bestand kan overschrijven met jouw versie (Mine) of die van de branch die je aan het mergen bent (Theirs).
Wanneer alles is opgelost kan je het meteen committen, het standaard commit bericht kan je zo laten staan.