Associar bibliotecas do Android Kotlin
Importante
No momento, estamos investigando o uso de associação personalizada na plataforma Xamarin. Faça esta pesquisa para informar os esforços de desenvolvimento futuros.
A plataforma Android, juntamente com suas linguagens e ferramentas nativas, está em constante evolução e há muitas bibliotecas de terceiros que foram desenvolvidas usando as ofertas mais recentes. Maximizar a reutilização de código e componente é um dos principais objetivos do desenvolvimento multiplataforma. A capacidade de reutilizar componentes criados com Kotlin tornou-se cada vez mais importante para os desenvolvedores do Xamarin à medida que sua popularidade entre os desenvolvedores continua a crescer. Talvez você já esteja familiarizado com o processo de associação de bibliotecas Java regulares. A documentação adicional agora está disponível descrevendo o processo de Associação de uma Biblioteca Kotlin, para que elas sejam consumidas por um aplicativo Xamarin da mesma maneira. A finalidade deste documento é descrever uma abordagem de alto nível para criar uma Associação Kotlin para Xamarin.
Abordagem de alto nível
Com o Xamarin, você pode associar qualquer biblioteca nativa de terceiros para ser consumível por um aplicativo Xamarin. Kotlin é a nova linguagem e criar associação para bibliotecas criadas com essa linguagem requer algumas etapas e ferramentas adicionais. Essa abordagem envolve as quatro etapas a seguir:
- Criar a biblioteca nativa
- Preparar os metadados do Xamarin, que permitem que as ferramentas do Xamarin gerem classes C#
- Criar uma biblioteca de associação do Xamarin usando a biblioteca nativa e os metadados
- Consumir a Biblioteca de Associação do Xamarin em um aplicativo Xamarin
As seções a seguir descrevem essas etapas com detalhes adicionais.
Criar a biblioteca nativa
A primeira etapa é obter uma biblioteca Kotlin nativa (pacote AAR, que é um arquivo do Android). Você pode solicitá-lo diretamente de um fornecedor ou compilá-lo por conta própria.
Preparar os metadados do Xamarin
A segunda etapa é preparar o arquivo de transformação de metadados, que será usado pelas ferramentas do Xamarin para gerar as respectivas classes C#. Na melhor das hipóteses, esse arquivo pode estar vazio onde todas as classes são descobertas e geradas pelas ferramentas do Xamarin. Em alguns casos, a transformação de metadados deve ser aplicada para gerar o código C# correto e/ou desejado. Em muitos casos, um desmontador AAR, como o JD (Java Decompiler), deve ser usado para identificar dependências ocultas e classes indesejadas que você deseja excluir da lista final de classes C# a serem geradas. Os metadados finais devem representar a interface pública com a qual o aplicativo Xamarin.Android de referência interagirá.
Criar uma biblioteca de associação do Xamarin.Android
A terceira etapa é criar um projeto especial – uma Biblioteca de Associação do Xamarin.Android. Ele inclui as bibliotecas Kotlin como referências nativas e a transformação de metadados definida na etapa anterior. No momento da gravação, um projeto separado da Biblioteca de Associação do Android é necessário para cada pacote do AAR que está sendo referenciado. A Biblioteca de Associação deve adicionar o pacote Xamarin.Kotlin.StdLib para dar suporte à Biblioteca Padrão Kotlin.
Consumir a biblioteca de associação do Xamarin
A quarta e a etapa final é referenciar a biblioteca de associação em um aplicativo Xamarin.Android. Adicionar uma referência à Biblioteca de Associação do Xamarin.Android permite que seu aplicativo Xamarin use as classes Kotlin expostas de dentro desse pacote.
Passo a passo
A abordagem acima descreve as etapas de alto nível necessárias para criar uma Associação Kotlin para Xamarin. Há muitas etapas de nível inferior envolvidas e mais detalhes a serem considerados ao preparar essas associações na prática, incluindo a adaptação a alterações nas ferramentas e linguagens nativas. A intenção é ajudá-lo a obter uma compreensão mais profunda desse conceito e das etapas de alto nível envolvidas nesse processo. Para obter um guia passo a passo detalhado, consulte a documentação passo a passo da associação do Xamarin Kotlin .