项目大了,想要让项目自动化管理工具。查阅资料了解到detekt这个可以实现。该库是基于ktLint实现的。
配置gradle
buildscript {
repositories {
google()
mavenCentral()
gradlePluginPortal()
}
dependencies {
classpath "com.android.tools.build:gradle:<agp_version>"
}
}
plugins {
id "com.android.application"
id "org.jetbrains.kotlin.android" version "<kotlin_version>"
id "io.gitlab.arturbosch.detekt" version "1.23.0-RC1"
}
repositories {
mavenCentral()
}
添加commit hook
在git流中添加代码检测钩子
那么如何在git flow中[添加hook]?(https://www.atlassian.com/git/tutorials/git-hooks)
- 打开项目所在的Git仓库,并进入项目根目录。
- 进入.git/hooks目录,这个目录中包含了一些默认的Git Hook模板。
- 选择你需要添加的Hook类型,例如pre-commit。
- 将你的Hook脚本文件放置在该目录中,命名为pre-commit(或其他Hook类型的名称)。下面的代码就是pre-commit代码。
#!/usr/bin/env bash
echo "Running detekt check..."
OUTPUT="/tmp/detekt-$(date +%s)"
./gradlew detekt > $OUTPUT
EXIT_CODE=$?
if [ $EXIT_CODE -ne 0 ]; then
cat $OUTPUT
rm $OUTPUT
echo "***********************************************"
echo " Detekt failed "
echo " Please fix the above issues before committing "
echo "***********************************************"
exit $EXIT_CODE
fi
rm $OUTPUT
- 添加可执行权限,使用命令chmod +x pre-commit。
- 编辑Hook脚本文件,根据需要添加代码,例如运行自动化测试或代码规范检查。
- 提交你的Hook脚本文件到Git仓库中,可以口头约定手动去操作,但这看起来好傻,我们是程序员,当然懒是第一生产力。
写一段task执行自动注入pre-commit。
tips:下面的detekt-pre-commit.sample其实就是上面我贴的pre-commit代码。
task detektInit(){
if(!file("${project.rootDir}/.git/hooks/pre-commit").exists()){
print("commit hooks not exists,create it")
copy {
from "${project.rootDir}/config/detekt/detekt-pre-commit.sample"
into "${project.rootDir}/.git/hooks/"
rename { String fileName->
return "pre-commit"
}
}
}
}
默认的应该是基于ktLint,可以根据自己需要添加对应的规则。
忽略警告排除
baseline
- 也可以直接用官方的rule
下面我列了2个官方规则,
其中下面这个是twitter的compose代码检测规则
detektPlugins "io.gitlab.arturbosch.detekt:detekt-formatting:1.22.0"
detektPlugins "com.twitter.compose.rules:detekt:0.0.26"
另外我们可以通过ktLint官网查看检测规则,输出相应的规则文档。
遇到的哪些坑?
1、根据官方文档添加自定义规则忽略文件
detekt {
config = files("${project.rootDir}/config/detekt/detekt-config.yml")
}
平平无奇的代码始终编译报错,路径完全没错。
最后发现是因为文件名中带了中划线 - 导致的,将名字改成detektConfig.yml搞定。
2、如果项目在build文件产生变动的情况下commit的话,会报java文件编译错误。
image.png
对项目进行一次build,就不会出错了,搞定。
3、文件存在依旧报错
image.png查看文件对应的属性存在,这里报错又是莫名其妙。
然后查看官方依赖插件版本稳定性
image.png
因为我的版本是Java1.8,kt 1.8. gradle 7.3.3,agp7.2.2
所以对detekt版本进行降级从1.22.0降级到1.19.0尝试问题依然存在。
但是check速度下降了。把版本重新升到1.22.0。
在github上搜关键字autoCorrect
发现是格式输出有问题,修改规则:
formatting:
active: true
NoTrailingSpaces:
active: false
autoCorrect: false
Indentation:
active: false
autoCorrect: false
NoBlankLineBeforeRbrace:
active: false
autoCorrect: false
重新提交
image.png
最终提交通过。
搞定。
4、git commit的时候hooks没有生效?
查看.git\hooks\pre-commit 文件是否为可执行文件。如果不是可执行文件,可能因为编码问题变成了txt文本文件,那么hooks也不会自动执行。
网友评论