Android Gradle插件任务运行问题：自定义任务未执行求助

1. 让addKtlintCheckGitPreCommitHook任务显示在Android Studio Gradle面板 #

ktlint插件提供的addKtlintCheckGitPreCommitHook任务默认未分配任务组，所以不会在AS的Gradle面板中展示。你可以给该任务指定组和描述，让它显示出来：

plugins {
    id("org.jlleitschuh.gradle.ktlint") version "11.2.0"
}

// 配置任务显示属性
tasks.named("addKtlintCheckGitPreCommitHook") {
    group = "ktlint" // 归到ktlint组，会在面板的ktlint分类下显示
    description = "安装ktlint提交前检查的Git钩子"
}

配置后刷新Gradle，就能在AS右侧Gradle面板的Tasks -> ktlint分类下找到该任务。

2. 修复自定义任务不执行目标任务的问题 #

你之前的自定义任务只是引用了任务对象，没有建立依赖关系或触发执行逻辑。正确的做法是让自定义任务依赖目标任务：

task installGitHook {
    dependsOn tasks.named("addKtlintCheckGitPreCommitHook")
    group = "custom" // 自定义组，方便在面板中查找
    description = "安装ktlint提交前Git钩子"
}

执行installGitHook任务时，会自动触发依赖的addKtlintCheckGitPreCommitHook任务。

3. 实现任务仅运行一次的效果 #

通过检查Git钩子文件是否存在，可实现任务仅执行一次的逻辑：

task installGitHook {
    def preCommitHookFile = file(".git/hooks/pre-commit")
    // 仅当钩子文件不存在时，才执行任务
    onlyIf { !preCommitHookFile.exists() }
    
    dependsOn tasks.named("addKtlintCheckGitPreCommitHook")
    group = "custom"
    description = "安装ktlint提交前Git钩子（仅当钩子未安装时执行）"
}

每次执行installGitHook时，Gradle会先检查.git/hooks/pre-commit文件是否存在，若已存在则直接跳过任务，避免重复执行。

如果希望项目首次同步时自动安装钩子，可将该任务与build任务建立依赖：

tasks.named("build") {
    dependsOn installGitHook
}

这样首次执行构建时会自动安装钩子，后续构建因钩子已存在会跳过操作。

内容的提问来源于stack exchange，提问作者David