Android AAR中Gradle任务无法被Maven引入应用调用的问题

问题原因 #

AAR是Android库的编译产物，仅包含库的字节码、资源、清单文件等运行时必需内容，不会包含库项目中的Gradle构建脚本和自定义任务定义。当应用通过Maven引入AAR后，应用的Gradle环境无法感知到库中定义的customDownload任务，因此执行命令时会提示任务不存在。
另外，Maven分发的是库的构建结果，而非库的源码或构建逻辑，所以自定义任务无法随AAR传递到应用项目中。

解决方案 #

下面提供几种可行的实现方式，按推荐程度排序：

方案一：封装为Gradle插件（推荐） #

将下载逻辑封装成独立的Gradle插件，发布到Maven仓库，让应用项目通过引入插件来获得任务定义：

1. 编写Gradle插件
   创建插件类并包含任务逻辑：

   class CustomDownloadPlugin implements Plugin<Project> {
       void apply(Project project) {
           // 在应用项目中注册自定义任务
           project.tasks.register('customDownload', CustomDownloadTask)
       }
   }
   
   class CustomDownloadTask extends DefaultTask {
       @TaskAction
       void doTask() {
           // 实现下载逻辑，例如将文件下载到应用的assets目录
           def assetsDir = project.file("src/main/assets")
           assetsDir.mkdirs()
           // 这里添加具体的下载代码，比如使用URLConnection或OkHttp
           // 示例：new URL("https://example.com/file.zip").withInputStream { input ->
           //     new File(assetsDir, "file.zip").withOutputStream { it << input }
           // }
       }
   }
   

2. 发布插件到Maven仓库
   按照Gradle插件发布流程，将插件打包发布到你的Maven仓库（可以是私有仓库或Maven Central）。

3. 应用项目集成插件
   在应用的项目级build.gradle（或settings.gradle）中引入插件：

   plugins {
       id 'com.yourcompany.customdownload' version '1.0.0'
   }
   

   之后应用项目即可执行./gradlew customDownload来运行下载任务。

方案二：让下载任务自动触发（无需手动执行） #

如果希望文件在应用构建时自动下载到assets，可在插件中让下载任务依赖于应用的preBuild任务，实现构建时自动执行：

class CustomDownloadPlugin implements Plugin<Project> {
    void apply(Project project) {
        def downloadTask = project.tasks.register('customDownload', CustomDownloadTask)
        // 让preBuild任务依赖下载任务，构建应用时自动执行下载
        project.tasks.named('preBuild').configure { it.dependsOn(downloadTask) }
    }
}

这样应用执行./gradlew assembleDebug等构建命令时，会自动完成文件下载并放入assets目录，无需手动触发任务。

方案三：提供独立Gradle脚本供应用引入 #

如果不想开发插件，可将下载任务逻辑写成单独的Gradle脚本，随库文档提供给用户，让应用项目手动引入：

1. 编写独立脚本（如download.gradle）

   tasks.register('customDownload', DefaultTask) {
       doLast {
           def assetsDir = project.file("src/main/assets")
           assetsDir.mkdirs()
           // 实现下载逻辑
       }
   }
   

2. 应用项目引入脚本
   用户可将脚本放置在本地或服务器，在应用的模块级build.gradle中引入：

   // 本地脚本示例
   apply from: rootProject.file('scripts/download.gradle')
   // 远程脚本示例
   // apply from: 'https://your-domain.com/download.gradle'
   

   引入后应用项目即可执行./gradlew customDownload。

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