Partager via

Personnalisation des liaisons

  • Article

Vous pouvez personnaliser une liaison Xamarin.Android en modifiant les métadonnées qui contrôlent le processus de liaison. Ces modifications manuelles sont souvent nécessaires pour résoudre les erreurs de build et pour mettre en forme l’API résultante afin qu’elle soit plus cohérente avec C#/.NET. Ces guides expliquent la structure de ces métadonnées, comment modifier les métadonnées et comment utiliser JavaDoc pour récupérer les noms des paramètres de méthode.

Vue d’ensemble

Xamarin.Android automatise une grande partie du processus de liaison ; Toutefois, dans certains cas, une modification manuelle est nécessaire pour résoudre les problèmes suivants :

  • Résolution des erreurs de build causées par des types manquants, des types obscurcis, des noms en double, des problèmes de visibilité de classe et d’autres situations qui ne peuvent pas être résolues par les outils Xamarin.Android.

  • Modification du mappage utilisé par Xamarin.Android pour lier l’API Android à différents types en C# (par exemple, de nombreux développeurs préfèrent mapper des constantes Java int à des constantes C# enum ).

  • Suppression des types inutilisés qui n’ont pas besoin d’être liés.

  • Ajout de types qui n’ont aucun équivalent dans l’API Java sous-jacente.

Vous pouvez apporter tout ou partie de ces modifications en modifiant les métadonnées qui contrôlent le processus de liaison.

Guides

Les guides suivants décrivent les métadonnées qui contrôlent le processus de liaison et expliquent comment modifier ces métadonnées pour résoudre ces problèmes :

  • Les métadonnées de liaisons Java fournissent une vue d’ensemble des métadonnées qui entrent dans une liaison Java. Il décrit les différentes étapes manuelles qui sont parfois nécessaires pour terminer une bibliothèque de liaisons Java, et explique comment mettre en forme une API exposée par une liaison pour suivre de plus près les instructions de conception .NET.

  • Naming Parameters with Javadoc explique comment récupérer des noms de paramètres dans un projet de liaison Java à l’aide de Javadoc produit à partir du projet Java lié.