Nazewnictwo parametrów za pomocą narzędzia Javadoc

Ważne

Obecnie badamy użycie powiązań niestandardowych na platformie Xamarin. Weź udział w tej ankiecie , aby poinformować o przyszłych wysiłkach programistycznych.

W tym artykule wyjaśniono, jak odzyskać nazwy parametrów w projekcie powiązania Języka Java przy użyciu narzędzia Javadoc wygenerowanego w projekcie Java.

Omówienie

Po powiązaniu istniejącej biblioteki Java niektóre metadane dotyczące powiązanego interfejsu API zostaną utracone. W szczególności nazwy parametrów metod. Nazwy parametrów będą wyświetlane jako p0, p1itp. Dzieje się tak, ponieważ pliki Java .class nie zachowują nazw parametrów używanych w kodzie źródłowym Języka Java.

Projekt powiązania języka Java platformy Xamarin.Android może podać nazwy parametrów, jeśli ma dostęp do kodu HTML javadoc z oryginalnej biblioteki.

Integrowanie kodu JAVAdoc HTML z projektem powiązania języka Java

Integrowanie kodu JAVAdoc HTML z projektem Powiązania języka Java to proces ręczny składający się z następujących kroków:

1. Pobieranie dokumentu Javadoc dla biblioteki
2. .csproj Edytuj plik i dodaj <JavaDocPaths> właściwość:
3. Czyszczenie i ponowne kompilowanie projektu

Po wykonaniu tej czynności oryginalne nazwy parametrów Języka Java powinny znajdować się w interfejsach API powiązanych z projektem powiązania Języka Java.

Uwaga

Istnieje wiele wariancji w danych wyjściowych JavaDoc. Tthe. Łańcuch narzędzi powiązania JAR nie obsługuje każdej możliwej permutacji, a w związku z tym niektóre parametry mogą nie być poprawnie nazwane.

Podsumowanie

W tym artykule opisano, jak używać narzędzia Javadoc w projekcie powiązań Języka Java w celu zapewnienia nazw parametrów dla powiązanych interfejsów API.