Como: definir e instalar uma extensão de modelagem

Artigo
02/25/2013

Em o Visual Studio final, você pode definir extensões a modelagem diagramas.Assim, você pode adaptar diagramas e os 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 finais do Visual Studio 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

O Visual Studio SDK, que você pode obter Galeria do Visual Studio.
O SDK de visualização e modelagem do Visual Studio, que você pode obter O SDK de visualização e modelagem do Visual Studio na 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 gera 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ê desejar tornar 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.

Em o menu de Arquivo , escolha Novo, Projeto.
Em modelos instalados, Visual C# selecione ou Visual Basic, escolha Biblioteca de Classes.

Para criar um projeto de 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 de VSIX.
1. Em Gerenciador de Soluções, no menu de atalho da solução, escolha Adicionar, Novo Projeto.
2. Em modelos instalados, expanda Visual C# ou Visual Basic, então selecione Extensibilidade.Em a coluna do meio, escolha projeto de VSIX.
Defina o projeto de VSIX como o projeto de inicialização de solução.
- Em o solution Explorer, no menu de atalho do projeto de VSIX escolha Definir como projeto de inicialização.
Abrir source.extension.vsixmanifest.O arquivo é aberto no editor manifesto.
Em a guia de metadados , defina o nome e os campos descritivos de VSIX.
Em a guia de Destinos instalar , escolha Novo e define as edições finais e superior do Visual Studio.
Em a guia de recursos , 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 de adicionar o novo recurso :
  
  Tipo =
  
  Microsoft.VisualStudio.MefComponent
  
  Origem =
  
  Um projeto na solução atual
  
  Projeto =
  
  Seu projeto de biblioteca de classe
  
  Inserir em esta pasta =
  
  (vazio)
  
  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 dos 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 manipulador de Link do Item de trabalho	[Export(typeof(ILinkedWorkItemExtension))] public class MyWorkItemEventHandler : ILinkedWorkItemExtension {...
Perfil de UML	Como: definir um perfil para estender o UML	(Para ser definido)
Item da caixa de ferramentas	Como: definir um Item da caixa de ferramentas de modelagem de personalizado	(Para ser definido)

Executando uma extensão durante o desenvolvimento

Para executar uma extensão durante o desenvolvimento

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

As compilações de projeto, e uma nova instância 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 crie ou abra um diagrama.

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

Instalando e desinstalar 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.

Em o 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, e então escolha Abrir pasta no Windows Explorer.
2. Localize o arquivo bin\*\YourProject.vsix
Copie o arquivo de .vsix para o computador de destino que você deseja instalar a extensão.Isso pode ser o seu próprio computador ou 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.
Em o computador de destino, abra o arquivo de .vsix por exemplo, clicando duas vezes no.

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

Em o menu de Ferramentas , clique em gerenciador de extensão.
Expanda extensões instaladas.
Selecione a extensão, clique em Desinstalar.

Raramente, uma extensão defeituosas não carrega e cria um relatório na janela de erro, mas não aparece no gerenciador de extensão.Em esse caso, você pode remover a extensão deletando o arquivo do local onde a seguir %LocalAppData% é normalmente DriveName: UsuáriosNome do Usuário\ \ \ \ AppData local:

%LocalAppData%\Microsoft\VisualStudio\11.0\Extensions

Consulte também

Conceitos

Como: definir um perfil para estender o UML

Como: definir um Item da caixa de ferramentas de modelagem de personalizado

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

Como: definir um comando de Menu em um diagrama de modelagem

Compartilhar via