Git via SourceTree

Denna sida beskriver hur du arbetar med Git versionshanteringssystem via den grafiska klienten SourceTree.

SourceTree är en gratis programvara som finns för både Windows och Mac. Programmet kräver dock en registrering hos Atlassian efter att du har använt programmet i 30 dagar.

Andra sätt att arbeta med filerna från Bitbucket:

• Använda den kommandobaserad git-klienten, se Git via kommandoprompten.
• Via webbgränssnittet på http://bitbucket.org/rivta-domains kan du titta på filer, och även redigera vissa textbaserade filer.
• Många systemutvecklingsmiljöer har inbyggt stöd för Git, t.ex. Eclipse, IntelliJ och Visual Studio.

Innehåll på denna sida:

• Konfiguration
• Klona ett repository
• Markera filer för incheckning (stage)
• Checka in filer (commit)
• Återställa filer (checkout)
• Skicka och hämta förändringar till Bitbucket (push och pull)
• Arbeta med taggar

Installation

SourceTree finns att ladda ned för både Windows och Mac här: https://www.sourcetreeapp.com/.

När du har installerat programmet och startar det första gången kan du välja skip setup om du vill kunna följa nedanstående instruktioner.

Konfiguration

Innan du börjar använda SourceTree behöver du kontrollera inställningarna för namn och e-postadress. Uppgifterna används senare om du ska checka in filer.

Gör så här:

• Öppna programmets inställningar
  • I Windows väljer du "Options" i menyn Tools
  • I Mac OS väljer du "Preferences" i menyn SourceTree
• Kontrollera följande:
  • I rutan Full name ska ditt för- och efternamn stå.
  • I rutan Email address ska din e-postadress stå (samma e-postadress som du registrerat på Bitbucket).

Klona ett repository

För att kunna arbeta med filerna lokalt så behöver du ladda ner dess git repository. Detta kallas "clone" i Git-terminlogi.

1. Surfa till repositoryt på Bitbucket och kopiera adressen uppe till höger på skärmen.
   
2. Gå till SourceTree-programmet och välj Clone...
   • I Windows klickar du på knappen Clone/New
   • I Mac OS klickar du på New Repository och väljer "Clone from URL"
3. Klistra in adressen du kopierade i rutan "Source URL"
4. I rutan "destination path" anger du var på din lokala dator filerna ska laddas ner.
5. Tryck på Clone för att starta nedladdningen
6. Om du inte ser något felmeddelande så laddas nu filerna ned till mappen.

Redigera filer

Du arbetar med filerna med valfritt program via din lokala arbetsmapp.

För att komma till arbetsmappen kan du gå till menyn Actions och välja Show in Explorer/Finder

Markera filer för incheckning (stage)

Om du har gjort ändringar som du vill checka in, behöver du först markera vilka filer det gäller. Git-termen för detta är "stage".

Gå till SourceTree och välj File status -> Working copy i vänstermenyn.

Dina ändrade filer ska nu synas under Unstaged files i den nedre delen av fönstret

Bocka för de filer du vill markera för incheckning. De kommer då att flyttas till den övre delen, "Staged files"

Återställa filer (checkout)

Om du vill ångra ändringar som du gjort i filer gör du så här:

• Välj File status -> Working copy i vänstermenyn
• Leta upp aktuell fil under "Unstaged files"
• Klicka på de tre punkterna efter filnamnet
• Välj Discard file i den meny som kommer upp.

Checka in filer (commit)

När du har markerat några filer för incheckning enligt ovan, kan du checka in dem. Detta kallas "commit".

Klicka på knappen Commit i den övre knappraden.

I textrutan som dyker upp längst ned skriver du ett incheckningsmeddelande. Därefter trycker du på Commit.

Filerna är därefter incheckade i ditt lokala Git-repository, men har fortfarande inte skickats till Bitbucket. För att göra det, se "skicka och hämta förändringar" nedan.

Skicka och hämta förändringar till Bitbucket (push och pull)

Hämta förändringar

För att hämta förändringar från Bitbucket klickar du på knappen Pull i den övre knappraden. SourceTree visar med en röd siffra om det finns uppdateringar som inte har hämtats.

I vanliga fall väljer du följande:

• Pull from repository: origin
• Remote branch to pull: master

Skicka uppdateringar

För att skicka uppdateringar till Bitbucket klickar du på knappen Push i den övre knappraden. SourceTree visar med en röd siffra om det finns uppdateringar som inte har skickats.

I vanliga fall väljer du följande

• Push to repository: origin
• Branches to push: master
• Push all tags

Arbeta med taggar

Inom RIVTA används "tags" för att markera vilken version som motsvarar en specifik release eller releasekandidat

Visa tillgängliga taggar

Du kan se tillgängliga taggar genom att expandera listan tags i vänstermenyn.

Växla till en tag

För att uppdatera din lokala arbetsmapp med den version av filerna som motsvarar en specifik tagg, gör så här:

• Markera önskad tag i vänstermenyn.
• Klicka på knappen Checkout i den övre knappraden.
• Klicka på OK i den dialogruta som kommer upp
• Ett varningsmeddelande om "detached HEAD" kan visas. Det betyder att du bara skall använda denna funktion för att titta på gamla versioner. Du skall inte göra några förändringar när du checkat ut en tag. Tryck på OK

Din arbetsmapp uppdateras med aktuell tag.

För att återgå till den senaste versionen, markera branches -> master till vänster och välj sedan Checkout som ovan.

Skapa en tag

För att skapa en tag, gör så här:

• Välj i vänstermenyn den branch du vill skapa taggen från (i de flesta fall "master")
• I listan över alla commits (incheckningar) som visas i huvudfönstret, markera den sista commit som ska ingå i taggen.
• Klicka på Tag i den övre knappraden

I den dialogruta som kommer upp väljer du följande:

• Tag name: namnet på den tagg som ska skapas
• Commit: Working copy parent (den commit du valde tidigare)
• Bocka för Push tag: origin (så behöver du inte göra en separat push efteråt)

Din tagg ska därefter vara synlig i Bitbuckets webbgränssnitt. Om inte så kanske du glömde att bocka för "push" i dialogrutan. Gör i så fall en manuell push via knappen i den övre knappraden.