Revise esta lista de boas práticas e limitações quando utilizar os recursos de transformação e
visualização C#
emIBM®
Rational Modeling Extension for
Microsoft® .NET.
Integração com o Microsoft Visual Studio
- Verifique se o sistema operacional correto, os pacotes de serviço e o
Microsoft Visual Studio 2005 ou 2008, Standard ou Professional
Edition, estão instalados no computador, antes de instalar ou executar o
Rational Modeling Extension for
Microsoft .NET.
- O
Rational Modeling Extension for
Microsoft .NET
só reconhece e se comunica com a primeira instância do Microsoft
Visual Studio 2005 ou 2008 que é aberta. Apenas execute uma instância do Visual Studio no computador em que o
Rational Modeling Extension for
Microsoft .NET
esteja sendo usado.
- No
Microsoft
Visual Studio, sempre ative a opção para carregar automaticamente alterações externas.
Você pode configurar essa opção
na página Documentos clicando em .
Certifique-se de que Detectar quando um arquivo é alterado fora do ambiente e
Carregar automaticamente as alterações, se salvas estejam selecionados.
- O
Rational Modeling Extension for
Microsoft .NET
utiliza um mecanismo COM para sincronizar com o
Microsoft Visual
Studio. As chamadas COM podem falhar ou podem ser rejeitadas quando o Visual Studio estiver ocupado.Não
trabalhe no
Microsoft Visual
Studio nem torne-o ativo ao executar as seguintes operações no Rational Modeling Extension for
Microsoft .NET:
- Importar soluções do .NET Framework
- Atualizar um projeto
- Expandir projetos ou arquivos importados na visualização Explorador de Projetos (por
exemplo, expandir a visualização em árvore)
- Inicializar o
Rational Modeling Extension for
Microsoft .NET
em um espaço de trabalho no qual uma solução do Visual Studio tenha sido importada anteriormente
- Compor um diagrama de visualização do .NET Framework
- Executar uma transformação UML-para-C# ou C#-para-UML
Importação de Solução e Gerenciamento do Projeto
- Quando uma solução é importada para o
Rational Modeling Extension for
Microsoft .NET,
ele cria projetos Eclipse no espaço de trabalho do Eclipse para cada projeto C# correspondente na solução. O
projeto criado no Eclipse terá o mesmo nome que o projeto C# na solução do
Microsoft Visual Studio.
A seguir, pontos importantes a serem observados sobre os projetos:
- Os projetos criados no Eclipse terão links para os arquivos C# e Montagens .NET utilizados pelos projetos
C# correspondentes na solução do Visual Studio. Esses links são a única maneira de o
Rational Modeling Extension for
Microsoft .NET
recuperar, atualizar e mostrar informações sobre os projetos do Visual Studio e seu conteúdo no Eclipse. Na realidade, eles agem como uma visualização para os projetos C#
no Eclipse.
- Com exceção do uso de transformações UML-para-C#, evite utilizar
mecanismos do Eclipse para modificar os projetos importados. O uso de mecanismos do Eclipse
para renomear esses projetos ou modificar seu conteúdo pode levar a resultados
imprevisíveis. Em particular, evitar criar ou incluir modelos UML (.emx) ou arquivos de
diagramas (.dnx) nos projetos. Em vez disso, crie projetos separados (como Projeto
UML) no Eclipse para esses propósitos. Deve-se ter cuidado para evitar a criação de arquivos de diagramas
(.dnx) dentro dos projetos importados porque, à medida que novos diagramas são criados, a estrutura de
visualização assume por padrão seus locais como sendo os projetos nos quais os elementos visualizados residem.
- Você pode fechar e reabrir com segurança os objetos importados. Também pode excluir
com segurança os projetos importados. Se você precisar excluir um projeto do Visual Studio
e todo o seu conteúdo, desempenhe essa ação no Microsoft Visual
Studio.
- Caso não esteja planejando explorar o conteúdo de tipos definidos nas montagens de estrutura .NET (por
exemplo, para descobrir quais operações ou campos estão contidos no tipo), selecione a caixa de opção
Ao analisar montagens .NET, obter apenas tipos quando importar a solução do Visual
Studio para o espaço de trabalho do Eclipse. Essa opção está disponível na primeira
página do assistente de Importação de Solução do .NET. Essa opção acelera a importação da solução e também
acelera a visualização de tipos C# e .NET.
- Após a importação de uma solução do Visual Studio para seu espaço de trabalho do Eclipse, evite renomear
os projetos C# no Microsoft Visual Studio. Se você precisar
renomear um projeto, siga o procedimento na ajuda on-line. Para obter detalhes, consulte Renomeando Projetos C# no Visual Studio.
- Nunca feche ou abra uma solução diferente (que não seja aquela importada para o seu espaço de trabalho do
Eclipse) no Microsoft Visual Studio quando o
Rational Modeling Extension for
Microsoft .NET
estiver em execução.
- Se você usar um formato codificado para a solução Microsoft Visual Studio que seja diferente da
codificação Eclipse padrão, você deve mudar a preferência de codificação para o formato apropriado para que a
transformação capture o texto corretamente a partir do arquivo de origem: Clique em
.
Transformação e Visualização C#
- Antes de executar ações no
Rational Modeling Extension for
Microsoft .NET,
certifique-se de que os projetos C# não contenham erros de sintaxe e sejam compilados com êxito no
Microsoft Visual Studio. O Rational Modeling Extension for
Microsoft .NET utiliza APIs de Modelo de Código do Visual Studio para analisar os arquivos C#.
Essas APIs retornarão resultados incorretos e valores NULL se houver erros nos arquivos C#. Por exemplo, se
você alterar um arquivo C# no Microsoft Visual Studio e, em
seguida, atualizar seu projeto no Eclipse e perceber que o arquivo não pode ser expandido na visualização
Explorador de Projetos, é provável que erros de sintaxe C# tenham sido introduzidos pela alteração.
Para evitar esse problema, vá para o
Microsoft
Visual Studio, corrija todos os erros de sintaxe, reconstrua a solução e atualize o
projeto importado no Eclipse para receber as alterações. As soluções Visual Studio devem estar em um estado
limpo e construído ao aplicar transformações.
- Você pode alterar a codificação de projetos C# por meio do Eclipse utilizando o comando Propriedades no
menu pop-up dos projetos importados. Essa codificação levará mais tempo que o usual porque os projetos do
Visual Studio são geralmente grandes.
- Se você utilizar a transformação C# em UML para gerar um modelo UML a partir de um projeto C# existente
no Microsoft Visual Studio e, em seguida, desejar regenerar todo
o novo código a partir do modelo, certifique-se de criar um novo projeto vazio no Visual Studio como o
destino de transformação ou escolha um projeto que ainda não tenha um método main(). Os
aplicativos que contêm dois métodos main() gerarão erros de compilação do Visual Studio.