Introduzione al modello di progetto VSIX

  • Articolo

È possibile usare il modello progetto VSIX per creare un'estensione o per creare un pacchetto di un'estensione esistente per la distribuzione. Il modello di progetto VSIX include versioni di Visual Basic e Visual C# e viene installato come parte di Visual Studio SDK.

Il modello di progetto VSIX è costituito solo da un source.extension.vsixmanifest file, che contiene informazioni sull'estensione e sugli asset forniti.

Per trovare il modello di progetto VSIX, è necessario installare Visual Studio SDK. Per altre informazioni, vedere Visual Studio SDK.

Distribuire un modello di progetto personalizzato usando il modello di progetto VSIX

I passaggi seguenti illustrano come usare il progetto VSIX per creare un pacchetto di un modello di progetto che è possibile condividere con altri sviluppatori o caricare in Visual Studio Gallery.

  1. Creare un modello di progetto.

    1. Aprire il progetto da cui creare un modello. Questo progetto può essere di qualsiasi tipo di progetto.

    2. Nel menu Progetto scegliereEsporta modello. Completare i passaggi della procedura guidata.

      Viene creato un .zip file in %USERPROFILE%\My Documents\Visual Studio {version}\My Exported Templates\.

  2. Creare un progetto VSIX vuoto.

    Selezionare File>New (Nuovo) >Project (Progetto). Nella casella di ricerca digitare "vsix" e selezionare la versione C# o Visual Basic del progetto VSIX.

  3. Aggiungere il file .zip al progetto. Impostare la proprietà Copy su Output Directory su Copy Always.

  4. In Esplora soluzioni fare doppio clic sul file source.extension.vsixmanifest per aprirlo in Progettazione manifesto VSIX e quindi apportare le modifiche seguenti:

    • Impostare il campo Product Name (Nome prodotto) su My Project Template (Modello progetto personale).

    • Impostare il campo ID prodotto su MyProjectTemplate - 1.

    • Impostare il campo Autore su Fabrikam.

    • Impostare il campo Descrizione su Modello di progetto personale.

    • Nella sezione Assets aggiungere un tipo Microsoft.VisualStudio.ProjectTemplate e impostarne il percorso sul nome del file .zip.

  5. Salva e chiude il file source.extension.vsixmanifest.

  6. Compilare il progetto.

  7. Nella directory di output fare doppio clic sul .vsix file.

  8. Viene visualizzata una finestra di messaggio del programma di installazione VSIX. Seguire le istruzioni per installare l'estensione.

  9. Chiudere e riaprire Visual Studio.

  10. Selezionare Gestisci estensioni (nel menu Estensioni) e selezionare la categoria Modelli. Una delle estensioni disponibili deve essere Modello di progetto personale.

  11. Il nuovo modello di progetto viene visualizzato nella finestra di dialogo Nuovo progetto nella stessa posizione del modello di progetto originale. Ad esempio, se è stato creato un modello denominato Console VB da un'applicazione console di Visual Basic, la console VB viene visualizzata nello stesso riquadro del modello applicazione console di Visual Basic.

Per specificare il percorso del modello nella finestra di dialogo Nuovo progetto

  1. Le cartelle modello si trovano nelle {Visual Studio Installation Path}\Common7\IDE\ProjectTemplates directory e {Visual Studio Installation Path}\Common7\IDE\ItemTemplates . I nomi delle sezioni di primo livello nella finestra di dialogo Nuovo progetto non corrispondono esattamente ai nomi delle cartelle modello. Dove differiscono, usare il nome della cartella del modello.

    Modificare l'estensione del .vsix file in .zipe quindi aprire il file.

  2. Creare una nuova cartella con lo stesso nome della sezione della finestra di dialogo Nuovo progetto in cui dovrebbe essere visualizzato il modello.

  3. Se il modello deve essere visualizzato in una sottosezione, creare una sottocartella con lo stesso nome.

  4. Spostare il file modello .zip nella nuova cartella.

  5. Modificare l'estensione .zip in .vsix.

  6. Aprire il manifesto VSIX.

  7. Nel manifesto VSIX aggiornare il percorso asset del modello in modo che punti alla radice dell'albero di directory che contiene il file modello. Ad esempio, se il modello è in \CSharp\Windows, il riferimento deve puntare a \CSharp.