Udostępnij za pośrednictwem

Dostosowywanie powiązań

Powiązanie platformy Xamarin.Android można dostosować, edytując metadane kontrolujące proces powiązania. Te ręczne modyfikacje są często niezbędne do rozwiązywania błędów kompilacji i kształtowania wynikowego interfejsu API, aby był bardziej spójny z językiem C#/.NET. Te przewodniki wyjaśniają strukturę tych metadanych, sposób modyfikowania metadanych oraz sposób używania narzędzia JavaDoc do odzyskania nazw parametrów metody.

Omówienie

Platforma Xamarin.Android automatyzuje większość procesu powiązania; jednak w niektórych przypadkach wymagana jest ręczna modyfikacja w celu rozwiązania następujących problemów:

  • Rozwiązywanie błędów kompilacji spowodowanych brakującymi typami, zaciemnionymi typami, zduplikowanymi nazwami, problemami z widocznością klas i innymi sytuacjami, których nie można rozwiązać za pomocą narzędzi platformy Xamarin.Android.

  • Zmiana mapowania używanego przez platformę Xamarin.Android w celu powiązania interfejsu API systemu Android z różnymi typami w języku C# (na przykład wielu deweloperów woli mapować stałe języka Java int na stałe języka C# enum ).

  • Usuwanie nieużywanych typów, które nie muszą być powiązane.

  • Dodawanie typów, które nie mają odpowiednika w podstawowym interfejsie API języka Java.

Niektóre lub wszystkie te zmiany można wprowadzić, modyfikując metadane kontrolujące proces powiązania.

Przewodniki

W poniższych przewodnikach opisano metadane kontrolujące proces powiązania i wyjaśniono, jak zmodyfikować te metadane w celu rozwiązania tych problemów:

  • Metadane powiązań Języka Java zawierają omówienie metadanych, które przechodzą do powiązania języka Java. Opisuje on różne ręczne kroki, które czasami są wymagane do ukończenia biblioteki powiązań Języka Java, i wyjaśnia sposób kształtowania interfejsu API uwidocznionego przez powiązanie w celu dokładniejszego przestrzegania wytycznych dotyczących projektowania platformy .NET.

  • Parametry nazewnictwa za pomocą narzędzia Javadoc wyjaśnia, jak odzyskać nazwy parametrów w projekcie powiązania Języka Java przy użyciu narzędzia Javadoc utworzonego w powiązanym projekcie Java.