Installation und Konfiguration

Anleitung zur Einrichtung der WvdS FPC Tools in Visual Studio Code.

1. VSCode öffnen
2. Extensions Sidebar (Ctrl+Shift+X)
3. Suche: WvdS FPC Tools
4. Install klicken — installiert alle drei Extensions automatisch

Falls nur bestimmte Extensions benötigt werden:

code --install-extension wvds-fpc-solution-manager-0.1.0.vsix
code --install-extension wvds-fpc-pas2js-studio-0.1.0.vsix
code --install-extension wvds-fpc-iss-designer-0.1.0.vsix

Download: https://www.freepascal.org/download.html oder via fpcupdeluxe

Empfohlene Installation:

Konfiguration in VSCode:

• fpc-solution-manager.fpcPath — Pfad zum FPC Compiler
• fpc-solution-manager.lazbuildPath — Pfad zu lazbuild
• fpc-solution-manager.lazarusPath — Lazarus-Installationsverzeichnis

Oder: Setup Toolchain Wizard über die Command Palette (Ctrl+Shift+P → Setup Toolchain).

Die Extension erkennt automatisch FPC-Installationen in Standardpfaden.

pas2js ist im Lazarus-Bundle enthalten (ab 3.0). Separater Download:

https://wiki.freepascal.org/pas2js

Konfiguration:

• fpc-pas2js.pas2jsPath — Pfad zu pas2js.exe
• fpc-pas2js.pas2jsRtlPath — Pfad zu pas2js RTL Packages

Download: https://jrsoftware.org/isinfo.php

Konfiguration:

• fpc-iss.innoSetupPath — Pfad zu iscc.exe (z.B. C:\Program Files (x86)\Inno Setup 6\iscc.exe)

Optional aber empfohlen für Code Completion, Go to Definition und Navigation.

Quellcode: https://github.com/castle-engine/pascal-language-server

Mindestanforderungen: FPC >= 3.2.0 + Lazarus (für lazbuild)

# 1. Repository klonen
cd D:\Workspace\3rd
git clone https://github.com/castle-engine/pascal-language-server.git
cd pascal-language-server
git submodule update --init --recursive
 
# 2. Mit lazbuild kompilieren
cd server
C:\Lazarus\lazbuild.exe pasls.lpi
 
# 3. Binary installieren
copy pasls.exe C:\Lazarus\pasls.exe

pasls wird mit Castle Game Engine ausgeliefert (bin/pasls.exe). Nachteil: ~500 MB Download für ein 5-MB-Binary.

• fpc-solution-manager.pasls.enabled — true (Standard)
• fpc-solution-manager.paslsPath — Pfad zu pasls.exe (Auto-Detection sucht in C:\Lazarus, Lazarus-Verzeichnis, FPC-bin-Verzeichnis und PATH)
• fpc-solution-manager.fpcSourcePath — Pfad zu FPC-Quellen (z.B. C:\Lazarus\fpc\3.3.1\source) — wird als FPCDIR an pasls übergeben

pasls kann über eine castle-pasls.ini Datei konfiguriert werden (Log-Pfad, Verbosity). Platziere die Datei neben pasls.exe.

1. Ordner mit .lpi oder .lpg Datei in VSCode öffnen
2. Solution Manager erscheint automatisch in der Activity Bar (links)
3. Projekt-Baum zeigt Units, Formulare, Packages, Dependencies

1. Bei leerem Workspace öffnet sich der Unified Project Wizard automatisch
2. Alternativ: Command Palette Ctrl+Shift+P → FPC: New Project…
3. Intent wählen (FPC nativ, pas2js Web, bestehendes öffnen)
4. Projekttyp, Name und Speicherort konfigurieren
5. Projekt wird erstellt und im Tree View angezeigt

1. Ordner mit package.json (VSCode Extension Manifest) öffnen
2. Solution Manager erkennt das Projekt automatisch als virtuelles pas2js-Projekt
3. Build: Ctrl+Shift+B oder Tree View → Build

Nach der Installation prüfen:

1. Activity Bar: FPC Solution Manager Icon sichtbar?
2. Tree View: Projekte werden erkannt und angezeigt?
3. Build: Ctrl+Shift+B kompiliert erfolgreich?
4. Output: FPC Solution Manager Kanal zeigt Log-Meldungen?

• Prüfen ob package.json, .lpi oder .lpg im Workspace vorhanden ist
• Output Panel → FPC Solution Manager Kanal prüfen
• VSCode neu laden: Developer: Reload Window

• Pfade in den Settings prüfen (fpc-solution-manager.fpcPath)
• Setup Toolchain Wizard ausführen
• Lazarus-Installation verifizieren: fpc -v in Terminal ausführen

• fpc-solution-manager.pasls.enabled auf true setzen
• Pfad zu pasls.exe in fpc-solution-manager.paslsPath setzen
• fpc-solution-manager.fpcSourcePath auf FPC-Quellen zeigen lassen (z.B. C:\Lazarus\fpc\3.3.1\source)
• fpc-solution-manager.lazarusSourcePath muss auf Lazarus-Quellen zeigen
• Output Panel → FPC Solution Manager Kanal prüfen — Log-Zeile pasls initialized successfully. bestätigt den Start
• Manueller Test: echo '{„jsonrpc“:„2.0“,„id“:1,„method“:„initialize“,…}' | pasls.exe — muss JSON-Response liefern

• WvdS FPC Tools Übersicht
• FPC Solution Manager
• FPC PAS2JS Studio
• FPC ISS Designer