This is an old revision of the document!
Git guide
Pentru a vă ușura munca în cadrul laboratoarelor de IRVA, vă recomandăm să lucrați cu Git & GitHub.
Laboratoarele de AR și VR for avea fiecare un repository pe GitHub - întrucât este posibil ca repo-urile să mai primească actualizări pe parcursul semestrului, ar fi ideal să urmați pașii descriși în acest ghid pentru a nu fi nevoie să va clonați / descărcați de multiple ori proiectul.
Link-uri către repo-uri:
- Repo AR: <LINK> (link_repo_original_ar)
- Repo VR: <LINK> (link_repo_original_vr)
Instalare Git
Înainte de toate, asigurați-vă că aveți Git instalat, acesta se poate descărca de aici <LINK>.
- În cazul instării pe Windows
- Asigurați-vă ca aveți bifat “Add Git to PATH”
- Setările implicite ale install wizard-ului ar trebui să fie OK în rest
De asemenea, asigurați-vă că aveți un cont de GitHub creat.
Setup repo local (fork)
Procedura recomandată pentru a putea lucra într-un singur repo este următoarea:
- Realizați un fork al repo-ului original / referință
- Vă clonați fork-ul, pe care puteți apoi lucra pentru a rezolva laboratoarele
- În cazul unor actualizări pe repo-ul original (de ex. actualizăm noi repo-ul pentru un laborator nou), voi vă trageți (pull) aceste modificări în fork și în același timp mențineți modificările voastre
În continuare vă prezentăm procedura pentru a face setup-ul necesar.
1. Fork repo original
De pe web page-ul repo-ului original (de pe GitHub), creați un Fork (aveți un buton special pentru acesta). Fork-ul va crea de fapt o copie a repo-ului original pe contul vostru.
2. Clone fork
Repo-ul forked, cel de pe contul vostru, va trebui să-l clonați acum pe mașina voastră locală.
Navigați la o locație preferată în sistemul vostru de fișiere, din Windows puteți face acolo click-dreapta, Properties > Git Bash here pentru a deschida linia de comandă.
De pe repo-ul forked copiați link-ul către repo (butonul verde Code).
În Git Bash, rulați comanda (atenție, schimbați voi comanda după necesitate)
// Repo AR git clone https://github.com/<username>/<nume_repo_ar_WIP> // Repo VR git clone https://github.com/<username>/<nume_repo_vr_WIP>
3. Adăugare upstream către repo-ul original
Acest pas este necesar pentru a putea primi actualizări în fork-ul vostru. Pentru a urmări repo-ul original, rulați urmatoarea comanda Git (atenție, schimbați voi comanda după necesitate):
git remote add upstream <link_repo_original_ar_sau_vr>
4. Cum actualizez fork-ul pe baza repo-ului original?
Pentru a vizualiza eventuale schimbări în repo-ul original, reulați comanda:
git fetch upstream
Pentru a aplica modificările, rulați:
Fie comanda
git merge upstream/master
Fie comanda
git pull upstream master
În esență, pull face fetch și merge într-o singură acțiune, așadar cea mai rapida variantă este să rulați direct:
git pull upstream master
4. Cum pot lucra pe fork și să aplic schimbările mele (local)?
Puteți lucra în mod obișnui pe repo-ul forked (local). În cazul în care doriți să-l actualizați, de exemplu în urma rezolvării unui laborator, puteți rula:
Pentru a face staging - adică specificăm fișierele pe care dorim să le supunem unui commit:
git add .
git add . pune toate schimbarile în staging area. Ideal, vă recomandăm să verificați în prelabil ce fișiere vor fi incluse în staging area
Așadar, o comanda foarte utilă pentru a vedea starea curentă este
git status
În continuare, după staging, trebuie să faceți commit, care aplică modificările local:
git commit -m "Message here"
În final, pentru a actualiza schimbările pe remote, trebuie să faceți push:
git push
