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

Question

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

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

这是可点击的，但是当我使用 android 工作室工具转换此 class 时。改为：

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

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

Answer 1

在kotlin source link文档注释中会这样加上

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

或link与同一行的描述会这样

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

--

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

Answer 2

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

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