Condividi tramite

Finestra di progettazione del manifesto VSIX

  • Articolo

Modifica un file manifesto del pacchetto VSIX, che imposta il comportamento di installazione per un'estensione di Visual Studio.

Progettazione manifesto VSIX esegue il mapping allo schema VSIX sottostante. Ogni elemento dello schema può essere impostato usando un controllo corrispondente nella finestra di progettazione. Per altre informazioni sullo schema, vedere Informazioni di riferimento sullo schema dell'estensione VSIX 2.0.

Per aprire Progettazione manifesto VSIX, individuare un file source.extension.vsixmanifest in Esplora soluzioni e aprire il file. Se il file non contiene codice XML valido, la finestra di progettazione del manifesto non verrà aperta.

Nota

Il file source.extension.vsixmanifest viene restituito in extension.vsixmanifest al momento della compilazione del pacchetto.

Elenco degli elementi di interfaccia

Progettazione manifesto VSIX contiene quattro sezioni che corrispondono a questi elementi di primo livello dello schema:

  • Metadati UFX
  • Installare le destinazioni
  • Asset
  • Dipendenze

L'area intestazione contiene i controlli seguenti:

  • Product Name descrive il nome dell'estensione.
  • ID prodotto specifica le informazioni di identificazione univoche per questo pacchetto.
  • Author specifica il nome dell'autore dell'estensione.
  • Version specifica il numero di versione dell'estensione.

La scheda Metadati contiene i controlli seguenti:

  • La descrizione fornisce una descrizione testuale dell'estensione da visualizzare in Gestione estensioni.
  • Language specifica la lingua predefinita per il pacchetto, che corrisponde ai dati testuali nel manifesto. L'attributo Language segue la convenzione di codice delle impostazioni locali CLR (Common Language Runtime) per gli assembly di risorse, ad esempio en-us, en, fr-fr. Per impostazione predefinita, il valore è neutro, il che significa che il pacchetto verrà eseguito in qualsiasi versione del linguaggio di Visual Studio.
  • License specifica il file di testo che contiene la licenza utente, se presente.
  • L'icona specifica il file di grafica (.png, .bmp, .jpeg, .ico) che contiene l'icona da visualizzare in Gestione estensioni, se è presente un'icona. L'immagine dell'icona deve essere di 32x32 pixel oppure viene ridimensionata in tali dimensioni. Se non viene specificata alcuna icona, Gestione estensioni usa un'icona predefinita.
  • L'immagine di anteprima specifica il file di grafica (.png, .bmp, .jpeg, .ico) che contiene l'immagine di anteprima da visualizzare in Gestione estensioni, se è presente un'immagine di anteprima. L'immagine di anteprima deve essere di 200x200 pixel. Se non viene specificata alcuna immagine di anteprima, Gestione estensioni usa un'immagine predefinita.
  • I tag aggiungono tag di testo da usare per gli hint di ricerca.
  • Note sulla versione specifica un file (.txt, .rtf) che contiene note sulla versione. Accetta anche l'URL di un sito Web che visualizza le note sulla versione.
  • Guida introduttiva specifica un file (.txt, .rtf) che contiene informazioni su come usare l'estensione o il contenuto nel pacchetto VSIX. Questa guida viene visualizzata al termine dell'installazione dell'estensione. Accetta anche l'URL di un sito Web che visualizza la guida.
  • More Info URL specifica l'URL di un sito Web che contiene informazioni aggiuntive sul prodotto.

La scheda Installa destinazioni contiene i controlli seguenti:

  • Il tipo di installazione elenca l'estensione di Visual Studio e l'SDK di estensione come tipi di installazione di destinazione. Le opzioni variano a seconda del tipo scelto.

    • Estensione di Visual Studio elenca gli elementi InstallationTarget che descrivono come è possibile installare il pacchetto e in cui è possibile installare questa estensione per i prodotti Di Visual Studio. Ogni prodotto viene identificato separatamente in base al nome e a un intervallo di versione o versione. I prodotti possono essere aggiunti all'elenco, modificati ed eliminati. Il nome e la versione di un prodotto corrispondono agli attributi Id e Version dell'elemento InstallationTarget associato.

      • L'intervallo di versioni è [12.0, 14.0] e usa la notazione seguente:
        • [ - Versione minima inclusiva
        • ] - Numero massimo di versioni inclusive
        • ( - versione minima esclusiva
        • ) - versione massima esclusiva
        • Versione singola # - Solo la versione specificata

    • Extension SDK specifica un'installazione globale che non ha come ambito un prodotto e una versione specifici. L'identificatore della piattaforma di destinazione è la piattaforma, ad esempio "Windows", di destinazione. Versione piattaforma di destinazione è la versione, ad esempio 8.0, della piattaforma di destinazione. Nome SDK e Versione SDK sono rispettivamente il nome e il numero di versione dell'SDK.

  • Questo VSIX viene installato per tutti gli utenti (richiede l'elevazione dei privilegi per l'installazione). Se si seleziona questa casella di controllo, l'estensione viene installata per tutti gli utenti; in caso contrario, viene installato solo per l'utente corrente.

  • Questo VSIX viene installato da Windows Installer. Se si seleziona questa casella di controllo, l'estensione viene installata dal file Windows Installer (con estensione msi ). In caso contrario, viene installata come un tipico pacchetto VSIX (file con estensione vsix ).

La scheda Asset contiene i controlli seguenti:

  • Elenco di asset elenca gli elementi asset che descrivono l'estensione o gli elementi di contenuto visualizzati da questo pacchetto. Ogni elemento di estensione o contenuto viene elencato separatamente in base all'origine, al tipo e al percorso. Le estensioni e gli elementi di contenuto possono essere aggiunti all'elenco, modificati ed eliminati. Il tipo e il percorso di un elemento di estensione o contenuto corrispondono agli Type attributi e Path dell'elemento associato Asset . Di seguito sono elencati i tipi noti:

    • Microsoft.visualstudio.package
    • Microsoft.VisualStudio.MefComponent
    • Microsoft.VisualStudio.ToolboxControl
    • Microsoft.VisualStudio.Samples
    • Microsoft.VisualStudio.ProjectTemplate
    • Microsoft.VisualStudio.ItemTemplate
    • Microsoft.VisualStudio.Assembly
    • Microsoft.ExtensionSDK

    Per aggiungere o modificare un asset, è necessario specificare il tipo di asset, se l'asset è un progetto nella soluzione corrente o un file nel file system e il nome del progetto. È anche possibile specificare il nome della cartella in cui essere incorporata.

    È anche possibile creare tipi personalizzati e assegnare loro nomi univoci.

La scheda Dipendenze contiene i controlli seguenti:

  • Name, Source e Version Range elenca gli elementi Dependency di questo pacchetto, che sono altri pacchetti da cui dipende questo pacchetto. Se viene specificato un pacchetto di dipendenza, deve essere installato prima dell'installazione di questo pacchetto; in caso contrario, questo pacchetto deve installarlo.

    I pacchetti di dipendenza vengono specificati da identificatore, nome, intervallo di versioni, origine e modalità di risoluzione della dipendenza. Ogni pacchetto di dipendenza viene elencato separatamente in base al nome, alla versione e all'origine. I pacchetti di dipendenza possono essere aggiunti all'elenco, modificati ed eliminati.

    L'identificatore deve corrispondere all'attributo ID dei metadati del pacchetto di dipendenza. L'origine può essere un progetto nella soluzione corrente, un'estensione attualmente installata o un file. L'impostazione How is dependency resolved può essere il percorso relativo di un pacchetto annidato o l'URL del percorso di download per la dipendenza. L'ID, la versione e la risoluzione del pacchetto di dipendenza corrispondono agli Idattributi , Versione Location dell'elemento associato Dependency .

Vedi anche