Condividi tramite


Personalizzazione delle associazioni

È possibile personalizzare un'associazione Xamarin.Android modificando i metadati che controllano il processo di associazione. Queste modifiche manuali sono spesso necessarie per risolvere gli errori di compilazione e per modellare l'API risultante in modo che sia più coerente con C#/.NET. Queste guide illustrano la struttura di questi metadati, come modificare i metadati e come usare JavaDoc per recuperare i nomi dei parametri del metodo.

Panoramica

Xamarin.Android automatizza gran parte del processo di associazione; Tuttavia, in alcuni casi è necessaria la modifica manuale per risolvere i problemi seguenti:

  • Risoluzione degli errori di compilazione causati da tipi mancanti, tipi offuscati, nomi duplicati, problemi di visibilità della classe e altre situazioni che non possono essere risolte dagli strumenti di Xamarin.Android.

  • Modifica del mapping usato da Xamarin.Android per associare l'API Android a tipi diversi in C#, ad esempio molti sviluppatori preferiscono eseguire il mapping delle costanti Java int alle costanti C# enum .

  • Rimozione di tipi inutilizzati che non devono essere associati.

  • Aggiunta di tipi senza controparte nell'API Java sottostante.

È possibile apportare alcune o tutte queste modifiche modificando i metadati che controllano il processo di associazione.

Guides

Le guide seguenti descrivono i metadati che controllano il processo di associazione e spiegano come modificare questi metadati per risolvere questi problemi:

  • I metadati delle associazioni Java offrono una panoramica dei metadati inseriti in un'associazione Java. Descrive i vari passaggi manuali che a volte sono necessari per completare una libreria di binding Java e spiega come modellare un'API esposta da un'associazione per seguire più attentamente le linee guida di progettazione .NET.

  • I parametri di denominazione con Javadoc spiegano come recuperare i nomi dei parametri in un progetto di associazione Java usando Javadoc prodotto dal progetto Java associato.