GitHub oferă o serie de opțiuni și funcționalități care îți permit să lucrezi eficient și să colaborezi cu alți dezvoltatori în proiectele tale.
Iată o prezentare a principalelor opțiuni oferite de GitHub:
- Version Control (Controlul versiunilor):
- GitHub utilizează sistemul de control al versiunilor Git, care îți permite să urmărești modificările efectuate în fișierele proiectului în timp și să revii la versiuni anterioare dacă este nevoie.
- Poți crea commit-uri pentru a salva și descrie modificările făcute în proiect.
- GitHub stochează istoricul complet al commit-urilor, permițându-ți să navighezi și să inspectezi modificările efectuate de tine sau de alți colaboratori.
- Repositories (Repository-uri):
- Repository-ul este locul unde sunt stocate fișierele și istoricul proiectului tău.
- GitHub îți permite să creezi repository-uri publice sau private, în funcție de nevoile tale de confidențialitate.
- Poți să clonezi un repository existent pe dispozitivul tău local, să lucrezi la proiect și să sincronizezi modificările ulterior cu repository-ul original.
- Branching and Merging (Crearea de ramuri și combinarea lor):
- Poți crea ramuri (branches) separate în repository pentru a lucra la modificări sau funcționalități noi fără a afecta ramura principală (de obicei, numită „master” sau „main”).
- După ce modificările dintr-o ramură sunt finalizate și testate, acestea pot fi combinate (merged) în ramura principală.
- Acest flux de lucru facilitează dezvoltarea paralelă și gestionarea mai eficientă a schimbărilor în proiect.
- Pull Requests (Cereri de trageri):
- Oferă un mecanism de colaborare puternic, prin care poți propune modificări într-un repository și poți solicita ca acestea să fie încorporate în ramura principală.
- Alți colaboratori pot revizui și discuta modificările propuse înainte de a fi integrate în proiect.
- Pull Requests facilitează procesul de colaborare și ajută la menținerea unui cod de calitate și bine revizuit.
- Isuues and Project Management (Gestionarea problemelor și proiectelor):
- GitHub oferă un sistem integrat de gestionare a problemelor (issues) și proiectelor, care îți permite să urmărești și să gestionezi sarcinile, erorile sau îmbunătățirile proiectului.
- Poți atribui probleme către diferiți colaboratori, adăuga etichete, seta termene și organiza fluxul de lucru al proiectului.
- Collaboration (Colaborare):
- GitHub facilitează colaborarea între dezvoltatori într-un mod transparent și eficient.
- Poți invita alți utilizatori să colaboreze la proiectele tale, să revizuiască codul, să adauge sugestii și să contribuie cu propria lor muncă.
- Prin intermediul GitHub, poți organiza discuții și dezbateri legate de modificări și îmbunătățiri, facilitând comunicarea și colaborarea în echipă.
Avantajele folosirii GitHub, atât individual, cât și în echipă, sunt următoarele:
- Ușurința în urmărirea și gestionarea modificărilor în proiecte, datorită sistemului de control al versiunilor.
- Posibilitatea de a lucra în paralel pe ramuri separate și de a combina mai târziu modificările într-o singură ramură principală.
- Colaborarea facilă și transparentă între membrii echipei, prin intermediul cererilor de trageri, problemelor și comentariilor.
- Posibilitatea de a organiza și gestiona sarcinile și proiectele într-un mod eficient.
- Partajarea codului și încorporarea contribuțiilor de la alți dezvoltatori, ceea ce facilitează creșterea și îmbunătățirea proiectului.
- Disponibilitatea serviciului GitHub pe platforme diferite și integrarea cu o gamă largă de instrumente de dezvoltare.
Iată pașii pe care îi poți urma pentru a începe și a realiza un proiect utilizând GitHub Desktop CLI pe sistemul de operare Windows:
- Instalează GitHub Desktop CLI:
- Accesează pagina oficială GitHub Desktop (https://desktop.github.com/) și descarcă ultima versiune disponibilă pentru Windows.
- Creează un repository pe GitHub:
- Accesează site-ul GitHub (https://github.com/) și autentifică-te în contul tău sau creează un cont nou dacă nu ai deja unul.
- Apasă pe butonul „New” (Nou) pentru a crea un nou repository.
- Completează detaliile repository-ului, cum ar fi numele, descrierea și opțiunile de confidențialitate. Apoi, apasă pe butonul „Create repository” (Creează repository).
- Clonează repository-ul:
- Deschide GitHub Desktop CLI de pe desktop-ul tău sau caută-l în meniul Start și deschide-l.
- Autentifică-te în contul GitHub dacă nu ai făcut-o deja prin apăsarea butonului „Sign in” (Autentificare) și urmând pașii de autentificare.
- Apasă pe butonul „Add” (Adaugă) și selectează opțiunea „Clone” (Clonează).
- Alege repository-ul pe care tocmai l-ai creat sau selectează un repository existent pe care dorești să-l clonezi.
- Alege un director local unde vrei să clonezi repository-ul și apasă pe butonul „Clone” (Clonează).
- Lucrează la proiect:
- Deschide un editor de text sau un IDE de preferință pentru a edita fișierele proiectului tău.
- Modifică fișierele, adaugă fișiere noi sau șterge fișiere existente în directorul local al repository-ului clonat.
- Salvează modificările și actualizează proiectul conform necesităților tale.
- Sincronizează modificările:
- Deschide GitHub Desktop CLI și vei vedea modificările detectate în panoul de lucru al aplicației.
- În partea stângă, vei vedea lista de fișiere modificate. Pentru fiecare fișier, poți alege să-l selectezi pentru commit (trimitere) sau nu.
- Adaugă un mesaj de commit pentru a descrie succint modificările efectuate.
- Apasă pe butonul „Commit” (Trimitere) pentru a finaliza commit-ul cu modificările tale.
- Apasă pe butonul „Push origin” pentru a sincroniza repository-ul local cu repository-ul de pe GitHub.
- Actualizează și descarcă modificările:
- Dacă lucrezi într-un echipă, este posibil ca alți colaboratori să facă modificări în repository-ul comun.
- Pentru a descărca ultimele modificări, deschide GitHub Desktop CLI și apasă pe butonul „Pull origin” pentru a aduce modificările din repository-ul de pe GitHub în repository-ul tău local.
Pentru a realiza o cerere de tragere (pull request) în ramura principală (de obicei, numită „main” sau „master”), urmează acești pași:
- Creează o ramură nouă:
- Deschide repository-ul tău în GitHub Desktop CLI.
- Asigură-te că ești pe ramura principală („main” sau „master”).
- Apasă pe butonul „Branch” (Ramură) și introdu un nume nou pentru ramura ta.
- Apasă pe butonul „Create branch” (Creează ramură) pentru a crea și schimba în noua ramură.
- Lucrează la modificări:
- Deschide directorul local al repository-ului pe computerul tău, folosind un editor de text sau un IDE.
- Efectuează modificările dorite în fișierele proiectului.
- Salvează modificările.
- Realizează commit și push:
- Deschide GitHub Desktop CLI și vei vedea modificările detectate în panoul de lucru al aplicației.
- Selectează fișierele modificate pe care dorești să le adaugi în commit.
- Adaugă un mesaj descriptiv pentru commit.
- Apasă pe butonul „Commit” (Trimitere) pentru a realiza commit-ul cu modificările tale.
- Apasă pe butonul „Push origin” pentru a sincroniza ramura ta nouă cu repository-ul de pe GitHub.
- Deschide o cerere de tragere:
- Pe pagina repository-ului tău pe GitHub, vei vedea o notificare că ai realizat push la o nouă ramură.
- Apasă pe butonul „Compare & pull request” (Compară și cerere de tragere) lângă notificare sau accesează secțiunea „Pull requests” (Cereri de tragere) a repository-ului și apasă pe butonul „New pull request” (Cerere de tragere nouă).
- Verifică că ramura ta nouă și ramura principală („main” sau „master„) sunt setate corect pentru comparare.
- Adaugă un titlu și o descriere pentru cererea de tragere, explicând ce modificări ai făcut și de ce sunt relevante.
- Apasă pe butonul „Create pull request” (Creează cerere de tragere) pentru a crea cererea și a o trimite colaboratorilor tăi pentru revizuire.
După ce cererea de tragere este creată, alți colaboratori vor putea examina modificările tale, adăuga comentarii și discuta despre propunerea ta. Dacă sunt necesare modificări sau corecții, le poți adăuga pe ramura ta și cererea de tragere se va actualiza automat. Odată ce modificările tale au fost revizuite și aprobate, un colaborator poate merge (merge) cererea de tragere în ramura principală, încorporându-ți astfel modificările în proiect.
Iată pașii pentru a crea un nou branch în GitHub Desktop:
- Deschide aplicația GitHub Desktop pe sistemul tău de operare Windows.
- Selectează repository-ul în care dorești să creezi un nou branch. Repository-ul ar trebui să fie deja clonat și afișat în aplicație.
- În colțul din stânga sus al aplicației, vei vedea numele ramurii curente. Dacă nu este deja „main” sau „master”, asigură-te că te afli pe ramura principală înainte de a crea un nou branch. Poți face clic pe numele ramurii și selecta „main” sau „master” din lista derulantă dacă este nevoie.
- Pe bara de meniu de sus, dă clic pe butonul „Branch” (Ramură). Vei vedea un câmp în care poți introduce numele noului branch.
- Introdu un nume sugestiv și descriptiv pentru noul branch în câmpul respectiv. De exemplu, poți folosi un nume care descrie funcționalitatea sau caracteristica pe care o vei implementa în acest branch.
- Apasă pe butonul „Create branch” (Creează ramură) pentru a crea noul branch. GitHub Desktop va crea automat o copie a ramurii curente cu noul nume.
- După crearea noului branch, vei fi comutat automat pe această ramură nou creată și vei putea începe să lucrezi în cadrul ei.
- Pentru a te asigura că branch-ul nou creat este reflectat și pe GitHub.com, apasă pe butonul „Publish branch” (Publică ramură) din colțul din dreapta sus al aplicației. Aceasta va încărca branch-ul nou creat pe repository-ul de pe GitHub și îl va face disponibil pentru colaboratori și pentru cereri de tragere.
Acum ai creat cu succes un nou branch în GitHub Desktop. Poți începe să lucrezi la modificările tale în acest branch și să faci commit-uri și push-uri pentru a salva și a sincroniza modificările în repository-ul de pe GitHub.
Când primești mesajul „You have changes on this branch. What would you like to do with them?” în GitHub Desktop, înseamnă că ai modificări nesalvate pe ramura curentă și intenționezi să comuți (switch) la o altă ramură. GitHub Desktop te întreabă cum dorești să gestionezi aceste modificări înainte de a comuta. Ai două opțiuni:
- Leave my changes on main (Lasă modificările pe ramura principală): Alegând această opțiune, modificările tale nesalvate vor rămâne pe ramura curentă (de obicei, „main” sau „master”). Astfel, când revii la acea ramură în viitor, modificările tale vor fi disponibile pentru continuarea lucrului.
- Bring my changes to… (Adu modificările mele la…): Alegând această opțiune, modificările tale nesalvate vor fi aduse și transferate pe o altă ramură pe care urmează să comuți. Vei putea selecta dintr-o listă derulantă ramura de destinație către care să aduci modificările.
Selectează opțiunea care corespunde preferințelor tale în funcție de cum dorești să gestionezi modificările tale nesalvate înainte de a comuta la o altă ramură.
Pentru a deschide un pull request în GitHub Desktop, poți urma următorii pași:
- Asigură-te că ai realizat commit și ai încărcat toate modificările pe ramura de la care dorești să creezi pull request-ul. Verifică că ramura locală este actualizată cu ramura remote de pe GitHub.
- Accesează pagina repository-ului pe GitHub.com și navighează la fila „Pull requests„. Apasă pe butonul „New pull request” (Nou pull request).
- Pe pagina „Compare changes” (Compară modificările), vei vedea două meniuri derulante. Ramura de bază trebuie să fie setată pe ramura în care dorești să înglobezi modificările tale (de obicei, ramura principală sau „main”/”master”), iar ramura de „compare” trebuie să fie setată pe ramura unde se află modificările tale.
- Apasă pe butonul „Create pull request” (Creează pull request). Atribuie pull request-ului un titlu semnificativ și o descriere în care să explici modificările pe care le-ai realizat și orice informații relevante pentru revizuire.
- Revizuiește modificările pe care le-ai realizat, fișierele modificate și diferențele dintre cele două ramuri. Poți adăuga comentarii, solicita revizuiri sau atribui revizori la pull request.
- Odată ce ești mulțumit de pull request, apasă din nou pe butonul „Create pull request” (Creează pull request) pentru a-l finaliza și a-l trimite. Aceasta va notifica colaboratorii sau membrii echipei relevante pentru a revizui modificările tale.
După ce a fost deschis pull request-ul, ceilalți pot revizui modificările, lăsa comentarii, sugera modificări sau aproba cererea. Pull request-ul servește ca locație centralizată pentru colaborare și discuții referitoare la modificările propuse. Odată ce modificările au fost revizuite și aprobate, un colaborator poate realiza merge la pull request, înglobând modificările tale în ramura țintă.