使用 Javadoc 命名参数

重要

我们当前正在调查 Xamarin 平台上的自定义绑定使用情况。 请参与此调查，告诉我们将来应该进行哪些开发工作。

本文说明如何使用 Java 项目生成的 Javadoc 恢复 Java 绑定项目中的参数名称。

概述

绑定现有的 Java 库时，与绑定 API 相关的一些元数据会丢失。 方法的参数名称尤其会出现这种情况。 参数名称将显示为 p0、p1 等。这是因为 Java .class 文件不保留 Java 源代码中使用的参数名称。

如果 Xamarin.Android Java 绑定项目可以从原始库访问 Javadoc HTML，则可以提供参数名称。

将 Javadoc HTML 集成到 Java 绑定项目中

将 Javadoc HTML 集成到 Java 绑定项目是一个手动过程，包括以下步骤：

1. 下载库的 Javadoc
2. 编辑 .csproj 文件并添加 <JavaDocPaths> 属性：
3. 清理并重建项目

完成此操作后，原始 Java 参数名称应出现在由 Java 绑定项目绑定的 API 中。

注意

JavaDoc 输出的内容各异。 .JAR 绑定工具链不能全面支持每个可能的排列，因此某些参数命名可能不正确。

总结

本文介绍如何在 Java 绑定项目中使用 Javadoc 为绑定 API 提供有效参数名称。