====== Instalace ======

Zde předpokládáme, že už máte nainstalovanou [[courses:b3b33kui:cviceni:python_version|požadovanou verzi Pythonu]].

===== Instalace potřebných balíčků =====
Abyste mohli ''kuimaze2'' používat, potřebujete mít v Pythonu nainstalované následující balíčky: 
  * ''pillow'', abyste mohli načítat mapy z bitmapobých obrázků,
  * ''tkinter'', abyste mohli použít vizualizaci, a
  * ''numpy'' z různých důvodů, např. abyste mohli řešit soustavy rovnic.

Balíčky si můžete nainstalovat pomocí následujících příkazů z vašeho terminálu (ideálně ve virtuálním prostředí nebo v ''conda'' prostředí):
<code bash>
# On Linux
pip3 install --user numpy
sudo apt-get install python3-pil.imagetk

# On Mac with installed Homebrew package manager
pip3 install numpy
pip3 install Pillow
brew install python-tk

# On Windows
pip3 install numpy
pip3 install Pillow
</code>


===== Zprovoznění ''kuimaze2'' =====

  - Vytvořte si někde na svém disku pracovní adresář. (Doporučujeme vytvořit si pro každou úlohu, na níž budete pracovat, její vlastní pracovní adresář.) Zde budeme předpokládat, že se adresář jmenuje např. ''kui-task''.
  - Existují 2 způsoby, jak dostat ''kuimaze2'' na váš systém: pomocí verzovacího systému ''git'', nebo prostřednictvím ZIP archivu:
    * Pomocí ''git''u: 
      - Ujistěte se, že máte ''git'' nainstalovaný. (Pokud nemáte, [[https://git-scm.com/book/en/v2/Getting-Started-Installing-Git|nainstalujte jej]]).
      - Naklonujte si repozitář kui-maze2:<code python>
cd kui-task
git clone https://gitlab.fel.cvut.cz/kui-student-materials/kui-maze2 .
</code>Nezapomeňte na ''.'' na konci předchozího příkladu: tečka říká ''git''u, aby obsah repozitáře naklonoval do aktuálního pracovního adresáře. Pokud ''.'' neuvedete, git vytvoří ve složce ''kui-task'' podadresář ''kui-maze2'' s obsahem repozitáře (což není to, co v tomto návodu chceme).
    * Pomocí ZIP archivu:
      - Stáhněte si kódy z repozitáře [[https://gitlab.fel.cvut.cz/kui-student-materials/kui-maze2|KUI Maze 2]] jako ZIP soubor (nebo si přímo stáhněte <wrap download>[[https://gitlab.fel.cvut.cz/kui-student-materials/kui-maze2/-/archive/main/kui-maze2-main.zip|kui-maze2-main.zip]]</wrap>).
      - Uvnitř staženého archivu najdete složku ''kui-maze2-main''. Extrahujte její obsah do složky ''kui-task''. (Ve složce ''kui-task'' byste neměli vidět podadresář ''kui-maze2-main''.)
  - Nyní byste ve své složce ''kui-task'' měli (kromě jiných věcí) vidět podadresář ''kuimaze2'' s několika Pythonskými soubory. Ve složce ''kui-task'' byste měli být schopni pracovat na úloze. Pythonské moduly a skripty umístěné a spouštěné z tohoto adresáře by měly být schopny importovat ''kuimaze2'' a další potřebné symboly z tohoto modulu pomocí <code python>
import kuimaze2
</code>

===== Aktualizace ''kuimaze'' =====
Novou, aktualizovanou verzi prostředí (např. na pokyn vyučujících) lze získat následovně:
  * Pokud jste k získání ''kuimaze2'' použili ''git'' (viz výše), stačí ve složce ''kui-task'' spustit příkaz:<code python>
git pull
</code>
  * Pokud jste kódy stáhli ve formě ZIP archivu, stáhněte si je znovu a rozbalte stejným způsobem na stejné místo.
Obě metody způsobí to, že vaše lokální kopie se přepíše novou verzí. Pokud jste tedy do "učitelských" kódů jakkoli zasahovali (což byste neměli), o tyto změny nejspíš přijdete!