Personalização de associações

  • Artigo

Você pode personalizar uma associação Xamarin.Android editando os metadados que controlam o processo de associação. Essas modificações manuais geralmente são necessárias para resolver erros de build e para moldar a API resultante para que ela seja mais consistente com o C#/.NET. Esses guias explicam a estrutura desses metadados, como modificar os metadados e como usar o JavaDoc para recuperar os nomes dos parâmetros do método.

Visão geral

O Xamarin.Android automatiza grande parte do processo de associação; no entanto, em alguns casos, a modificação manual é necessária para resolver os seguintes problemas:

  • Resolução de erros de build causados por tipos ausentes, tipos ofuscados, nomes duplicados, problemas de visibilidade de classe e outras situações que não podem ser resolvidas pelas ferramentas do Xamarin.Android.

  • Alterando o mapeamento que o Xamarin.Android usa para associar a API do Android a diferentes tipos em C# (por exemplo, muitos desenvolvedores preferem mapear constantes Java int para constantes C enum #).

  • Removendo tipos não utilizados que não precisam ser associados.

  • Adicionar tipos que não têm nenhuma contraparte na API Java subjacente.

Você pode fazer algumas ou todas essas alterações modificando os metadados que controlam o processo de associação.

Guides

Os guias a seguir descrevem os metadados que controlam o processo de associação e explicam como modificar esses metadados para resolver esses problemas:

  • Os metadados de associações Java fornecem uma visão geral dos metadados que entram em uma associação Java. Ele descreve as várias etapas manuais que às vezes são necessárias para concluir uma biblioteca de associação Java e explica como formatar uma API exposta por uma associação para seguir mais de perto as diretrizes de design do .NET.

  • Nomenclatura Parâmetros com Javadoc explica como recuperar nomes de parâmetro em um Projeto de Associação Java usando Javadoc produzido do projeto Java associado.