Partager via

Déploiement d'une extension de modélisation de couche

  • Article

Les utilisateurs de Visual Studio 2010 Premium et Visual Studio 2010 Ultimate peuvent installer des extensions de modélisation de couche que vous créez à l'aide de Visual Studio 2010 Ultimate et de Visual Studio 2010 Visualization and Modeling Feature Pack ou de Microsoft Visual Studio 2010 Feature Pack 2. Vous devez configurer votre extension afin que le programme d'installation recherche les spécifications correctes. Pour plus d'informations, consultez Packs de fonctionnalités Visual Studio.

Définition des options de déploiement

Pour autoriser l'installation de votre extension sur d'autres ordinateurs, vous devez définir les options suivantes dans source.vsix.manifest dans votre projet VSIX.

Notes

Si vous avez créé votre projet avec un modèle de projet d'extension de couche, ces options doivent déjà être définies. Si vous avez créé un projet VSIX séparé, vous devrez effectuer les modifications suivantes.

  • Éditions Visual Studio prises en charge doit avoir l'une des valeurs suivantes, ou les deux : Visual Studio 2010 Premium et Visual Studio 2010 Ultimate

  • Références VSIX doit inclure le Runtime Visual Studio 2010 Visualization and Modeling Feature Pack, inclus dans le Feature Pack de visualisation et de modélisation et dans Feature Pack 2.

En cas de liste Références VSIX, le programme d'installation vérifie que les extensions spécifiées sont installées sur l'ordinateur cible. Il existe deux autres méthodes permettant d'inclure la référence :

  • En tant que lien Référence. Lorsqu'un utilisateur essaie d'installer votre extension, le programme d'installation vérifie que le Runtime est déjà installé. S'il ne l'est pas, l'utilisateur voit s'afficher un message qui inclut un lien hypertexte vers la page d'installation du Runtime.

  • En tant que charge utile. Lorsqu'un utilisateur installe votre extension, le programme d'installation commence par installer le Runtime, à moins qu'il le soit déjà.

Pour définir un lien de référence pour le Runtime

  1. Dans source.vsix.manifest, cliquez sur Ajouter une référence.

  2. Cliquez sur Sélectionner une extension installée.

  3. Sélectionnez le Runtime pour ce Feature Pack.

Pour inclure le Runtime en tant que charge utile dans le programme d'installation des extensions

  1. Dans source.vsix.manifest, cliquez sur Ajouter une référence.

  2. Cliquez sur Ajouter une charge utile à VSIX.

  3. Cliquez sur le bouton de sélection [...]. Dans la boîte de dialogue, naviguez jusqu'à l'emplacement suivant :

    • Si Visual Studio 2010 Visualization and Modeling Feature Pack est installé :

      %LocalAppData%\Microsoft\VisualStudio\10.0\Extensions\Microsoft\Visualization and Modeling Feature Pack Runtime\1.0\Visualization and Modeling Feature Pack Runtime.vsix

      Notes

      %LocalAppData% est en général NomLecteur:\Users\NomUtilisateur\AppData\Local. Sous Windows XP ou Windows 2003, utilisez %AppData% au lieu de %LocalAppData%.

      ou

    • Si Microsoft Visual Studio 2010 Feature Pack 2 est installé :

      …\Microsoft Visual Studio 10.0\Common7\IDE\Extensions\Microsoft\Visualization and Modeling Feature Pack Runtime\1.0\Visualization and Modeling Feature Pack Runtime.vsix

Installation de votre extension

Votre extension est compilée dans un fichier VSIX, que vous pouvez installer sur d'autres ordinateurs. Vous pouvez également l'installer sur votre ordinateur de développement, pour rendre l'extension disponible dans l'instance principale de Visual Studio.

Pour installer l'extension

  1. Dans le projet qui contient source.vsix.manifest, ouvrez bin\* dans l'Explorateur Windows.

  2. Copiez le fichier *.vsix sur l'ordinateur sur lequel vous souhaitez installer l'extension.

  3. Sur l'ordinateur cible, double-cliquez sur le fichier *.vsix dans l'Explorateur Windows.

    L'installateur VSIX s'ouvre.

Pour désinstaller l'extension

  1. Dans Visual Studio, dans le menu Outils, cliquez sur Gestionnaire d'extensions.

  2. Cliquez sur le nom de l'extension, puis sur Désinstaller.

Installation d'une extension sur un Serveur Team Foundation Build

Normalement, Visual Studio n'est pas installé sur les serveurs Team Foundation Build ; vous ne pouvez donc pas installer VSIX en double-cliquant dessus. L'installation de Team Foundation Build inclut certains composants qui permettent à une extension VSIX de fonctionner, mais vous devez installer l'extension manuellement.

Pour installer votre extension de couche sur un serveur Team Foundation Build

  1. Copiez les fichiers VSIX suivants de votre ordinateur de développement vers l'ordinateur Team Foundation Build :

    • Si Visual Studio 2010 Visualization and Modeling Feature Pack est installé :

      Copiez le Runtime du Feature Pack à partir de l'emplacement suivant : %LocalAppData%\Microsoft\VisualStudio\10.0\Extensions\Microsoft\Visualization and Modeling Feature Pack Runtime\1.0\Visualization and Modeling Feature Pack Runtime.vsix

      Notes

      %LocalAppData% est en général NomLecteur:\Users\NomUtilisateur\AppData\Local. Sous Windows XP ou Windows 2003, utilisez %AppData% au lieu de %LocalAppData%.

      - ou -

      Si Microsoft Visual Studio 2010 Feature Pack 2 est installé :

      Copiez le Runtime du Feature Pack à partir de l'emplacement suivant : …\Microsoft Visual Studio 10.0\Common7\IDE\Extensions\Microsoft\Visualization and Modeling Feature Pack Runtime\1.0\Visualization and Modeling Feature Pack Runtime.vsix

    • Votre VSIX compilé à partir de l'emplacement suivant :

      NomProjetVSIX\bin\*\*.vsix

  2. Sur l'ordinateur Team Foundation Build, placez les fichiers VSIX dans l'un des emplacements suivants :

    • Pour effectuer l'installation pour tous les utilisateurs et services :

      %ProgramFiles%\Microsoft Visual Studio 10.0\Common7\IDE\Extensions\Microsoft

    • Pour effectuer l'installation uniquement pour le service réseau qui exécute Team Foundation Build :

      %WinDir%\ServiceProfiles\NetworkService\AppData\Local\Microsoft\VisualStudio\10.0\Extensions\Microsoft

    • Si vous avez configuré Team Foundation Build pour fonctionner en mode interactif comme un utilisateur particulier, vous pouvez effectuer l'installation juste pour cet utilisateur :

      %LocalAppData%\Microsoft\VisualStudio\10.0\Extensions\Microsoft

      Notes

      %LocalAppData% est en général NomLecteur:\Users\NomUtilisateur\AppData\Local. Sous Windows XP ou Windows 2003, utilisez %AppData% au lieu de %LocalAppData%.

  3. Développez chaque fichier VSIX dans un dossier au même emplacement :

    1. Remplacez l'extension de nom de fichier .vsix par .zip.

    2. Extrayez le contenu du fichier .zip dans un dossier.

    3. Supprimez le fichier .zip.

  4. Redémarrez Team Foundation Build.

Historique des modifications

Date

Historique

Motif

Juin 2010

Ajout de précisions sur AppData et LocalAppData

Commentaires client.

Décembre 2010

Mis à jour pour Microsoft Visual Studio 2010 Feature Pack 2.

Améliorations apportées aux informations.