Programmeerimise / Kuidas laadida rakendus GitHubi kasutades Git-i ja GitHub Desktopi


Mis on Git, GitHub ja GitHub Desktop?
Git – versioonihaldusprogramm, millega saad oma koodi ajalugu jälgida ja muudatusi hallata. Git võimaldab töödelda erinevaid versioone ning vajadusel varasemaid versioone taastada. Tavaliselt kasutatakse Git-i käsurealt (terminalist).

GitHub – veebipõhine platvorm, mis võimaldab hoida Git-i repositooriume pilves. GitHubis saad oma koodi jagada, teistega koostööd teha ning koodi turvaliselt hoida.

GitHub Desktop – kasutajasõbralik töölauarakendus, millega saad GitHubi kasutada ilma käsurealt käsklusi kirjutamata. Sobib hästi algajatele ja neile, kes eelistavad visuaalset liidest.

“Õppematerjalid“

TeemaKirjeldusLink
Git algtõedMis on Git ja miks seda vaja onGit ametlik dokumentatsioon
GitHubi kasutamineKoodi hoidmine ja jagamine pilvesGitHub Docs
GitHub Desktopi töövoogLihtne viis koodi haldamiseksGitHub Desktop juhend
VersioonihaldusKuidas hallata projektide ajaluguGiti juhend eesti keeles

Samm-sammuline juhend: Rakenduse üleslaadimine GitHubi

1. Uue repositooriumi loomine GitHubis

  1. Mine lehele https://github.com ning logi sisse.
  2. Vajuta paremas ülanurgas “+” märgile ja vali “New repository”.
  3. Kirjuta repositooriumi nimeks näiteks test-repo.
  4. (Soovi korral) Lisa kirjeldus (Description).
  5. Vali nähtavus:
  • Public – repositoorium on kõigile nähtav
  • Private – repositoorium on ainult sulle nähtav
  1. Vajuta Create repository.

    2. Repositooriumi kloonimine oma arvutisse
  2. GitHub Desktopiga (lihtne viis)
  3. Laadi alla ja paigalda GitHub Desktop.
  4. Ava GitHub Desktop rakendus.
  5. Mine GitHubis oma repositooriumi lehele ning vajuta Code > Open with GitHub Desktop.
    Kui automaatselt ei avane, siis kopeeri HTTPS link.
  6. Avanenud aknas vali kaust, kuhu projekt salvestada, ja vajuta Clone.
    Git-i käsurealt
    Vajuta GitHubis oma repositooriumi lehel Code ja kopeeri HTTPS link.
    Ava terminal (Git Bash, Command Prompt).
    Liigu käsuga soovitud kausta:
    cd tee/oma/kausta
    Klooni repositoorium käsuga:
    git clone https://github.com/SINU_KASUTAJA/REPO_NIMI.git
    Liigu projekti kausta:
    “`
    cd REPO_NIMI

Sissejuhatus

Selles juhendis saad samm-sammult teada, kuidas laadida oma projekti (rakendust) GitHub.com lehele kasutades Git-i ja GitHub Desktop-i programme.
2. Repositooriumi kloonimine oma arvutisse

Variant 1: GitHub Desktopiga (lihtsaim viis)

  1. Laadi alla ja paigalda GitHub Desktop.
  2. Ava GitHub Desktop programm.
  3. Ava GitHubis oma repositoorium ning vajuta Code → Open with GitHub Desktop.
    Kui ei avane automaatselt, kopeeri HTTPS link.
  4. GitHub Desktopis avaneb aken.

Vajuta Clone.

Kui link ise ei täitu, kleebi see käsitsi. Vali kaust, kuhu projekt salvestada.

Variant 2: Git käsurealt

  1. Ava repositooriumi leht GitHubis.
  2. Vajuta Code ja kopeeri HTTPS link.
  3. Ava terminal (Git Bash, Command Prompt vms).
  4. Liigu soovitud kausta, näiteks:
   cd /Users/minu_kasutaja/Dokumendid
  1. Klooni repositoorium käsuga:
   git clone https://github.com/SINU_KASUTAJA/REPO_NIMI.git
  1. Liigu projekti kausta:
    “`
    cd REPO_NIMI

3. Projekti loomine (näiteks Hello World)

  1. Ava projekti kaust arvutis.
  2. Loo uus fail, näiteks: hello.py.
  3. Avades faili, kirjuta näiteks:
   print("Hello World!")
  1. Salvesta fail.

4. Koodi üleslaadimine GitHubi (commit ja push)

GitHub Desktopis

  1. Ava GitHub Desktop.
  2. Sinu uued failid on näha vasakul (tavaliselt on need linnukesega märgitud).
  3. Kirjuta lühike selgitus lahtrisse Summary (nt Lisatud Hello World).
  4. Vajuta Commit to main.
  5. Nüüd vajuta üleval Push origin — sinu muudatused lähevad GitHubi üles.

Git käsurealt

  1. Lisa kõik failid:
   git add .
  1. Tee commit:
   git commit -m "Lisatud Hello World"
  1. Saada muudatused GitHubi:
    “`
    git push

5. Tee projektis muudatus ja lae uuesti üles

  1. Muuda faili (nt kirjuta print("Tere, maailm!")).
  2. Salvesta.

GitHub Desktopis:

  • Muudatus ilmub aknasse.
  • Tee uus commit (uus kirjeldus), vajuta Commit to main, siis Push origin.

Git käsurealt:

   git add .
   git commit -m "Muudetud sõnum eesti keelseks"
   git push

Nüüd oskad:

  • Luua uue repositooriumi GitHubis
  • Kloonida selle oma arvutisse
  • Luua ja muuta projekti
  • Saata muudatusi GitHubi (commit & push)
  • Teha projektis muudatusi ja laadida need uuesti üles

Kui midagi jäi ebaselgeks, vaata videot GitHub Desktopi kohta või küsi abi õpetajalt!

Eesti keelVene keelInglise keelSelgitus/Eesmärk
RepositooriumРепозиторийRepositoryKoht, kus hoitakse projekti faile ja nende versioone
KloonimaКлонироватьCloneRepositooriumi koopia tegemine arvutisse
CommitКоммитCommitMuudatuste salvestamine repositooriumis
PushОтправить (push)PushMuudatuste saatmine GitHubi ehk pilve
PullПолучить (pull)PullMuudatuste tõmbamine GitHubist enda arvutisse
BranchВеткаBranchEri arendusliin projekti sees
MergeСлить (merge)MergeHarude ühendamine
FailФайлFileÜksik dokumendiühik projektis
KaustПапкаFolder/DirectoryFailide hoidmise koht projektis
VersioonihaldusУправление версиямиVersion controlTööriist, mis jälgib ja salvestab muudatusi koodis
Kaug-repositooriumУдалённый репозиторийRemote repoGitHubis asuv repositoorium, mitte kohalik
Kohalik repositooriumЛокальный репозиторийLocal repoSinu arvutis olev repositoorium
MuutusИзменениеChangeProjektis tehtud uuendus või parandused
SünkroniseerimaСинхронизироватьSynchronize/SyncAndmete ühtlustamine kohaliku ja kaug-repo vahel
KonfliktКонфликтConflictKui üks ja sama faili muudetakse mitmes kohas korraga
KasutajaПользовательUserIsik, kes GitHubi kasutab

See tabel aitab paremini mõista GitHubi ja Git-i töövoo olulisi termineid.