Condividi tramite

Denominazione dei parametri con Javadoc

  • Articolo

Importante

Attualmente si sta esaminando l'utilizzo dell'associazione personalizzata nella piattaforma Xamarin. Si prega di prendere questo sondaggio per informare i futuri sforzi di sviluppo.

Questo articolo illustra come recuperare i nomi dei parametri in un progetto di associazione Java usando Javadoc generato dal progetto Java.

Panoramica

Quando si associa una libreria Java esistente, alcuni metadati relativi all'API associata andranno persi. In particolare i nomi dei parametri ai metodi. I nomi dei parametri verranno visualizzati come p0, p1e così via. Ciò è dovuto al fatto che i file Java .class non mantengono i nomi dei parametri usati nel codice sorgente Java.

Un progetto di associazione Java Xamarin.Android può fornire i nomi dei parametri se ha accesso al codice HTML Javadoc dalla libreria originale.

Integrazione del codice HTML Javadoc in un progetto di associazione Java

L'integrazione del codice HTML Javadoc in un progetto di associazione Java è un processo manuale costituito dai passaggi seguenti:

  1. Scaricare Javadoc per la libreria
  2. Modificare il .csproj file e aggiungere una <JavaDocPaths> proprietà:
  3. Pulire e ricompilare il progetto

Al termine, i nomi dei parametri Java originali devono essere presenti nelle API associate da un progetto di associazione Java.

Nota

Nell'output JavaDoc è presente una grande varianza. Le. La toolchain di associazione JAR non supporta ogni singola possibile permutazione e di conseguenza alcuni parametri potrebbero non essere denominati correttamente.

Riepilogo

Questo articolo ha illustrato come usare Javadoc in un progetto di associazione Java per fornire nomi di parametri significativi per le API associate.