Именование параметров с Javadoc

  • Статья

Внимание

В настоящее время рассматривается возможность использования настраиваемых привязок на платформе Xamarin. Примите участие в этом опросе, чтобы помочь определить дальнейшие направления разработки.

В этой статье объясняется восстановление имен параметров в проекте привязки Java с помощью Javadoc, созданного из проекта Java.

Обзор

При привязке существующей библиотеки Java некоторые метаданные привязанного API теряются. В частности имена параметров для методов. Имена параметров будут отображаться как p0, p1и т. д. Это связано с тем, что файлы Java .class не сохраняют имена параметров, которые использовались в исходном коде Java.

Проект привязки Java для Xamarin.Android может предоставлять имена параметров, если у него есть доступ к Javadoc HTML из исходной библиотеки.

Интеграция Javadoc HTML в проект привязки Java

Интеграция Javadoc HTML в проект привязки Java выполняется вручную, и состоит из следующих шагов.

  1. Скачивание Javadoc для библиотеки
  2. Измените файл .csproj и добавьте свойство <JavaDocPaths>:
  3. Удаление и перестройка проекта

После этого исходные имена параметров Java должны присутствовать в интерфейсах API, привязанных к проекту привязки Java.

Примечание.

В выходных данных JavaDoc есть большая разница. Цепочка инструментов привязки JAR не поддерживает все возможные перестановки и, следовательно, некоторые параметры могут быть названы неправильно.

Итоги

В этой статье описано, как использовать Javadoc в проекте привязки Java для указания имен параметров для привязанных интерфейсов API.