Como definir e instalar uma extensão de modelagem

Artigo
06/10/2015

No Visual Studio Ultimate, você pode definir extensões a modelagem diagramas. Assim, você pode adaptar os diagramas e modelos para seus próprios precisam. Por exemplo, você pode definir comandos de menu, perfis de UML, restrições de validação e itens da caixa de ferramentas. Você pode definir vários componentes em uma única extensão. Você também pode distribuir essas extensões para outros usuários do Visual Studio Ultimate na forma de A. Extensão de integração do Visual Studio (VSIX) Você pode criar um VSIX usando um projeto de VSIX no Visual Studio.

Requisitos

SDK do Visual Studio, que você pode obter na Galeria do Visual Studio.
Visualização do Visual Studio e SDK de modelagem, que você pode obter em SDK de visualização e modelagem do Visual Studio em Galeria de código.

Criando uma solução modelagem de extensão

Para definir uma extensão modelagem, você deve criar uma solução que contém esses projetos:

Um projeto de extensão de integração de Visual Studio (VSIX). Isso gerencia um arquivo que atua como um instalador para componentes de sua extensão.
Um projeto de biblioteca de classes, necessário para componentes que incluem o código de programa.

Se você deseja fazer uma extensão que tem vários componentes, você pode desenvolvê-los em uma única solução. Você precisa apenas um projeto de VSIX.

Componentes que não requerem código, como itens personalizados da caixa de ferramentas e perfis personalizados de UML, podem ser adicionados diretamente ao projeto de VSIX sem usar projetos separados de biblioteca de classes. Componentes que requerem código de programa são definidos mais facilmente em um projeto de biblioteca de classes separado. Componentes que requerem código incluem manipuladores do gesto, comandos de menu, e código de validação.

No menu Arquivo, escolha Novo Projeto.
Em Modelos Instalados, Visual C# selecione ou Visual Basic, clique em Biblioteca de Classes.

Para criar um projeto VSIX

Se você estiver criando um componente com o código, é mais fácil criar o primeiro projeto de biblioteca de classes. Você adicionará seu código para o projeto.
Crie um projeto VSIX.
1. Em Gerenciador de Soluções, no menu de atalho de solução, escolha Adicionar, Novo Projeto.
2. Em Modelos Instalados, expanda Visual C# ou Visual Basic e selecione Extensibilidade. Na coluna do meio, escolha Projeto VSIX.
Defina o projeto VSIX como o projeto de inicialização da solução.
- No Gerenciador de Soluções, no menu de atalho do projeto VSIX, selecione Definir como projeto de inicialização.
Abra source.extension.vsixmanifest. O arquivo é aberto no editor manifesto.
Na guia de Metadados , defina o nome e os campos descritivos de VSIX.
Na guia de Instalar destinos , escolha Novo e define as edições finais e superior do Visual Studio.
Na guia de Ativos , adicione seus componentes para a extensão do Visual Studio.
1. Escolha Novo.
2. Para um componente COM código, definir esses campos na caixa de diálogo Adicionar o novo recurso :
  
  Tipo =
  
  Microsoft.VisualStudio.MefComponent
  
  Origem =
  
  Um projeto na solução atual
  
  Projeto =
  
  Your class library project
  
  Inserir nesta pasta =
  
  (empty)
  
  Para outros tipos de componentes, consulte os links na próxima seção.

Desenvolvendo o componente

Para cada componente como um manipulador de comando de menu ou do gesto, você deve definir um manipulador separado. Você pode colocar vários manipuladores no mesmo projeto de biblioteca de classes. A tabela a seguir resume os diferentes tipos de manipulador.

Tipo de extensão	Tópico	Como cada componente é declarado normalmente
Comando de menu	Como definir um comando de menu em um diagrama de modelagem	[ClassDesignerExtension] // or other diagram types [Export(typeof(ICommandExtension))] public class MyCommand : ICommandExtension {...
O arrastar e soltar ou clicar duas vezes	Como definir um manipulador de gesto em um diagrama de modelagem	[ClassDesignerExtension] // or other diagram types [Export(typeof(IGestureExtension))] public class MyGesture : IGestureExtension {...
Restrição de validação	Como definir restrições de validação para modelos UML	[Export(typeof( System.Action<ValidationContext, object>))] [ValidationMethod(ValidationCategories.Save \| ValidationCategories.Menu)] public void ValidateSomething (ValidationContext context, IClassifier elementToValidate) {...}
Manipulador de eventos de link de item de trabalho	Como definir um identificador de link de item de trabalho	[Export(typeof(ILinkedWorkItemExtension))] public class MyWorkItemEventHandler : ILinkedWorkItemExtension {...
Perfil de UML	Como definir um perfil para estender UML	(Para ser definido)
Item da caixa de ferramentas	Como definir um item da caixa de ferramentas de modelagem personalizado	(Para ser definido)

Executando uma extensão durante o desenvolvimento

Para executar uma extensão durante o desenvolvimento

No menu de Visual StudioDepurar , escolha Iniciar Depuração.

As compilações de projeto, e uma nova instância de começa de Visual Studio no modo de avaliação.
- Como alternativa você pode escolher Iniciar sem Depurar. Isso reduz o tempo tirados para iniciar o programa.
Criar ou abrir um projeto modelando na instância de avaliação do Visual Studio, e criar ou abrir um diagrama.

Sua extensão carregará e será executado.
Se você usou Iniciar sem Depurar mas você deseja usar o depurador, volte para instância principal do Visual Studio. No menu de Depurar , clique Anexar a Processo. Na caixa de diálogo, selecione a instância de avaliação do Visual Studio, que tem o nome do programa devenv.

Instalando e desinstalando uma extensão

Execute as seguintes etapas para executar sua extensão na instância principal do Visual Studio no seu próprio computador ou em outros computadores.

No seu computador, localize o arquivo de .vsix que foi compilado pelo projeto de extensão.
1. Em Gerenciador de Soluções, no menu de atalho do seu projeto, escolha Abrir pasta no Windows Explorer.
2. Localize o arquivo bin\*\YourProject.vsix
Copie o arquivo de .vsix para o computador de destino em que você deseja instalar a extensão. Pode ser o seu próprio computador ou algum outro.
- O computador de destino deve ter uma das edições do Visual Studio que você especificou na guia de Destinos de instalação de source.extension.vsixmanifest.
No computador de destino, abra o arquivo .vsix, por exemplo, clicando duas vezes nele.

Instalador de Extensão do Visual Studio abre e instala a extensão.
Início ou reinicie o Visual Studio.

Para desinstalar uma extensão

No menu Ferramentas, clique em Gerenciador de Extensões.
Expanda Extensões Instaladas.
Selecione a extensão, clique em Desinstalar.

Raramente, uma extensão defeituosa falha ao ser carregada e cria um relatório na janela de erros, mas não aparece no Gerenciador de Extensões. Nesse caso, você pode remover a extensão excluindo o arquivo do local a seguir onde %LocalAppData% é normalmente DriveName:\Users\UserName\AppData\Local:

%LocalAppData%\Microsoft\VisualStudio\12.0\Extensions

Consulte também

Conceitos

Como definir um perfil para estender UML

Como definir um item da caixa de ferramentas de modelagem personalizado

Como definir restrições de validação para modelos UML

Como definir um comando de menu em um diagrama de modelagem

Partilhar via