android - kotlin kdoc 中的参考资源不可点击

Question

我想在我的 Javadoc 中提到一个从 java 转换为 Kotlin 的布局。在java中是：

/**
* ... inside the {@link R.layout#view_main}
*/

这是可点击的，但是当我使用 android studio 工具转换这个类时。改为：

/**
* ... inside the [R.layout.view_main]
*/

这是不可点击的。我怎样才能让它可点击？

Answer 1

我们需要将 R 类导入到我们正在为其编写文档的类中。否则，它将无法点击。它是这样解决的：

import my.app.R
/**
* text description [R.layout.activity_main]
*/

Answer 2

在文档注释中的 kotlin 源链接中将添加如下

/**
 * text description
 * @see R.layout.activity_main
 *
 */

或与同一行中的描述的链接将是这样的

/**
 * text description @see [R.layout.activity_main]
 */

--

/**
 * text description @see [android.util.AndroidException] and this @see [android.util.AttributeSet]
 */