Procedura: creare package dei componenti della comunità per utilizzare Visual Studio Content Installer

Articolo
09/12/2008

Aggiornamento: novembre 2007

È possibile creare e condividere elementi per l'utilizzo in Visual Studio. I tipi di elementi possono essere costituiti, ad esempio, da starter kit, macro, frammenti di codice o componenti aggiuntivi. Per semplificare l'utilizzo dell'elemento in Visual Studio da parte di altri sviluppatori, è possibile creare un package dell'elemento all'interno di un file vsi, generalmente denominato componente della community, per consentirne l'installazione mediante Visual Studio Content Installer. Con Visual Studio Content Installer gli elementi nei componenti della community vengono copiati automaticamente nelle directory corrette del computer dello sviluppatore, in modo che vengano visualizzati nelle finestre di dialogo appropriate di Visual Studio.

Per utilizzare Visual Studio Content Installer per l'installazione dei componenti della community, è necessario creare un file vscontent per il componente. Dopo aver creato il file vscontent, è necessario comprimere i file del componente e il file vscontent in un file ZIP e quindi modificare questa estensione in VSI. A questo punto è possibile distribuire il file VSI ad altri sviluppatori con il metodo desiderato: rendendolo disponibile per il download dal Web, inviandolo come allegato di posta elettronica o inserendolo in una condivisione di rete.

.File vscontent

.I file vscontent utilizzano XML basato su Riferimenti dello schema di Visual Studio Content Installer per descrivere i componenti creati e che si desidera condividere. Il file vscontent identifica il tipo di componente e la versione di Visual Studio con cui deve essere utilizzato. Dopo avere creato un file vscontent, è possibile creare il file vsi che Visual Studio Content Installer utilizzerà per installare i componenti nel computer dello sviluppatore.

Per creare un file vscontent di base

Scegliere Nuovo dal menu File, quindi fare clic su File.
Nella categoria Generale selezionare File XML, quindi fare clic su Apri.
Creare un file vscontent valido utilizzando Riferimenti dello schema di Visual Studio Content Installer.

Nota:

Il codice XML di esempio per i file vscontent è disponibile nelle sezioni di Esempio di questo argomento.
Salvare il file vscontent nella stessa directory che contiene gli altri file correlati al componente della community.

Nota:
Il codice XML di esempio per i file vscontent è disponibile nelle sezioni di Esempio di questo argomento.

File VSI

I file di Visual Studio Content Installer (vsi) vengono utilizzati per lo scambio di contenuto Visual Studio nella communnity di sviluppatori. Un file vsi è un file zip rinominato che contiene i seguenti componenti:

Un file vscontent XML che descrive il componente della community.
I file per il componente.

In Visual Studio Content Installer, i file vsi vengono utilizzati per installare i contenuti condivisi nel percorso corretto. Per ulteriori informazioni sulle modalità di installazione dei file vsi, vedere Procedura: installare componenti altrui.

Per l'implementazione di alcune funzionalità di Visual Studio Content Installer sono richiesti strumenti o servizi aggiuntivi.

Per visualizzare le informazioni sull'editore per il componente della community in Visual Studio Content Installer, è necessario firmare il file vsi. Per ulteriori informazioni, vedere Cenni preliminari sulla crittografia.
Per visualizzare un Contratto di licenza con l'utente finale (EULA) in Visual Studio Content Installer, è necessario incorporare queste informazioni nel file zip. WinZip supporta l'inserimento di informazioni incorporate tramite la funzione Comment. Per ulteriori informazioni su WinZip, vedere http://www.winzip.com (informazioni in lingua inglese). Per ulteriori informazioni sulla funzione Comment, vedere la Guida di WinZip.

Per creare un file vsi di base

Creare un file .vscontent valido per il componente, se non ancora creato. Per ulteriori informazioni, vedere la sezione File VSCONTENT in questo argomento.
In Esplora risorse, selezionare i file richiesti per il componente, incluso il file vscontent.
Fare clic con il pulsante destro del mouse sui file selezionati e scegliere Invia a, quindi Cartella compressa.

I file selezionati verranno compressi in un unico file zip.
Rinominare l'estensione del file zip in vsi.

Esempio

Nell'esempio seguente è mostrato un file vscontent per un file vsi contenente un componente aggiuntivo che deve essere utilizzato solo con Visual Studio 2008. I file seguenti verranno inclusi nel file vsi per questo contenuto.

File vscontent contenente l'XML mostrato in questo esempio.
File di registrazione del componente aggiuntivo MyAddin.Addin.
Il file dll compilato del componente aggiuntivo MyAddin.dll.

I file del componente aggiuntivo vengono installati nella seguente directory:

n:\...\My Documents\Visual Studio <versione>\Addins\

Per ulteriori esempi, vedere Procedura: pubblicare modelli di progetto e Procedura: pubblicare frammenti di codice.

<VSContent xmlns="https://schemas.microsoft.com/developer/vscontent/2005"> 
    <Content>
        <FileName>MyAddin.Addin</FileName>
        <FileName>MyAddin.dll</FileName>
        <DisplayName>Example Add-in</DisplayName>
        <Description>An add-in created for this example.</Description>
        <FileContentType>Addin</FileContentType>
        <ContentVersion>2.0</ContentVersion>
    </Content>
</VSContent>

Nell'esempio seguente è mostrato un file vscontent per un file vsi contenente un progetto macro che può essere utilizzato con Visual Studio 2005 o Visual Studio 2008. I file seguenti verranno inclusi nel file vsi per questo contenuto.

File vscontent contenente l'XML mostrato in questo esempio.
File di macro MyMacroProject.vsmacros.

Il file di macro viene installato nella seguente directory:

n:\...\My Documents\Visual Studio <versione>\Projects\VSMacros80\

<VSContent xmlns="https://schemas.microsoft.com/developer/vscontent/2005">
    <Content>
        <FileName>MyMacroProject.vsmacros</FileName>
        <DisplayName>My Macro Project</DisplayName>
        <Description> A macro project created for this example.</Description>
        <FileContentType>Macro Project</FileContentType>
        <ContentVersion>1.0</ContentVersion>
    </Content>
</VSContent>