Budowanie

Wymagania

Wymaganie	Szczegóły
Node.js	Wersja LTS
npm	Instalowany razem z Node.js
Windows	Buildy dla Windowsa robi się na Windowsie

Komendy

Komenda	Co robi
`npm run dev`	Uruchamia aplikację w trybie deweloperskim
`npm run dist`	Buduje instalator NSIS i wersję portable
`npm run dist:dir`	Buduje tylko rozpakowany katalog, bez instalatora

Pełny build

git clone https://github.com/Grzybcios/GrzybcioIsland.git
cd GrzybcioIsland
npm install
npm run dist

Gotowe pliki lądują w katalogu release/:

instalator NSIS (.exe z kreatorem instalacji),
wersja portable (.exe uruchamiany bez instalacji).

Szybszy build przy pracy nad kodem

npm run dist:dir

Pomija pakowanie instalatora, więc jest zauważalnie szybszy. Wynik to rozpakowany katalog z plikiem wykonywalnym — wystarczy do sprawdzenia, czy build w ogóle działa.

Konfiguracja w zbudowanej wersji

config.json nie trafia do buildu

Plik config.json jest w .gitignore i nie jest pakowany do wydania. Po instalacji trzeba utworzyć go obok pliku wykonywalnego — skopiuj config.example.json i wpisz swój klucz API.

Typowe problemy przy budowaniu

Objaw	Przyczyna
`npm install` kończy się błędem kompilacji	Brak narzędzi buildowych — zainstaluj Visual Studio Build Tools
`npm run dist` nie tworzy instalatora	Zabrakło miejsca na dysku albo antywirus zablokował zapis w `release/`
Aplikacja startuje i od razu się zamyka	Brak `config.json` albo błąd składni JSON w tym pliku

Sprawdź JSON

Jeden przecinek za dużo albo brakujący cudzysłów potrafi wywalić aplikację przy starcie bez czytelnego komunikatu. Wklej plik do dowolnego walidatora JSON, zanim zaczniesz szukać głębiej.