在Android Studio(Mac端)中添加Dart的方法注释模板。整体步骤是和设置JAVA一样的,主要是模板几个参数不太一样。
1、设置路径 Preferences — Editor — Live Templates
2、新建一个 Live Templates
由于获取 参数、返回值、方法名等方法是用Dart独有的,不适用于别的语言,所以建议直接建在Dart 分组下,这个也是Flutter方法注释模板和别的主要区别
3、配置 Live Templates
Abbreviation: 模板缩写 我用的是一个 * ,这个看个人习惯
Description: 模板的说明
Expand with: 展开模板的确认键 (默认是tab 我用的是Enter回车,看个人习惯)
Template Text: 模板格式如下:(title:方法名 description:方法说明 param:方法参数,由于是动态的所以没有写 @param,可能存在无参数的方法 return:同参数一样的原理 updateTime:注释添加的时间 author:作者名) 自己根据需要增删
///@title $title$
///@description TODO $param$ $return$
///@updateTime $date$ $time$
///@author TongYu
这时候在下面会出现 ⚠️No applicable contexts. Define 点击选择 Dart 语言
变成了 Applicable in Dart xxxxxxxx. Change 即可
还有重要的一步,点击按钮 Edit variables : 配置 模板里面的各个参数的值 。 ( 如$param$ 在Template Text模板里面两个$ 之间的字段,都会在这里面显示)
title: 方法名 选择 dartMethodName() (其他语言类似,比如java配置的时候选的是 methodName())
date:日期 date()
time:时间 time()
param: 参数 这个可以选择 dartMethodParameters() 这个方法返回的是一个数组。( 如果直接使用这个方法的话 模板格式需要变动, $param$ 需要换行 加个 @param ) 我是用的是一个脚本,动态拼接了一下,脚本如下,复制直接填入就行:
groovyScript("def result=''; def stop=false; def params=\"${_1}\".replaceAll('[\\\\[|\\\\]|\\\\s]', '').split(',').toList(); if (params.size()==1 && (params[0]==null || params[0]=='null' || params[0]=='')) { stop=true; }; if(!stop) { for(i=0; i < params.size(); i++) {result +=((i==0) ? '\\r\\n' : '') + ((i < params.size() - 1) ? '///@param: ' + params[i] + '\\r\\n' : '///@param: ' + params[i] + '')}; }; return result;", dartMethodParameters())
return: 返回值格式 这个可以选择 dartReturnType() 返回的是一个数据格式 原理同param,脚本如下:
groovyScript("def result=''; def data=\"${_1}\"; def stop=false; if(data==null || data=='null' || data=='' || data=='void' ) { stop=true; }; if(!stop) { result += '\\r\\n' + '///@return: ' + data; }; return result;", dartReturnType())
4、使用
使用是 结合刚才配置的 在方法内使用 Abbreviation (* 号) + Expand with (Enter) 即可自动生成注释模板
5、注意
让强迫症难受的是 这个只能在方法内生成,再Copy出去,如果直接在外面生成 无法获取到方法名称、参数、返回值。
另外 为什么不用 /**/ 这种注释符号,是因为 dart会有提示 ,文本的注释 更提倡 /// 这个看自己眼缘,看不顺眼的话可以改成/**/ 需要改动的地方有 Template Text: param:的脚本里面的拼接 return:的拼接 如下:
Template Text:
/*
* @title $title$
* @description TODO $param$ $return$
* @updateTime $date$ $time$
* @author TongYu
*/
param:
groovyScript("def result=''; def stop=false; def params=\"${_1}\".replaceAll('[\\\\[|\\\\]|\\\\s]','').split(',').toList(); if (params.size()==1 &&(params[0]==null || params[0]=='null' || params[0]=='')) { stop=true; };if(!stop) { for(i=0; i < params.size(); i++) {result +=((i==0) ?'\\r\\n' : '') + ((i < params.size() - 1) ? ' * @param: ' + params[i]+ '\\r\\n' : ' * @param: ' + params[i] + '')}; }; return result;",dartMethodParameters())
return:
groovyScript("def result=''; def data=\"${_1}\"; def stop=false; if(data==null || data=='null' || data=='' || data=='void' ) { stop=true;}; if(!stop) { result += '\\r\\n' + ' * @return: ' + data; }; returnresult;", dartReturnType())