====== VS Code - instalace Windows ======

Tento návod byl testovaný na Windows 10/11, 64-bit

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

  - Stáhnout instalační balíček z [[https://code.visualstudio.com/|této stránky]]
  - Nainstalovat podle pokynů


===== Instalace překladače pro Windows =====

Pokud nemáte na OS Windows nainstalovaný překladač (např. stažený v rámci distribuce Visual Studia nebo jiného IDE), nainstalujte si [[https://sourceforge.net/projects/mingw/files/Installer/|MinGW]], klon překladače GCC. 

<note tip>Pokud ještě nemáte nainstalovaný překladač, doporučujeme nainstalovat rovnou Qt podle návodu [[courses:b2b99ppc:howtos:qt_install_win|Qt - instalace]] a namapovat překladač tam</note>

<note important>Ujistěte se, že máte nainstalovaný překladač s podporou standardu alespoň C<nowiki>++</nowiki> 20

Zavoláním příkazu ''<nowiki>g++ --version</nowiki>'' si ověříte, že máte verzi např.  MinGW >= 11
</note>

Postupujte podle návodu, určite je dobré dodržet:
  * v cestě k překladači by neměl být znak s diakritikou (mezera se dá přežít)
  * je dobrý nápad nastavit systémovou cestu do adresáře, ve kterém je příslušný binární soubor (gcc.exe)
  * nastavit cesty do proměnných prostředí

<note tip>Jak nastavit proměnnou prostředí? Ve Windows 10/11 napište do vyhledávacího okna "promě" (v anglické mutaci "env") a systém vám nabídne ovládací panel **Upravit proměnné prostředí systému**. 
Alternativně můžete kliknout pravým tlačítkem na Tento Počítač (This PC) a dát Vlastnosti (Properties), následně vybrat pokročilé nastavení systému (Advanced system settings)</note>

Windows 10:
| {{courses:b2b99ppc:howtos:add_path.png|}} |

Windows 11:
{{ :courses:b2b99ppc:howtos:environmental_w11.jpg |}}

<note important>Po každé změně proměnné Path je třeba restartovat terminál (příkazovou řádku), aby se změna projevila.</note>

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>

===== 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%%'')

===== 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 Line nebo Power shell nebo je možné přímo v prosředí VS Code otevřít nový terminál (power shell) 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.

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

  - Otevřít okno ''%%Extensions%%''
  - Vyhledat tyto rozšíření **Platformio IDE**, **Cortex-Debug**, **stm32-for-vscode**
  - Install

===== Instalace driveru STlink =====

V případě potřeby stáhnout ovladač pro vývojový kit Nucleo ze stránky [[https://www.st.com/content/st_com/en/products/development-tools/software-development-tools/stm32-software-development-tools/stm32-utilities/stsw-link009.html|ST microelectronics]]

===== Odkazy =====

[[https://code.visualstudio.com/docs/cpp/config-mingw|Using Mingw-w64 in VS Code]]