Pojmenování parametrů pomocí Javadocu

Důležité

V současné době prošetřujeme využití vlastních vazeb na platformě Xamarin. Pokud chcete informovat budoucí úsilí o rozvoj, využijte tento průzkum .

Tento článek vysvětluje, jak obnovit názvy parametrů v projektu vazby Java pomocí Javadoc vygenerovaného z projektu Java.

Přehled

Při vytváření vazby existující knihovny Java dojde ke ztrátě některých metadat o vázaném rozhraní API. Zejména názvy parametrů pro metody. Názvy parametrů se zobrazí jako p0, p1atd. Důvodem je to, že soubory Java .class nezachovají názvy parametrů, které byly použity ve zdrojovém kódu Java.

Projekt vazby Xamarin.Android Java může poskytnout názvy parametrů, pokud má přístup k javadoc HTML z původní knihovny.

Integrace javadoc HTML do projektu vazby Java

Integrace kódu JAVAdoc HTML do projektu vazby Java je ruční proces skládající se z následujících kroků:

1. Stažení Javadocu pro knihovnu
2. .csproj Upravte soubor a přidejte <JavaDocPaths> vlastnost:
3. Vyčištění a opětovné sestavení projektu

Po dokončení by původní názvy parametrů Javy měly být přítomné v rozhraních API svázaných projektem vazby Java.

Poznámka:

Výstup JavaDoc má velkou odchylku. Tá. Sada nástrojů pro vazby JAR nepodporuje každou možnou permutaci a v důsledku toho nemusí být správně pojmenovaný některý parametr.

Shrnutí

Tento článek popisuje, jak pomocí Javadoc v projektu vazby Java poskytnout význam názvů parametrů pro svázaná rozhraní API.