Partager via

Concepteur de manifeste VSIX

  • Article

Modifie un fichier manifeste de package VSIX, qui définit le comportement d’installation d’une extension Visual Studio.

Le Concepteur de manifeste VSIX est mappé au schéma VSIX sous-jacent. Chaque élément du schéma peut être défini à l’aide d’un contrôle correspondant dans le concepteur. Pour plus d’informations sur le schéma, consultez référence vsIX Extension Schema 2.0.

Pour ouvrir le Concepteur de manifeste VSIX, recherchez un fichier source.extension.vsixmanifest dans Explorateur de solutions, puis ouvrez le fichier. Si le fichier ne contient pas de code XML valide, le concepteur de manifeste ne s’ouvre pas.

Remarque

Le fichier source.extension.vsixmanifest est généré dans extension.vsixmanifest lorsque le package est généré.

Liste des éléments de l'interface utilisateur

Le Concepteur de manifeste VSIX contient quatre sections qui correspondent à ces éléments de niveau supérieur du schéma :

  • Métadonnées
  • Cibles d’installation
  • Actifs
  • Dépendances

La zone de titre contient les contrôles suivants :

  • Le nom du produit décrit le nom de l’extension.
  • L’ID de produit spécifie les informations d’identification uniques pour ce package.
  • L’auteur spécifie le nom de l’auteur de l’extension.
  • La version spécifie le numéro de version de l’extension.

L’onglet Métadonnées contient les contrôles suivants :

  • La description fournit une description textuelle de l’extension, à afficher dans le Gestionnaire d’extensions.
  • La langue spécifie la langue par défaut du package, qui correspond aux données textuelles du manifeste. L’attribut Language suit la convention de code des paramètres régionaux CLR (Common Language Runtime) pour les assemblys de ressources, par exemple, en, fr-fr. Par défaut, la valeur est neutre, ce qui signifie que le package s’exécute sur n’importe quelle version linguistique de Visual Studio.
  • La licence spécifie le fichier texte qui contient la licence utilisateur, le cas échéant.
  • L’icône spécifie le fichier graphique (.png, .bmp, .jpeg, .ico) qui contient l’icône à afficher dans le Gestionnaire d’extensions, si une icône est présente. L’image d’icône doit être de 32 x 32 pixels ou est redimensionnée à ces dimensions. Si aucune icône n’est spécifiée, Le Gestionnaire d’extensions utilise une icône par défaut.
  • L’image d’aperçu spécifie le fichier graphique (.png, .bmp, .jpeg, .ico) qui contient l’image d’aperçu à afficher dans le Gestionnaire d’extensions, si une image d’aperçu est présente. L’image d’aperçu doit être de 200 x 200 pixels. Si aucune image d’aperçu n’est spécifiée, Le Gestionnaire d’extensions utilise une image par défaut.
  • Les balises ajoutent des balises de texte à utiliser pour les indicateurs de recherche.
  • Les notes de publication spécifient un fichier (.txt, .rtf) qui contient des notes de publication. Prend également l’URL d’un site web qui affiche les notes de publication.
  • Le Guide de prise en main spécifie un fichier (.txt, .rtf) qui contient des informations sur l’utilisation de l’extension ou du contenu dans le package VSIX. Ce guide s’affiche lorsque l’installation de l’extension est terminée. Prend également l’URL d’un site web qui affiche le guide.
  • Plus d’URL d’informations spécifie l’URL d’un site web qui contient des informations supplémentaires sur le produit.

L’onglet Cibles d’installation contient les contrôles suivants :

  • Le type d’installation répertorie les types d’installation et d’extension De Visual Studio en tant que types d’installation cibles. Les options diffèrent, selon le type que vous choisissez.

    • L’extension Visual Studio répertorie les éléments InstallationTarget qui décrivent comment le package peut être installé et dans lequel Visual Studio produit cette extension. Chaque produit est identifié séparément par nom et une version ou une plage de versions. Les produits peuvent être ajoutés à la liste, modifiés et supprimés. Le nom et la version d’un produit correspondent aux attributs Id et Version de l’élément InstallationTarget associé.

      • La plage de versions est [12.0, 14.0] et utilise la notation suivante :
        • [ - version minimale inclusive
        • ] - version maximale inclusive
        • ( - version minimale exclusive
        • ) - version maximale exclusive
        • Version unique # : seule la version spécifiée

    • Le Kit de développement logiciel (SDK) d’extension spécifie une installation globale qui n’est pas étendue à un produit et une version spécifiques. L’identificateur de plateforme cible est la plateforme, telle que « Windows », que vous ciblez. La version de la plateforme cible est la version, telle que la version 8.0, de votre plateforme cible. Le nom et la version du SDK sont respectivement le nom et le numéro de version du SDK.

  • Ce VSIX est installé pour tous les utilisateurs (nécessite une élévation lors de l’installation). Si vous sélectionnez cette zone case activée, l’extension est installée pour tous les utilisateurs ; sinon, elle est installée uniquement pour l’utilisateur actuel.

  • Ce VSIX est installé par Windows Installer. Si vous sélectionnez cette zone case activée, l’extension est installée par le fichier Windows Installer (.msi) ; sinon, elle est installée en tant que package VSIX standard (fichier .vsix).

L’onglet Ressources contient les contrôles suivants :

  • La liste des ressources répertorie les éléments multimédias qui décrivent les éléments d’extension ou de contenu que ce package présente. Chaque extension ou élément de contenu est répertorié séparément par source, type et chemin d’accès. Les extensions et les éléments de contenu peuvent être ajoutés à la liste, modifiés et supprimés. Le type et le chemin d’accès d’une extension ou d’un élément de contenu correspondent aux attributs et Path aux Type attributs de l’élément associéAsset. Les types suivants sont connus :

    • Microsoft.VisualStudio.Package
    • Microsoft.VisualStudio.MefComponent
    • Microsoft.VisualStudio.ToolboxControl
    • Microsoft.VisualStudio.Samples
    • Microsoft.VisualStudio.ProjectTemplate
    • Microsoft.VisualStudio.ItemTemplate
    • Microsoft.VisualStudio.Assembly
    • Microsoft.ExtensionSDK

    Pour ajouter ou modifier une ressource, vous devez spécifier le type de ressource, que la ressource soit un projet dans la solution actuelle ou un fichier dans le système de fichiers et le nom du projet. Vous pouvez également spécifier le nom du dossier dans lequel être incorporé.

    Vous pouvez également créer vos propres types et leur donner des noms uniques.

L’onglet Dépendances contient les contrôles suivants :

  • Name, Source et Version Range répertorie les éléments Dependency de ce package, qui sont d’autres packages dont dépend ce package. Si un package de dépendances est spécifié, il doit être installé avant l’installation de ce package ; sinon, ce package doit l’installer.

    Les packages de dépendances sont spécifiés par identificateur, nom, plage de versions, source et comment la dépendance doit être résolue. Chaque package de dépendances est répertorié séparément par nom, version et source. Les packages de dépendances peuvent être ajoutés à la liste, modifiés et supprimés.

    L’identificateur doit correspondre à l’attribut ID des métadonnées du package de dépendances. La source peut être un projet dans la solution actuelle, une extension actuellement installée ou un fichier. Le paramètre de résolution des dépendances peut être le chemin d’accès relatif d’un package imbriqué ou l’URL de l’emplacement de téléchargement de la dépendance. L’ID, la version et la résolution du package de dépendances correspondent aux attributs et Location aux IdVersionattributs de l’élément associéDependency.

Voir aussi