Inhaltsverzeichnis

WvdS VSCode Projects

La Projects Extension gestisce i progetti Pascal in VS Code. Offre template di progetto, dialoghi di configurazione e gestione delle solution.

Funzione e scopo

La Projects Extension consente:

Comandi

Comando Descrizione
WvdS Projects: New Project (Quick) Crea un progetto con impostazioni predefinite
WvdS Projects: New Project from Template… Mostra il dialogo di selezione template
WvdS Projects: Open Project Apre un progetto esistente
WvdS Projects: Project Settings… Apre il dialogo delle impostazioni progetto

Template di progetto

L'estensione include template predefiniti per vari tipi di progetto:

Desktop Console

Semplice applicazione console per strumenti da riga di comando e servizi.

File generati:

MyProject/
  MyProject.lpr     -- Programma principale

Codice di esempio:

program MyProject;
 
{$mode objfpc}{$H+}
 
uses
  SysUtils;
 
begin
  WriteLn('Hello, World!');
end.

Casi d'uso:

Desktop GUI

Applicazione desktop nativa con LCL (Lazarus Component Library).

File generati:

MyProject/
  MyProject.lpr     -- Programma principale
  MainForm.pas      -- Unit del form principale
  MainForm.lfm      -- Design del form

Prerequisiti:

Casi d'uso:

Desktop Library

Shared Library (DLL/SO) per sistemi di plugin o integrazione esterna.

File generati:

MyProject/
  MyProject.lpr     -- Progetto libreria

Codice di esempio:

library MyProject;
 
{$mode objfpc}{$H+}
 
uses
  SysUtils;
 
procedure HelloWorld; cdecl;
begin
  WriteLn('Hello from library!');
end;
 
exports
  HelloWorld;
 
begin
end.

Casi d'uso:

TUI App

Terminal User Interface - interfaccia utente basata su testo.

File generati:

MyProject/
  MyProject.lpr     -- Programma principale
  TuiMain.pas       -- Unit TUI principale

Casi d'uso:

Web PWA

Progressive Web App con pas2js - eseguita nel browser.

File generati:

MyProject/
  MyProject.lpr     -- Programma principale (diventa JS)
  index.html.tmpl   -- Template HTML
  manifest.json.tmpl-- Manifest PWA
  sw.js             -- Service Worker

Prerequisiti:

Casi d'uso:

VSCode Extension

Estensione VS Code in Pascal, transpilata con pas2js.

File generati:

MyExtension/
  extension_main.pas   -- Entry Point
  package.json.tmpl    -- Manifest dell'estensione

Prerequisiti:

Casi d'uso:

Installer (Inno Setup)

Installer Windows per applicazioni desktop.

File generati:

MyInstaller/
  MyInstaller.iss    -- Script Inno Setup

Prerequisiti:

Casi d'uso:

Impostazioni progetto

Il dialogo WvdS Projects: Project Settings… offre un'interfaccia grafica per:

Impostazioni generali

Opzioni del compilatore

Dipendenze

Workspace multi-progetto

I workspace di VS Code possono contenere più progetti:

MyWorkspace.code-workspace
  MyApp/          -- Applicazione desktop
  MyLib/          -- Libreria condivisa
  MyTests/        -- Unit test

Creare un workspace

  1. FileAdd Folder to Workspace…
  2. Aggiungete tutte le cartelle dei progetti
  3. FileSave Workspace As…

Selezionare un progetto

Con più progetti:

  1. Aprite un file del progetto desiderato
  2. Oppure: selezionate il progetto nel Project Explorer

Clic destro sui file .lpi/.lpr nell'Explorer mostra:

Risoluzione dei problemi

Il dialogo template non si apre

Causa: Estensione non attivata o errore.

Soluzione:

  1. Verificate se l'estensione è installata
  2. Controllate la Developer Console per errori
  3. Riavviate VS Code

Il progetto non viene riconosciuto

Causa: Nessun file .lpr, .dpr o .pas nella cartella.

Soluzione:

  1. Assicuratevi che esista un file principale
  2. Aprite la cartella con FileOpen Folder…

Le impostazioni del progetto non vengono salvate

Causa: Permessi di scrittura mancanti o configurazione errata.

Soluzione:

  1. Controllate i permessi di scrittura nella cartella del progetto
  2. Verificate settings.json per errori di sintassi

Dettagli tecnici

Proprietà Valore
Extension ID wvds.wvds-vscode-projects
Attivazione workspaceContains:/*.lpr, onLanguage:pascal
Dipendenze wvds-vscode-core
Min. VS Code 1.85.0

Vedere anche