====== VS Code - instalace Linux ======

Tento návod byl testovaný na Ubuntu Mate 19.10

===== Instalace VS Code =====

Informace převzaty [[https://linuxize.com/post/how-to-install-visual-studio-code-on-ubuntu-18-04/0|odtud]]

V příkazové řádce spusťte následující příkaky pro instalaci VS Code

<code bash>
sudo apt update
sudo apt install software-properties-common apt-transport-https wget
wget -q https://packages.microsoft.com/keys/microsoft.asc -O- | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://packages.microsoft.com/repos/vscode stable main"
sudo apt update
sudo apt install code
</code>

===== Rozšíření pro překlad a laděni v C++ =====

  - Naistalovat rozšíření [[https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools|C/C++ extension for VS Code]]
  - Rozšíření je možné nainstalovat přes ikonu v levé liště ''%%Extensions%%'' nebo klávesovou zkratka ''%%Ctrl%%''+''%%Shift%%''+''%%X%%'')
  - Pokud nemáte na svém počítači dosud nainstalován překladač, nainstalujte např. g++ nebo clang++ ''sudo apt install g++ clang++''
  - Překladač instalujte do adresáře, který nemá v cestě mezeru. Přidejte cestu k adresáři ''%%bin%%'' do systémové cesty
  - Správnost nastavení ověřte např. tak, že v příkazové řádce (Command Shell) spustíte kompilátor

<code bash>
g++ --version
gdb --version
</code>
===== Nastavení překladu =====

  - Spustťe VS Code
  - Nastavte pohled ''%%Explorer%%'' - horní ikonou v postranní liště nebo klávesovou zkratkou ''%%Ctrl%%''+''%%Shift%%''+''%%E%%''
  - Klikněte na ''%%Open Folder%%'' vyberte pracovní složku (např. nový adresář)
  - Vytvořte nový soubor, např. přes ''%%File > New File%%'', sapište do souboru kód, který chcete přeložit a uložte ho v pracovním adresáři
  - Po výběru menu ''%%Terminal > Configure Default Build Task%%'' si z nabídky vyberte ''%%g++.exe build active file%%''
  - Pokud je třeba upravte konfigurační JSON soubor a uložte ho
  - Otevřete soubor, který chcete přelořit a klávesovou zkratkou ''%%Ctrl%%''+''%%Shift%%''+''%%B%%'' spusťte překlad
  - Program lze spustit v Command Shellu, nebo je možné přímo v prosředí VS Code otevřít nový terminál v pracovním adresáři


===== Přidání rozšíření Platformio IDE do VS Code =====

Toto rozšíředí doporučujeme přidat až ke konci semestru, až bude třeba pracovat s vývojovými kity Nucleo.

//V některých distribucích Linuxu je vyžadováno doinstalování Python 3 a modulu virtualenv://

<code bash>
sudo apt-get install python3-distutils
sudo pip install virtualenv
</code>
===== Přidání rozšíření =====

Následující kroky jsou nezbytné pro nastavení VS Code aby se mohly programovat a ladit STM32 procesory

  - **Extensions**
  - Vyhledat tyto rozšíření **Platformio IDE**, **Cortex-Debug**, **stm32-for-vscode**
  - Install

===== Instalace překladače ARM GCC a debugeru GDB, OpenOCD =====

Informace převzaty [[https://marketplace.visualstudio.com/items?itemName=bmd.stm32-for-vscode|odtud]]

V příkazové řádce spusťte následující příkaky pro instalaci

<code bash>
sudo apt-get install gcc-arm-none-eabi binutils-arm-none-eabi gdb-arm-none-eabi openocd
</code>