FPC Solution Manager

Projektmanagement, Build-System, Debugging und Form Designer für Free Pascal / Lazarus in Visual Studio Code.

Package-ID: wvds.wvds-fpc-solution-manager

Der Solution Manager ist die zentrale Extension für die Free-Pascal-Entwicklung in VSCode. Er bietet:

• Tree View — Hierarchische Darstellung von Projektgruppen, Projekten, Units und Formularen
• Build-System — Build, Rebuild, Clean über lazbuild oder FPC Direct
• Form Designer — Visueller LFM-Editor mit Skin-Unterstützung
• Debugger — Integriertes Debugging mit fpdserver / GDB
• Language Server — Code Completion, Go to Definition, Hover via pasls
• Code Formatter — ptop oder jcf Integration

Die Extension erkennt automatisch Projekte im geöffneten Workspace:

Multi-Root Workspaces werden unterstützt — jeder Workspace-Ordner wird separat gescannt.

Der Tree View erscheint in der Activity Bar (linke Seite) mit dem FPC Solution Manager Icon.

Workspace Folder
├── Projektgruppe (.lpg)
│   ├── Projekt (.lpi)      ← mit Inline Build/Run Buttons
│   │   ├── Units (.pas)
│   │   ├── Formulare (.pas + .lfm)
│   │   ├── Build Modi (Debug, Release, ...)
│   │   ├── Dependencies (Required Packages)
│   │   └── Resources (.rc)
│   └── Projekt 2 ...
├── Package (.lpk)
│   ├── Units
│   └── Required Packages
├── Extension (package.json) ← Virtuelles pas2js-Projekt
│   ├── Units
│   └── npm Dependencies
└── Setup (.iss)             ← InnoSetup Projekt
    └── Sections ([Files], [Run], ...)

Rechtsklick auf Tree-Elemente zeigt kontextabhängige Aktionen:

Projekt:

• Build / Rebuild / Clean
• Build and Run / Run / Stop
• Properties (F4)
• Select Build Mode
• Add Unit / Form / Existing File
• Navigate (Dependencies, Call Hierarchy)

Projektgruppe:

• Build All / Rebuild All / Clean All
• Set Active Project
• Add New/Existing Project

Unit / Form:

• Open File (Enter)
• Reveal in File Explorer
• Copy Path / Copy Relative Path
• Remove from Project
• Show Dependencies / Call Hierarchy

Rechtsklick im Pascal-Editor (.pas, .pp, .lpr) zeigt das FPC Solution Manager Submenü:

• Sort and Remove Unused Units
• Show Call Hierarchy
• Show Dependency Explorer
• Add Watch (nur bei Selektion)

Jedes Projekt kann mehrere Build-Modi haben:

Build-Modus wechseln: Rechtsklick auf Projekt → Select Build Mode oder Ctrl+Shift+M.

In den Settings können Shell-Kommandos definiert werden, die vor/nach jedem Build laufen:

fpc-solution-manager.preBuildCommand: "echo Building {projectName} in {buildMode}"
fpc-solution-manager.postBuildCommand: "copy {outputPath} D:\\Deploy\\"

Verfügbare Variablen: {projectName}, {buildMode}, {projectDir}, {outputPath}

Compiler-Fehler werden automatisch als VSCode Diagnostics angezeigt. Klick auf einen Fehler springt zur entsprechenden Zeile.

Format: Datei(Zeile,Spalte) Severity: Nachricht

• Output Panel (Standard): Ausgabe im VSCode Output-Kanal
• Terminal: Für interaktive CLI-Programme mit stdin — aktivieren über fpc-solution-manager.runInTerminal

Über Select Run Configuration können Kommandozeilen-Argumente und Arbeitsverzeichnis konfiguriert werden.

Der Debugger benötigt fpdserver (Free Pascal Debug Server) als Backend.

fpdserver beschaffen:

• Lazarus-Bundle (ab 3.0): fpdserver ist bereits enthalten (<lazarus>/tools/fpdserver)
• Manuell bauen: Aus dem FPC-Quellcode:

cd <fpc-source>/packages/fcl-passrc/utils/fpdserver
lazbuild --bm=Release fpdserver.lpi

Konfiguration:

• fpc-solution-manager.fpdserverPath — Pfad zu fpdserver.exe (leer = Auto-Erkennung)

Erstelle eine launch.json im .vscode-Ordner des Workspace:

{
  "type": "lazarus",
  "request": "launch",
  "name": "Debug MyApp",
  "program": "${command:fpcse2.getExecutablePath}",
  "cwd": "${workspaceFolder}",
  "stopOnEntry": false,
  "args": []
}

Tipp: ${command:fpcse2.getExecutablePath} ermittelt automatisch den Output-Pfad aus den Projekteinstellungen.

• Breakpoints in .pas und .inc Dateien
• Step In/Out/Over — Schrittweise Ausführung
• Variables — Lokale und globale Variablen inspizieren
• Watches — Ausdrücke überwachen (Ctrl+Alt+W bei Selektion)
• Call Stack — Aufrufkette anzeigen
• Immediate Window — Ausdrücke zur Laufzeit auswerten

• Zeilen-Breakpoints — Klick auf den Zeilenrand in .pas und .inc Dateien
• Bedingte Breakpoints — Rechtsklick auf Breakpoint → Edit Breakpoint → Bedingung eingeben (z.B. i > 100)
• Hit Count — Breakpoint nur nach N Treffern auslösen
• Logpoints — Nachricht in die Konsole ausgeben ohne Programmfluss zu unterbrechen

Ausdrücke zur Laufzeit überwachen:

• Hinzufügen: Ctrl+Alt+W bei selektiertem Text im Pascal-Editor
• Panel: Im unteren Bereich unter FPC Solution Manager → Watches
• Ausdrücke: Variablen, Record-Felder (MyRecord.Field), Array-Indizes (MyArray[0])

Interaktive Auswertung während einer Debug-Sitzung:

• Öffnen: Panel FPC Solution Manager → Immediate
• Ausdruck eingeben und Enter drücken
• Unterstützt: Variablenwerte, Typ-Casts, einfache arithmetische Ausdrücke

Im unteren Panel (FPC-Bereich):

• Immediate — Interaktive Auswertung von Ausdrücken
• Watches — Überwachte Variablen/Ausdrücke

Für erfolgreiches Debugging muss das Projekt im Debug-Modus gebaut werden:

• Build-Modus wechseln: Ctrl+Shift+M → Debug
• Debug-Informationen: Compiler-Flags -g -gl -gw müssen aktiv sein
• Optimierung deaktivieren: Keine -O2 im Debug-Modus

Der Form Designer öffnet sich automatisch für .lfm Dateien.

Der Designer unterstützt Skins für das visuelle Erscheinungsbild:

• fpc-solution-manager.designer.skinName — Aktiver Skin (z.B. WvdS-Shell)
• fpc-solution-manager.designer.skinVariant — Variante (z.B. Amber, Plum)
• fpc-solution-manager.designer.defaultSkinAutoDetect — Automatische Light/Dark-Erkennung basierend auf VSCode-Theme

fpc-solution-manager.designer.zoom — Canvas-Zoom 50% bis 400%.

Zusätzliche Packages mit eigenen Komponenten können registriert werden:

"fpc-solution-manager.designer.componentPackages": [
  "D:\\MyComponents\\mywidgets.lpk"
]

Eigene Formular-Basisklassen für Add Form (Typed):

"fpc-solution-manager.formBaseClasses": [{
  "className": "TWvdSRibbonForm",
  "description": "WvdS Ribbon GUI Form",
  "unitName": "WvdS.Forms.Ribbon",
  "category": "WvdS",
  "hasOwnLfm": true,
  "defaultWidth": 1024,
  "defaultHeight": 768
}]

Öffnet sich für .po Dateien (GNU gettext). Bietet:

• Tabellarische Ansicht aller Übersetzungseinträge (Original → Übersetzung)
• Suche und Filterung nach Schlüssel oder Text
• Direkte Bearbeitung der Übersetzungen im WebView-Panel
• Änderungen werden in die .po Datei zurückgeschrieben

Öffnet sich für .rc Dateien. Bietet:

• Übersicht aller Ressourcen (Icons, Bitmaps, Cursors, String Tables, Version Info)
• Hinzufügen und Entfernen von Ressourcen-Einträgen
• Pfade zu Ressourcen-Dateien bearbeiten

Optionale Integration des Pascal Language Servers für erweiterte Code-Funktionen.

• fpc-solution-manager.pasls.enabled — true (Standard)
• fpc-solution-manager.paslsPath — Pfad zu pasls.exe (leer = Auto-Erkennung)
• fpc-solution-manager.lazarusSourcePath — Lazarus-Quellen für Symbol-Auflösung

Beim Überfahren eines Symbols mit der Maus zeigt der Hover-Tooltip bis zu drei Informationsebenen:

1. Signatur — Die vollständige Deklaration als syntax-gehighlighteter Pascal Code-Block, extrahiert von CodeTools FindSmartHint (z.B. private procedure TMyClass.DoSomething(const A: Integer): Boolean) — inklusive Sichtbarkeit, Klassenname, Parameter-Modifier und Rückgabetyp
2. PasDoc-Dokumentation — Kommentare im Format ( @abstract(…) @param(…) @returns(…) *) direkt aus dem Quellcode, als formatiertes Markdown - Quellposition — Dateiname und Zeilenposition der Deklaration (z.B. MyUnit.pas(42,5)) pasls stellt textDocument/hover bereit und nutzt intern CodeTools FindSmartHint (dieselbe Engine wie Lazarus IDE) für die Signatur-Extraktion. PasDoc-Kommentare werden über GetPasDocComments ausgelesen und serverseitig in Markdown formatiert. Falls pasls nicht verfügbar ist, verwendet die Extension textDocument/definition als Fallback mit client-seitiger Mehrzeilen-Extraktion. Beispiel-Hover: <code> ┌───────────────────────────────────────────────────────────┐ │ private procedure TMyClass.DoSomething(const A: Integer); │ ← Signatur (FindSmartHint) │ ───────────────────────────────────────────────────────── │ │ Führt die Aktion aus. │ ← @abstract │ │ │ Parameters: │ │ - A — Der Wert │ ← @param │ ───────────────────────────────────────────────────────── │ │ Source: MyUnit.pas(42,5) │ ← Quellposition └───────────────────────────────────────────────────────────┘ </code> Unterstützte PasDoc-Tags: | Tag | Beschreibung | Beispiel | ^ @abstract | Kurzbeschreibung | @abstract(Berechnet die Checksumme) | ^ @param | Parameter-Dokumentation | @param(Buffer Die zu prüfenden Daten) | ^ @returns | Rückgabewert | @returns(CRC32-Wert als Cardinal) | ^ @raises | Ausnahmen | @raises(EInvalidOperation Bei leerem Buffer) | <note>PasDoc-Kommentare beginnen mit ( (doppelter Stern). Normale (* Kommentare werden nicht als Dokumentation angezeigt.</note>

Die folgenden Features erfordern serverseitige Unterstützung durch pasls und sind aktuell noch nicht verfügbar:

• Rename Symbol (F2) — Umbenennung eines Symbols über alle Dateien. Erfordert textDocument/rename in pasls.
• Live Diagnostics — Fehler und Warnungen beim Tippen. Erfordert tiefere CodeTools-Integration in pasls.

Ctrl+T öffnet den Workspace Symbol Picker. Hier können Prozeduren, Funktionen, Typen und Variablen über alle Dateien im Workspace gesucht werden.

• Tippe einen Suchbegriff ein → pasls liefert passende Symbole
• Enter navigiert direkt zur Definitionsstelle
• Leere Suche → leere Liste (kein Absturz)

Linux-Builds auf Windows über WSL (Windows Subsystem for Linux).

1. WSL installieren: wsl –install in PowerShell (Administrator)
2. Distribution wählen: z.B. Ubuntu (Standard) oder Debian
3. FPC in WSL installieren:

# In WSL:
sudo apt install fpc lazarus

• fpc-solution-manager.wslEnabled — true
• fpc-solution-manager.wslActiveDistro — WSL-Distribution (z.B. Ubuntu)
• fpc-solution-manager.wslLazbuildPath — Linux-Pfad zu lazbuild (z.B. /usr/bin/lazbuild)
• fpc-solution-manager.wslFpcPath — Linux-Pfad zu fpc

• Select Cross-Compile Target — Zielplattform wählen (x86_64-linux, i386-linux, aarch64-linux)
• Configure WSL — WSL-Einstellungen öffnen
• Build for Linux (WSL) — Linux-Build starten

1. Zielplattform wählen: Rechtsklick auf Projekt → Select Cross-Compile Target
2. Build starten: Build for Linux (WSL) oder Ctrl+Shift+B (wenn WSL-Target aktiv)
3. Die Extension übergibt den Build an lazbuild / fpc innerhalb der WSL-Instanz
4. Output-Dateien landen im konfigurierten Ausgabepfad

Der Unified Project Wizard führt in fünf Schritten vom leeren Workspace zum fertigen Projekt:

1. Intent wählen: Neues FPC-Projekt, neues pas2js-Projekt oder bestehendes öffnen
2. Toolchain-Check: Prüft FPC/Lazarus/pas2js Verfügbarkeit (wird übersprungen wenn alles OK)
3. Projekttyp wählen: Filterbarer Karten-Katalog mit 10 Projekttypen
4. Konfigurieren: Name, Speicherort und typspezifische Optionen
5. Zusammenfassung: Vorschau der generierten Dateien, dann Finish

• Automatisch: Beim Öffnen eines leeren Workspace (deaktivierbar über autoShowStartWizard)
• Command Palette: Ctrl+Shift+P → FPC: New Project…
• Welcome View: Klick auf „New Project Wizard…“ im Solution Manager Panel

Über Ctrl+Shift+P → New Project… steht weiterhin der klassische Projekt-Wizard als Schnellzugriff bereit.

Template-Defaults können in den Settings definiert werden:

• templates.companyName — Firmenname
• templates.author — Autor
• templates.copyright — Copyright-Hinweis

Über Properties (F4) oder Rechtsklick → Properties:

Projektname, Projekttyp, Ausgabepfad, Icon, Version.

• Unit Search Paths (OtherUnitFiles)
• Include Paths
• Library Paths

Build-Modi mit ihren jeweiligen Compiler-Optionen.

Required Packages (z.B. LCL, SynEdit, …).

Sort and Remove Unused Units (Rechtsklick im Pascal-Editor):

• Entfernt nicht verwendete Units aus uses
• Sortiert interface und implementation uses alphabetisch

Show Dependencies — verfügbar im Tree View und im Editor-Kontextmenü:

• Zeigt Unit-Abhängigkeiten als Baum
• Erkennt zirkuläre Referenzen
• Hilft beim Refactoring

Show Call Hierarchy — verfügbar im Tree View und im Editor-Kontextmenü:

Rechtsklick auf eine Unit → Show Call Hierarchy öffnet ein WebView-Panel mit:

• Incoming — Welche Funktionen rufen dieses Symbol auf (Callers)
• Outgoing — Welche Funktionen ruft dieses Symbol auf (Callees)
• Klickbare Einträge navigieren direkt zur Aufrufstelle

Rechtsklick im Pascal-Editor → FPC Solution Manager → Show Call Hierarchy zeigt die Call Hierarchy als Inline-Peek-Widget direkt im Editor an (ähnlich wie Peek Definition). Der Cursor muss auf einem Funktions- oder Methodennamen stehen.

Alle Einstellungen beginnen mit fpc-solution-manager.:

Beim ersten Start erscheint ein interaktiver Walkthrough:

1. Configure Lazarus/lazbuild Path — Toolchain einrichten
2. Open a Project or Project Group — Projekt öffnen
3. Build Your First Project — Erstes Projekt bauen
4. Run Your Application — Programm starten
5. Create a New Project — Neues Projekt erstellen

Erneut öffnen: Ctrl+Shift+P → Getting Started.

• WvdS FPC Tools Übersicht
• Installation und Konfiguration
• FPC PAS2JS Studio
• FPC ISS Designer
• Häufige Fragen (FAQ)