AndroidStudio Kotlin注释生成问题

大尾巴狼
  • 244

当我使用AndroidStudio 3.0Kotlin代码的时候,在方法上面添加注释,为什么不会自动生成一些参数例如:

正常的Java方法注释:

    /**
     * 显示吐司
     *
     * @param text     文本
     * @param duration 显示时长
     */
    private static void showToast(CharSequence text, int duration) {
         ···
         ···
    }

Kotlin的注释,不会自动生成 @param 这些参数

    /**
     * 
     */
    fun showToast(text : CharSequence, duration : Int) {
         ···
         ···
    }

请问怎么办?

评论
阅读 4.8k
1 个回答

简单的使用方法没有
java doc是 setting -> editor -> general -> smart keys -> insert documentation comment stub 带来的 是android studio(intellij idea)自带的功能
kotlin是通过plugin支持的,原则上是第三方插件 所以需要这种功能的话只能是自己开发,或者找github有没有开源项目支持了


补充:
刚刚在官网 文档中看到这么一段 https://kotlinlang.org/docs/r...
可以用于解释为什么没有自动生成params 和 return

官网的说明是:

Generally, avoid using @param and @return tags. Instead, incorporate the description of parameters and return values directly into the documentation comment, and add links to parameters wherever they are mentioned. Use @param and @return only when a lengthy description is required which doesn't fit into the flow of the main
// Avoid doing this:

/**
 * Returns the absolute value of the given number.
 * @param number The number to return the absolute value for.
 * @return The absolute value.
 */
fun abs(number: Int) = ...

// Do this instead:

/**
 * Returns the absolute value of the given [number].
 */
fun abs(number: Int) = ...

大概意思是:应该将参数结合到文档的过程中结合上下文描述来说明参数的作用

类似于 这样 Returns the absolute value of the given [number].
使用中括号包裹参数名称的语法

撰写回答

登录后参与交流、获取后续更新提醒

宣传栏