用于 Android XML（字符串）资源的 JavaDoc

Question

有没有办法将评论/描述/文档添加到 android 资源参考？我知道的唯一方法是使用标准 XML 注释。这显然不理想。

类似特殊属性或特殊 javadoc 前置元素的东西

<resources>
    <string documentation="Some useful information what does this resource means..." name="KEY" translatable="false">value</string>
</resources>

 <resources>
    <documentation forName="KEY">Some useful information what does this resource means...</documentation>
    <string name="KEY" translatable="false">value</string>
</resources>

不理想但目前实用的方式：

<resources>
    <!-- Some useful information about what this resource means... -->
    <string name="KEY" translatable="false">value</string>
</resources>

Answer 1

以下格式允许文件头（使用 XML 文档 cmets）以及与每个资源条目一起出现的单个注释（文档属性）。我没有让编译器抱怨需要包含 documentation 的特定命名空间（xmlns:tools 除外）。

<?xml version="1.0" encoding="utf-8"?>
<!--=============================================================================================

My File description here

==============================================================================================-->

<resources xmlns:tools="http://schemas.android.com/tools">

    <string name="Application_Name" documentation="Name of the application. Used as Activity Name as the title, and appears in About box">FantasticApp</string>

</resources>