Partager via

Comment : définir et installer une extension de modélisation

  • Article

Dans Visual Studio Ultimate, définissez des extensions à des diagrammes de modélisation. Vous pouvez ainsi adapter les diagrammes et les modèles à vos besoins. Par exemple, vous pouvez définir des commandes de menu, des profils UML, des contraintes de validation et des éléments de boîte à outils. Vous pouvez définir plusieurs composants dans une seule extension. Distribuez également ces extensions à d'autres utilisateurs finaux Visual Studio sous la forme d'un Extension d'intégration Visual Studio (VSIX) Créez un VSIX en utilisant un projet VSIX dans Visual Studio.

Configuration requise

Création d'une solution d'extension de modélisation

Pour définir une extension de modélisation, vous devez créer une solution qui contient les projets suivants :

  • un projet d'extension d'intégration Visual Studio (VSIX). Cela génère un fichier qui joue le rôle de programme d'installation pour les composants de votre extension.

  • un projet de bibliothèque de classes, obligatoire pour les composants qui incluent le code de programme.

Pour créer une extension à plusieurs composants, vous pouvez les développer dans une solution unique. Vous n'avez besoin que d'un seul projet VSIX.

Les composants qui ne requièrent pas de code, tels que les éléments de boîte à outils personnalisés et les profils UML personnalisés, peuvent être directement ajoutés au projet VSIX sans utiliser de projets Bibliothèque de classes séparés. Les composants qui nécessitent du code de programme se définissent plus facilement dans un projet Bibliothèque de classes séparé. Composants qui requièrent que le code inclue des gestionnaires de mouvements, les commandes de menu, et le code de validation.

Pour créer un projet Bibliothèque de classes pour les commandes de menu, les gestionnaires de mouvements, ou la validation

  1. Dans le menu Fichier, cliquez sur Nouveau, Projet.

  2. Sous Modèles installés, sélectionnez Visual C# ou Visual Basic, puis choisissez Bibliothèque de Classes.

Pour créer un projet VSIX

  1. Lorsque vous créez un composant avec du code, il est plus facile de commencer par créer le projet de bibliothèque de classes. Vous ajouterez votre code à ce projet.

  2. créer un projet VSIX ;

    1. Dans Explorateur de solutions, dans le menu contextuel de la solution, choisissez Ajouter, Nouveau projet.

    2. Sous Modèles installés, développez Visual C# ou Visual Basic, puis sélectionnez Extensibilité. Dans la colonne centrale, choisissez Projet VSIX.

  3. Définissez le projet VSIX comme projet de démarrage de la solution.

    • Dans l'Explorateur de solutions, dans le menu contextuel du projet VSIX testé, choisissez En faire un objet de démarrage.

  4. Ouvrez source.extension.vsixmanifest. Le fichier s'ouvre dans l'éditeur de manifeste.

  5. Sous l'onglet Métadonnées, définissez le nom et les champs descriptifs du projet VSIX.

  6. Sous l'onglet Installer les cibles, choisissez Nouveau et définissez les éditions Ultimate et Premium de Visual Studio.

  7. Sous l'onglet Composants, ajoutez vos composants à l'extension de Visual Studio.

    1. Sélectionnez Nouveau.

    2. Pour un composant avec du code, définissez ces champs dans la boîte de dialogue Ajouter un nouveau composant :

      Type =

      Microsoft.VisualStudio.MefComponent

      Source =

      Un projet dans la solution actuelle

      Projet =

      Your class library project

      Instrumenter dans ce dossier =

      (empty)

      Pour d'autres types de composants, consultez les liens dans la section suivante.

Développement du composant

Pour chaque composant, tel qu'une commande de menu ou un gestionnaire de mouvements, vous devez définir un gestionnaire séparé. Mettez plusieurs gestionnaires dans le même projet Bibliothèque de classes. Le tableau suivant répertorie les différents genres de gestionnaires.

Type d'extension

Rubrique

Manière dont chaque composant est déclaré en général

Commande de menu

Comment : définir une commande de menu sur un diagramme de modélisation

[ClassDesignerExtension]

// or other diagram types

[Export(typeof(ICommandExtension))]

public class MyCommand : ICommandExtension

{...

Glisser-déplacer ou double-clic

Comment : définir un gestionnaire de mouvements sur un diagramme de modélisation

[ClassDesignerExtension]

// or other diagram types

[Export(typeof(IGestureExtension))]

public class MyGesture : IGestureExtension

{...

Contrainte de validation

Comment : définir des contraintes de validation pour les modèles UML

[Export(typeof( System.Action<ValidationContext, object>))]

[ValidationMethod(ValidationCategories.Save

| ValidationCategories.Menu)]

public void ValidateSomething

(ValidationContext context, IClassifier elementToValidate)

{...}

Gestionnaire d'événements des liens d'éléments de travail

Comment : définir un gestionnaire de liens d'éléments de travail

[Export(typeof(ILinkedWorkItemExtension))]

public class MyWorkItemEventHandler : ILinkedWorkItemExtension

{...

Profil UML

Comment : définir un profil pour étendre UML

(À définir)

Élément de boîte à outils

Comment : définir un élément de boîte à outils de modélisation personnalisé

(À définir)

Exécution d'une extension pendant son développement

Pour exécuter une extension pendant son développement

  1. Dans le menu Visual Studio Déboguer, choisissez Démarrer le débogage.

    Le projet est généré et une nouvelle instance de Visual Studio démarre en mode expérimental.

    • Choisissez également Exécuter sans débogage. Cela réduit le temps nécessaire au démarrage du programme.

  2. Créez ou ouvrez un projet de modélisation dans l'instance expérimentale de Visual Studio, et créez ou ouvrez un diagramme.

    Votre extension se chargera et s'exécutera.

  3. Si vous avez utilisé Exécuter sans débogage alors que vous souhaitez utiliser le débogueur, revenez à l'instance principale de Visual Studio. Dans le menu Déboguer, cliquez sur Attacher au processus. Dans la boîte de dialogue, sélectionnez l'instance expérimentale de Visual Studio, qui porte le nom de programme devenv.

Installation et désinstallation d'une extension

Suivez les étapes suivantes pour exécuter votre extension dans l'instance principale de Visual Studio sur votre propre ordinateur ou sur d'autres ordinateurs.

  1. Dans votre ordinateur, recherchez le fichier .vsix qui a été généré par votre projet d'extension.

    1. Dans l' Explorateur de solutions, dans le menu contextuel de votre projet, puis choisissez Ouvrez le dossier dans Windows Explorer.

    2. Localisez le fichier bin\*\YourProject.vsix

  2. Copiez le fichier .vsix sur l'ordinateur cible sur lequel vous souhaitez installer l'extension. Il peut s'agir de votre propre ordinateur ou d'un autre.

    • L'ordinateur cible doit avoir une des éditions de Visual Studio que vous avez spécifiées sur l'onglet Cibles d'installation de source.extension.vsixmanifest.

  3. Sur l'ordinateur cible, ouvrez le fichier .vsix, par exemple en double-cliquant dessus.

    Le Programme d'installation des extensions Visual Studio ouvre et installe l'extension.

  4. Démarrez ou redémarrez Visual Studio.

Pour désinstaller une extension

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

  2. Développez Extensions installées.

  3. Sélectionnez l'extension, puis cliquez sur Désinstaller.

Exceptionnellement, une extension défaillante ne parvient pas à se charger et crée un rapport dans la fenêtre d'erreur, mais ne s'affiche pas dans le gestionnaire d'extensions. Dans ce cas, supprimez l'extension en supprimant le fichier de l'emplacement suivant, où %LocalAppData% est généralement au format DriveName:\Users\UserName\AppData\Local:

%LocalAppData%\Microsoft\VisualStudio\12.0\Extensions

Voir aussi

Concepts

Comment : définir un profil pour étendre UML

Comment : définir un élément de boîte à outils de modélisation personnalisé

Comment : définir des contraintes de validation pour les modèles UML

Comment : définir une commande de menu sur un diagramme de modélisation