Como: Definir e instalar uma extensão de modelagem

  • Artigo

Em Visual Studio Ultimate, você pode definir as extensões de modelagem de diagramas. Dessa maneira, você pode adaptar os modelos e diagramas para suas próprias necessidades. Por exemplo, você pode definir os comandos de menu, perfis 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 Visual Studio Ultimate os usuários na forma de um extensão de integração de Visual Studio (VSIX). você pode criar um usando um projeto de VSIX de VSIX Visual Studio.

Você deve ter SDK do Visual Studio instalado.

Requisitos

Criação de uma solução de extensão de modelagem

Para definir uma extensão de modelagem, você deve criar uma solução contendo esses projetos:

  • A Visual Studio projeto de integração de extensão (VSIX). Isso gera um arquivo que atua como um instalador para os componentes de sua extensão. No Novo projeto caixa de diálogo, expanda Visual C# ou Visual Basic, em seguida, clique em extensibilidade. Na coluna do meio, clique em O projeto de VSIX.

  • Um classe projeto de biblioteca, necessário para os componentes incluem o código de programa.

Se você quiser tornar uma extensão que tem vários componentes, você pode desenvolvê-los em uma única solução. Você precisa de apenas um projeto VSIX e adicione os componentes como conteúdo, a definição de VSIX.

Componentes que não requerem código, como, por exemplo, itens de caixa de ferramentas personalizada e perfis personalizados de UML, podem ser adicionados diretamente ao projeto VSIX sem usar projetos separados. Componentes como, por exemplo, os comandos de menu que exigem o código de programa mais facilmente são definidos em um projeto separado.

Para configurar um projeto VSIX

  1. Se você estiver criando um componente com código, é mais fácil criar o projeto de biblioteca de classe primeiro. Você irá adicionar seu código para o projeto.

  2. Crie um projeto VSIX.

    1. Em Solution Explorer, a solução com o botão direito, aponte para Adde em seguida, clique em Novo projeto.

    2. Em Modelos instalados, expanda Visual C# ou Visual Basic, em seguida, clique em extensibilidade. Na coluna do meio, clique em O projeto de VSIX.

  3. Defina o projeto VSIX como o projeto de inicialização da solução.

    • No Solution Explorer, clique com o botão direito no projeto VSIX e clique em Set as StartUp project.

  4. Abra source.extension.vsixmanifest. O arquivo é aberto no editor de manifesto.

  5. Defina o nome e os campos descritivos do VSIX.

  6. Clique em Selecione edições e selecione o Visual Studio edições você deseja que sua extensão a ser executada.

  7. Adicionar os componentes para o conteúdo lista.

    1. Clique em Adicionar conteúdo.

    2. Para um componente com o código:

      Em Selecione um tipo de conteúdo, selecione MEF componente.

      Em Selecionar uma fonte de, clique em projeto e selecione o nome do seu projeto de biblioteca de classe.

      Para outros tipos de componente, consulte os links na próxima seção.

O componente de desenvolvimento

Para cada componente como, por exemplo, um manipulador de gesto ou comando de menu, você deve definir um manipulador separado. A tabela a seguir resume os diferentes tipos de manipulador.

Tipo de extensão

Tópico

Como a cada componente geralmente é declarado

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

{...

Arrastar e soltar ou clique duas vezes

Como: Definir uma queda e clique duas vezes o manipulador de 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: Define um manipulador de Link do Item de trabalho

[Export(typeof(ILinkedWorkItemExtension))]

public class MyWorkItemEventHandler : ILinkedWorkItemExtension

{...

Perfil UML

Como: Definir um perfil de estender o UML

Não é definido com o código de programa. Em vez disso, defina o tipo de componente no source.extension.vsixmanifest como segue:

Tipo de componente = extensão de personalizado

Type = Microsoft.VisualStudio.UmlProfile

Item da caixa de ferramentas

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

Não é definido com o código de programa. Em vez disso, defina o tipo de componente no source.extension.vsixmanifest como segue:

Tipo de componente = extensão de personalizado

Type = Microsoft.VisualStudio.ArchitectureTools.CustomToolboxItems

Executando uma extensão durante seu desenvolvimento.

Para executar uma extensão durante seu desenvolvimento.

  1. No Visual Studio Debug menu, clique em Start Debugging.

    As versões do projeto e uma nova instância do Visual Studio inicia no modo Experimental.

    • Como alternativa, você pode clicar Start Without Debugging. Isso reduz o tempo gasto para iniciar o programa.

  2. Crie ou abra um projeto de modelagem na instância experimental do Visual Studioe crie ou abra um diagrama.

    Sua extensão irá carregar e executar.

  3. Se você usou o Start Without Debugging , mas você deseja usar o depurador, voltar para a instância principal do Visual Studio. Sobre o Debug menu, clique em Attach to Process. Na caixa de diálogo, selecione a instância experimental do Visual Studio, que tem o nome do programa devenv.

Para executar a extensão na instância principal do Visual Studio, siga as etapas no de instalação e desinstalação de uma extensão.

Instalar e desinstalar uma extensão.

Você pode instalar um Visual Studio extensão em seu próprio computador e em outros computadores.

Para instalar uma extensão.

  1. No seu computador, localize o .vsix arquivo que foi criado pelo seu projeto de extensão.

    1. Em Solution Explorer, seu projeto com o botão direito e, em seguida, clique em Abrir a pasta no Windows Explorer.

    2. Localize o arquivo bin\*\YourProject.vsix

  2. Cópia de .vsix o arquivo para o computador de destino no qual 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 source.extension.vsixmanifest.

  3. No computador de destino, clique duas vezes o .vsix arquivo.

    Instalador de extensão de Visual Studio abre e instala a extensão.

  4. Iniciar ou reiniciar Visual Studio.

Para desinstalar uma extensão.

  1. Sobre o Ferramentas menu, clique em Extension Manager.

  2. Expanda as extensões instaladas.

  3. Selecione a extensão e clique em desinstalar.

Raramente, uma extensão com defeito não consegue carregar e cria um relatório na janela de erros, mas não aparece no Gerenciador de extensão. Nesse caso, você pode remover a extensão, excluindo o arquivo do seguinte local onde % LocalAppData % é normalmente Nome_da_unidade: \Users\nome de usuário\AppData\Local:

% LocalAppData %\Microsoft\VisualStudio\10.0\Extensions

Consulte também

Conceitos

Como: Definir um perfil de estender o UML

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

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

Outros recursos

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