Condividi tramite


Associare librerie Android Kotlin

Importante

Attualmente si sta esaminando l'utilizzo dell'associazione personalizzata nella piattaforma Xamarin. Si prega di prendere questo sondaggio per informare i futuri sforzi di sviluppo.

La piattaforma Android, insieme ai linguaggi nativi e agli strumenti, è in continua evoluzione e ci sono molte librerie di terze parti sviluppate usando le offerte più recenti. Ottimizzare il riutilizzo di codice e componenti è uno degli obiettivi principali dello sviluppo multipiattaforma. La possibilità di riutilizzare i componenti creati con Kotlin è diventata sempre più importante per gli sviluppatori Xamarin, man mano che la loro popolarità tra gli sviluppatori continua a crescere. È possibile che si abbia già familiarità con il processo di associazione di librerie Java normali. È ora disponibile una documentazione aggiuntiva che descrive il processo di associazione di una libreria Kotlin, in modo che siano utilizzabili da un'applicazione Xamarin nello stesso modo. Lo scopo di questo documento è descrivere un approccio di alto livello per creare un'associazione Kotlin per Xamarin.

Approccio generale

Con Xamarin è possibile associare qualsiasi libreria nativa di terze parti per essere utilizzabile da un'applicazione Xamarin. Kotlin è il nuovo linguaggio e la creazione di binding per le librerie compilate con questo linguaggio richiede alcuni passaggi e strumenti aggiuntivi. Questo approccio prevede i quattro passaggi seguenti:

  1. Compilare la libreria nativa
  2. Preparare i metadati di Xamarin, che consente agli strumenti Xamarin di generare classi C#
  3. Creare una libreria di binding Xamarin usando la libreria nativa e i metadati
  4. Usare la libreria di binding Xamarin in un'applicazione Xamarin

Le sezioni seguenti illustrano questi passaggi con dettagli aggiuntivi.

Compilare la libreria nativa

Il primo passaggio consiste nell'ottenere una libreria Kotlin nativa (pacchetto AAR, ovvero un archivio Android). È possibile richiederlo direttamente da un fornitore o compilarlo manualmente.

Preparare i metadati di Xamarin

Il secondo passaggio consiste nel preparare il file di trasformazione dei metadati, che verrà usato dagli strumenti Xamarin per generare le rispettive classi C#. Nello scenario migliore, questo file può essere vuoto in cui tutte le classi vengono individuate e generate dagli strumenti Xamarin. In alcuni casi, la trasformazione dei metadati deve essere applicata per generare codice C# corretto e/o desiderato. In molti casi, un disassembler AAR, ad esempio Java Decompiler (JD), deve essere usato per identificare le dipendenze nascoste e le classi indesiderate da escludere dall'elenco finale delle classi C# da generare. I metadati finali devono rappresentare l'interfaccia pubblica con cui l'applicazione Xamarin.Android che fa riferimento interagirà.

Creare una libreria di binding Xamarin.Android

Il terzo passaggio consiste nel creare un progetto speciale, ovvero una libreria di binding Xamarin.Android. Include le librerie Kotlin come riferimenti nativi e la trasformazione dei metadati definita nel passaggio precedente. Al momento della scrittura, è necessario un progetto di libreria di binding Android separato per ogni pacchetto AAR a cui si fa riferimento. La libreria di binding deve aggiungere il pacchetto Xamarin.Kotlin.StdLib per supportare la libreria standard Kotlin.

Usare la libreria di binding di Xamarin

Il quarto e il passaggio finale consiste nel fare riferimento alla libreria di binding in un'applicazione Xamarin.Android. L'aggiunta di un riferimento alla libreria di binding Xamarin.Android consente all'applicazione Xamarin di usare le classi Kotlin esposte da tale pacchetto.

scenario

L'approccio precedente descrive i passaggi generali necessari per creare un'associazione Kotlin per Xamarin. Ci sono molti passaggi di livello inferiore coinvolti e altri dettagli da considerare quando si preparano queste associazioni in pratica, inclusa l'adattamento alle modifiche negli strumenti e nelle lingue native. Lo scopo è quello di aiutare a comprendere più approfonditamente questo concetto e i passaggi generali coinvolti in questo processo. Per una guida dettagliata, vedere la documentazione della procedura dettagliata sull'associazione di Xamarin Kotlin.