使用Javadoc命名參數

重要

我們目前正在調查 Xamarin 平臺上的自定義系結使用方式。 請接受 這項調查 ，以通知未來的開發工作。

本文說明如何使用從 Java 項目產生的 Javadoc 來復原 Java 系結專案中的參數名稱。

概觀

系結現有的 Java 連結庫時，系結 API 的相關一些元數據會遺失。 特別是方法的參數名稱。 參數名稱會顯示為 p0、 p1等。這是因為 Java .class 檔案不會保留 Java 原始程式碼中使用的參數名稱。

如果 Xamarin.Android Java 系結專案可從原始鏈接庫存取 Javadoc HTML，則可以提供參數名稱。

將 Javadoc HTML 整合到 Java 系結專案中

將 Javadoc HTML 整合到 Java Binding 專案中是手動程式，其中包含下列步驟：

1. 下載連結庫的Javadoc
2. .csproj編輯檔案並新增<JavaDocPaths>屬性：
3. 清除並重建專案

完成此操作之後，原始 Java 參數名稱應該會出現在 Java 系結專案所系結的 API 中。

注意

JavaDoc 輸出中有大量的變數。 。JAR 系結工具鏈不支援每個可能的排列，因此某些參數可能無法正確命名。

摘要

本文涵蓋如何在 Java 系結專案中使用 Javadoc 來提供系結 API 的意義參數名稱。