Comment : définir et installer une extension de modélisation
Dans Visual Studio final, vous pouvez définir des extensions à modéliser des diagrammes.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.Vous pouvez également distribuer ces extensions à d'autres utilisateurs finaux de Visual Studio sous la forme d'Une. Extension d'intégration Visual Studio (VSIX) Vous pouvez créer un VSIX à un projet VSIX dans Visual Studio.
Configuration requise
Kit de développement Visual Studio, à Galerie Visual Studiopartir duquel vous pouvez obtenir.
Kit de développement logiciel de visualisation et de modélisation de Visual Studio, à Kit de développement logiciel de visualisation et de modélisation de Visual Studio sur la galerie de codepartir duquel vous pouvez obtenir.
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 avez besoin d'un 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 personnalisés UML, peuvent être ajoutés directement au projet VSIX sans utiliser des projets de Bibliothèque de classes distinctes.Les composants qui requièrent le code de programme plus facilement définis dans un projet de Bibliothèque de classes distinct.Les composants qui requièrent le code incluent des gestionnaires de mouvements, les commandes de menu, et le code de validation.
Pour créer un projet de Bibliothèque de classes pour les commandes de menu, les gestionnaires de mouvements, ou la validation
Dans le menu Fichier , choisissez Nouveau, Projet.
Sous Modèles installés, Visual C# activez ou Visual Basic, choisissez Bibliothèque de classes.
Pour créer un projet VSIX
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.
créer un projet VSIX ;
Dans Explorateur de solutions, dans le menu contextuel de la solution, choisissez Ajouter, Nouveau projet.
Sous Modèles installés, développez Visual C# ou Visual Basic, puis sélectionnez Extensibilité.Dans la colonne centrale, choisissez projet VSIX.
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 choisissez Définir comme projet de démarrage.
Ouvrez source.extension.vsixmanifest.Le fichier s'ouvre dans l'éditeur de manifeste.
Sous l'onglet métadonnées , affectez le nom et les champs descriptifs du projet VSIX.
Sous l'onglet installez les cibles , choisissez Nouveau et affectez au final et les éditions premiums de Visual Studio.
Sous l'onglet Ressources , ajoutez vos composants à l'extension de Visual Studio.
Sélectionnez Nouveau.
Pour un composant avec du code, placez ces champs dans la boîte de dialogue ajoutez le nouveau ressource :
Type =
Microsoft.VisualStudio.MefComponent
Source =
Un projet dans la solution actuelle
Projet =
Votre projet de Bibliothèque de classes
Incorporez dans ce dossier =
(vide)
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é.Vous pouvez placer 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 |
(Être défini) |
|
Élément de boîte à outils |
Comment : définir un élément de boîte à outils de modélisation personnalisé |
(Être défini) |
Exécution d'une extension pendant son développement
Pour exécuter une extension pendant son développement
Dans le menu d' Visual StudioDé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.
- Vous pouvez choisir Exécuter sans débogage.Cela réduit le temps nécessaire au démarrage du programme.
Créez ou ouvrez un projet de modélisation dans l'instance expérimentale de Visual Studio, puis créez ou ouvrez un diagramme.
Votre extension se chargera et s'exécutera.
Si vous Exécuter sans débogage utilisé mais il souhaite 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 a le nom du programme devenv.
Installation et désinstallation d'une extension
Exécutez les étapes suivantes pour exécuter votre extension dans l'instance principale de Visual Studio sur votre propre ordinateur et sur d'autres ordinateurs.
Dans votre ordinateur, recherchez le fichier .vsix qui a été généré par votre projet d'extension.
Dans Explorateur de solutions, dans le menu contextuel du projet, puis choisissez Ouvrir le dossier dans l'Explorateur Windows.
Localisez le fichier bin\*\VotreProjet.vsix.
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 l'une des éditions de Visual Studio que vous avez spécifiés dans l'onglet cibles d'installation d' source.extension.vsixmanifest.
Sur l'ordinateur cible, ouvrez le fichier d' .vsix , par exemple en double-cliquant dessus.
Le Programme d'installation des extensions Visual Studio ouvre et installe l'extension.
Démarrez ou redémarrez Visual Studio.
Pour désinstaller une extension
Dans le menu Outils, cliquez sur Gestionnaire d'extensions.
Développez Extensions installées.
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, vous pouvez supprimer l'extension en supprimant le fichier de l'emplacement suivant, où %LocalAppData% est généralement au format NomLecteur:\Users\NomUtilisateur\AppData\Local:
%LocalAppData%\Microsoft\VisualStudio\11.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