====== Često postavljana pitanja (FAQ) ======

Odgovori na česta pitanja o WvdS FPC RAD Studio paketu.

===== Instalacija i postavljanje =====

==== Koja verzija VS Code je potrebna? ====

**Minimalno VS Code 1.85.0.** Preporučujemo najnoviju stabilnu verziju.

Provjera:
<code bash>
code --version
</code>

==== Moram li instalirati Lazarus? ====

**Nije obavezno, ali se preporučuje.**

  * **S Lazarusom:** Sve značajke dostupne, lakše postavljanje
  * **Bez Lazarusa:** Samo FPC, bez LCL-GUI projekata

Za Desktop-GUI projekte s LCL-om Lazarus je potreban.

==== Radi li paket na Linuxu/macOS-u? ====

**Da, s ograničenjima.**

^ Značajka ^ Windows ^ Linux ^ macOS ^
| Osnovna kompilacija | Da | Da | Da |
| pas2js | Da | Da | Da |
| Inno Setup Installer | Da | Ne | Ne |
| WSL Cross-Compilation | Da | N/A | N/A |

==== Kako deinstaliram paket? ====

<code bash>
code --uninstall-extension wvds.wvds-vscode-core
code --uninstall-extension wvds.wvds-vscode-build
# ... ostale ekstenzije
</code>

Ili: U VS Code Extensions -> Desni klik -> "Uninstall"

===== Kompilacija =====

==== Zašto FPC ne pronalazi moje unitove? ====

**Mogući uzroci:**

  - **Putanje unitova nisu konfigurirane** - Provjerite postavke projekta
  - **Pogrešna velika/mala slova** - Linux/macOS razlikuju velika i mala slova
  - **Unit nije kompiliran** - Osigurajte da unit postoji

**Rješenje:** Dodajte putanje unitova u postavkama projekta.

==== Što znači "Fatal: Can't find unit..."? ====

FPC ne može pronaći referencirani unit.

**Koraci za rješavanje:**
  - Provjerite ispravnost pisanja u uses klauzuli
  - Provjerite postoji li datoteka unita
  - Dodajte putanju u putanje pretraživanja unitova

==== Kako kompiliram za različite platforme? ====

**Nativna cross-kompilacija:**
  - Instalirajte FPC cross-compiler
  - Odaberite Target u postavkama projekta

**S WSL-om (Windows):**
<code json>
{
  "wvds.toolchain.wslEnabled": true,
  "wvds.toolchain.wslDistribution": "Ubuntu-22.04"
}
</code>

==== Zašto je moja kompilacija spora? ====

**Mogući uzroci:**

  - **Mnogo unitova** - Inkrementalna kompilacija pomaže
  - **Antivirus** - Dodajte iznimku za mapu projekta
  - **Mrežni pogon** - Koristite lokalnu pohranu

**Savjeti:**
  - Koristite "Build" umjesto "Rebuild"
  - Aktivirajte Smart Linking
  - Smanjite debug informacije u Release

===== UI Designer =====

==== Koja je razlika između PXAML i LFM? ====

^ Aspekt ^ PXAML ^ LFM ^
| Format | XML (čitljiv) | Vlasnički |
| Alat | WvdS Designer | Lazarus IDE |
| Ciljevi | GUI, TUI, Web | Samo GUI |
| Kontrola verzija | Diff-prijateljski | Teško |

==== Mogu li konvertirati postojeće LFM datoteke? ====

**Trenutno ne direktno.** PXAML je novi format s drugačijim konceptom.

Alternative:
  * Ponovno stvoriti u Designeru
  * Ručno konvertirati
  * Razvoj alata je planiran

==== Zašto se pregled ne ažurira? ====

**Koraci za rješavanje:**
  - Spremite datoteku (''Ctrl+S'')
  - Provjerite ''wvds.preview.autoRefresh''
  - Izvršite ''WVDS: Refresh Preview''
  - Provjerite PXAML sintaksne greške

==== Podržava li Designer Data Binding? ====

**Da, ali ograničeno za vrijeme dizajna.**

  * Binding sintaksa je podržana
  * Statičke vrijednosti se prikazuju
  * Stvarno povezivanje podataka samo tijekom izvršavanja

===== Projects =====

==== Kako stvoriti Multi-Project Workspace? ====

  - ''File'' -> ''Add Folder to Workspace...''
  - Dodajte mape projekata
  - ''File'' -> ''Save Workspace As...''

==== Mogu li otvoriti Delphi projekte (.dpr)? ====

**Djelomično.** Sintaksa je podržana, ali:
  * Delphi-specifični unitovi nedostaju
  * VCL nije podržan
  * Projektne datoteke (.dproj) se ne čitaju

Preporuka: Migrirajte projekt na FPC/Lazarus.

==== Kako dijeliti kod između projekata? ====

**Opcije:**

  - **Dijeljena mapa:** Unitovi u zajedničkoj mapi, konfigurirajte putanje
  - **Package:** Stvorite Lazarus package
  - **Kopiranje:** Kopirajte unit (ne preporučuje se)

===== Packaging =====

==== Kako objavim svoju ekstenziju? ====

  - Stvorite Publisher račun na [[https://marketplace.visualstudio.com/manage|VS Marketplace]]
  - Stvorite Personal Access Token na [[https://dev.azure.com|Azure DevOps]]
  - Izvršite ''WVDS: Publish Package''

==== Zašto je moj paket odbijen? ====

**Česti razlozi:**

  * README nedostaje ili je prazan
  * Verzija već objavljena
  * Nevažeći package.json
  * Publisher-ID ne odgovara

Provjerite izlaz u Terminalu za detalje.

==== Mogu li distribuirati privatne ekstenzije? ====

**Da, bez Marketplacea:**

  - Stvorite VSIX paket
  - Distribuirajte datoteku interno (mreža, e-mail, itd.)
  - Instalacija: ''code --install-extension datoteka.vsix''

===== Rješavanje problema =====

==== VS Code prikazuje "Extension not found" ====

**Rješenja:**
  - Ponovno pokrenite VS Code
  - Deinstalirajte i ponovno instalirajte ekstenziju
  - Provjerite Developer Console (''Help'' -> ''Toggle Developer Tools'')

==== "Command not found" kod WvdS naredbi ====

**Rješenja:**
  - Provjerite je li ekstenzija aktivirana
  - Pričekajte potpunu aktivaciju nakon pokretanja
  - Provjerite ovisnosti (je li Core ekstenzija instalirana?)

==== Gdje mogu pronaći zapise? ====

**VS Code Output:**
  - ''View'' -> ''Output''
  - Padajući izbornik: "WvdS"

**Extension Host Log:**
  - ''Help'' -> ''Toggle Developer Tools''
  - Kartica Console

**Build zapisi:**
  - Terminal panel
  - ''binaries/logs/'' (ako je konfigurirano)

==== Kako prijavim grešku? ====

GitHub Issues: [[https://github.com/ArmandoFilho/WvdS.FPC/issues|github.com/ArmandoFilho/WvdS.FPC/issues]]

Molimo navedite:
  * Verziju VS Code
  * Verziju ekstenzije
  * Operacijski sustav
  * Korake za reprodukciju
  * Poruke o greškama (izvadci iz zapisa)

===== Usporedba s alternativama =====

==== WvdS Suite vs. Lazarus IDE ====

^ Aspekt ^ WvdS Suite ^ Lazarus IDE ^
| IDE | VS Code | Vlastiti IDE |
| Jezik | Pascal | Pascal |
| UI format | PXAML (XML) | LFM |
| Web podrška | Da (pas2js) | Ograničena |
| TUI podrška | Da | Ne |
| Proširivost | VS Code ekosustav | Lazarus packagei |
| Krivulja učenja | Plitka (VS Code korisnici) | Srednja |

==== WvdS Suite vs. OmniPascal ====

^ Aspekt ^ WvdS Suite ^ OmniPascal ^
| Fokus | RAD-Studio (potpuni) | Sintaksa + dovršavanje |
| UI Designer | Da | Ne |
| Build sustav | Integrirani | Vanjski |
| Predlošci projekata | Da | Ne |
| Cijena | Besplatno (MIT) | Freemium |

===== Još pitanja? =====

  * **Dokumentacija:** Ove Wiki stranice
  * **GitHub:** [[https://github.com/ArmandoFilho/WvdS.FPC|github.com/ArmandoFilho/WvdS.FPC]]
  * **Issues:** [[https://github.com/ArmandoFilho/WvdS.FPC/issues|Prijave grešaka i zahtjevi za značajke]]