Distribuzione MSI e VSIX di un linguaggio DSL

Articolo
08/25/2023

È possibile installare una lingua specifica del dominio nel proprio computer o in altri computer. Visual Studio deve essere già installato nel computer di destinazione.

Scelta tra VSIX e distribuzione MSI

Esistono due metodi per distribuire un linguaggio specifico del dominio:

metodo	Vantaggi
VSX (estensione di Visual Studio)	Molto facile da distribuire: copiare ed eseguire il file vsix dal progetto DslPackage. Per altre informazioni, vedere Installazione e disinstallazione di un linguaggio DSL tramite VSX.
MSI (file del programma di installazione)	- Consente all'utente di aprire Visual Studio facendo doppio clic su un file DSL. - Associa un'icona al tipo di file DSL nel computer di destinazione. - Associa un XSD (XML Schema) al tipo di file DSL. In questo modo si evitano avvisi quando il file viene caricato in Visual Studio. È necessario aggiungere un progetto di installazione alla soluzione per creare un'identità del servizio gestito. Per altre informazioni, vedere Distribuzione di un linguaggio DSL tramite un file MSI.

metodo

Vantaggi

VSX (estensione di Visual Studio)

Molto facile da distribuire: copiare ed eseguire il file vsix dal progetto DslPackage.

Per altre informazioni, vedere Installazione e disinstallazione di un linguaggio DSL tramite VSX.

MSI (file del programma di installazione)

- Consente all'utente di aprire Visual Studio facendo doppio clic su un file DSL.
- Associa un'icona al tipo di file DSL nel computer di destinazione.
- Associa un XSD (XML Schema) al tipo di file DSL. In questo modo si evitano avvisi quando il file viene caricato in Visual Studio.

È necessario aggiungere un progetto di installazione alla soluzione per creare un'identità del servizio gestito.

Per altre informazioni, vedere Distribuzione di un linguaggio DSL tramite un file MSI.

Installare e disinstallare un linguaggio DSL usando VSX

Quando il linguaggio DSL è installato da questo metodo, l'utente può aprire un file DSL da Visual Studio, ma il file non può essere aperto da Esplora risorse.

Per installare un linguaggio DSL tramite VSX

Individuare il file vsix compilato dal progetto pacchetto DSL:
1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto DslPackage e quindi scegliere Apri cartella in Esplora file.
2. Individuare il file bin\*\YourProject. DslPackage.vsix
Copiare il file vsix nel computer di destinazione in cui si vuole installare il linguaggio DSL. Può trattarsi del computer in uso o di un altro computer.
- Il computer di destinazione deve avere una delle edizioni di Visual Studio che supporta le licenze DSL in fase di esecuzione. Per altre informazioni, vedere Edizioni di Visual Studio supportate per Visualization & Modeling SDK.
- Il computer di destinazione deve avere una delle edizioni di Visual Studio specificate in DslPackage\source.extensions.manifest.
Nel computer di destinazione fare doppio clic sul file vsix .

Visual Studio Extension Installer si apre e installa l'estensione.
Avviare o riavviare Visual Studio.
Per testare il linguaggio DSL, usare Visual Studio per creare un nuovo file con l'estensione definita per il linguaggio DSL.

Per disinstallare un linguaggio DSL installato tramite VSX

Nel menu Strumenti scegliere Estensioni e aggiornamenti.
Espandere Estensioni installate.
Selezionare l'estensione in cui è definito il linguaggio DSL e quindi fare clic su Disinstalla.

Raramente, un'estensione errata non viene caricata e crea un report nella finestra degli errori, ma non viene visualizzata in Gestione estensioni. In tal caso, è possibile rimuovere l'estensione eliminando il file da:

LocalAppData \Microsoft\VisualStudio\10.0\Extensions

Distribuzione di un linguaggio DSL in un'identità del servizio gestito

Definendo un file MSI (Windows Installer) per il dsl, è possibile consentire agli utenti di aprire file DSL da Esplora risorse. È anche possibile associare un'icona e una breve descrizione all'estensione del nome file. Inoltre, l'identità del servizio gestito può installare un XSD che può essere usato per convalidare i file DSL. Se si vuole, è possibile aggiungere altri componenti nell'identità del servizio gestito che verrà installato contemporaneamente.

Per altre informazioni sui file MSI e altre opzioni di distribuzione, vedere Distribuzione di applicazioni, servizi e componenti.

Per compilare un'identità del servizio gestito, aggiungere un progetto di installazione alla soluzione Visual Studio. Il metodo più semplice per creare un progetto di installazione consiste nell'usare il modello di CreateMsiSetupProject.tt, che è possibile scaricare dal sito VMSDK.

Per distribuire un linguaggio DSL in un'identità del servizio gestito

Impostare InstalledByMsi nel manifesto dell'estensione. In questo modo si impedisce l'installazione e la disinstallazione di VSX, ad eccezione dell'identità del servizio gestito. Questo è importante se si includeranno altri componenti nell'identità del servizio gestito.
1. Aprire DslPackage\source.extension.tt
2. Inserire la riga seguente prima <SupportedProducts>di :
```
<InstalledByMsi>true</InstalledByMsi>
```
Creare o modificare un'icona che rappresenterà il linguaggio DSL in Esplora risorse. Ad esempio, modificare DslPackage\Resources\File.ico
Assicurarsi che gli attributi seguenti del linguaggio DSL siano corretti:
- In Esplora DSL fare clic sul nodo radice e in Finestra Proprietà esaminare:
  - Descrizione
  - Versione
- Fare clic sul nodo Editor e nel Finestra Proprietà fare clic su Icona. Impostare il valore per fare riferimento a un file icona in DslPackage\Resources, ad esempio File.ico
- Nel menu Compila aprire Configuration Manager e selezionare la configurazione che si vuole compilare, ad esempio Release o Debug.
Passare alla home page di Visualization and Modeling SDK e dalla scheda Download scaricare CreateMsiSetupProject.tt.
Aggiungere CreateMsiSetupProject.tt al progetto Dsl.

Visual Studio creerà un file denominato CreateMsiSetupProject.vdproj.
In Esplora risorse copiare Dsl\*.vdproj in una nuova cartella denominata Setup.

Se si vuole, è ora possibile escludere CreateMsiSetupProject.tt dal progetto Dsl.
In Esplora soluzioni aggiungere Setup\*.vdproj come progetto esistente.
Scegliere Dipendenze progetto dal menu Progetto.

Nella finestra di dialogo Dipendenze progetto selezionare il progetto di installazione.

Selezionare la casella accanto a DslPackage.
Ricompila la soluzione.
In Esplora risorse individuare il file MSI compilato nel progetto di installazione.

Copiare il file MSI in un computer in cui si vuole installare il linguaggio DSL. Fare doppio clic sul file MSI. Viene eseguito il programma di installazione.
Nel computer di destinazione creare un nuovo file con estensione di file DSL. l'elenco di controllo seguente.
- Nella visualizzazione elenco esplora risorse il file viene visualizzato con l'icona e la descrizione definita.
- Quando si fa doppio clic sul file, Viene avviato Visual Studio e viene aperto il file DSL nell'editor DSL.
Se si preferisce, è possibile creare manualmente il progetto di installazione anziché usare il modello di testo. Per una procedura dettagliata che include questa procedura, vedere il capitolo 5 del lab di Visualizzazione e Modellazione SDK.

Per disinstallare un dsl installato da un'identità del servizio gestito

In Windows aprire il pannello di controllo Programmi e funzionalità .
Disinstallare il linguaggio DSL.
Riavviare Visual Studio.

Condividi tramite