Android中如何通过Gradle复制外部库的Assets资源

错误原因分析 #

• implementation 配置本身是**不可解析（canBeResolved=false）**的，仅用于声明依赖，不能直接调用resolvedConfiguration获取依赖文件。
• 直接使用runtimeClasspath报错，是因为Android Gradle插件的配置按构建变体（debug/release等）划分，全局的runtimeClasspath不存在，需指定具体变体配置或创建自定义可解析配置。

正确实现方案 #

方案1：创建自定义可解析配置（推荐，不依赖变体）

在模块的build.gradle中添加以下代码：

// 1. 创建自定义可解析配置，继承implementation的依赖
configurations {
    libraryAssetsExtractor {
        extendsFrom implementation
        canBeResolved = true
    }
}

def destinationDir = file("$buildDir/copied-library-files")

// 2. 定义复制任务
task copyLibraryAssets(type: Copy) {
    // 确保任务在依赖解析完成后执行
    dependsOn configurations.libraryAssetsExtractor

    // 定位目标库的JAR/AAR文件
    def libraryFile = configurations.libraryAssetsExtractor.resolvedConfiguration.resolvedArtifacts.find {
        it.moduleVersion.id.group == 'com.example' && it.moduleVersion.id.name == 'my-external-library'
    }?.file

    if (libraryFile) {
        // 从库文件中提取指定内容
        from zipTree(libraryFile) {
            include 'assets/**', 'config.txt'
        }
        into destinationDir
    } else {
        println "未找到目标库：com.example:my-external-library"
    }
}

// 3. 让复制任务在预构建阶段前执行
preBuild.dependsOn copyLibraryAssets

方案2：使用Android变体的Runtime配置（针对特定构建变体）

如果仅需处理某个特定变体（比如debug），可直接使用对应变体的runtime配置：

def destinationDir = file("$buildDir/copied-library-files")

task copyLibraryAssets(type: Copy) {
    // 依赖debug变体的runtime配置
    dependsOn configurations.debugRuntimeClasspath

    def libraryFile = configurations.debugRuntimeClasspath.resolvedConfiguration.resolvedArtifacts.find {
        it.moduleVersion.id.group == 'com.example' && it.moduleVersion.id.name == 'my-external-library'
    }?.file

    if (libraryFile) {
        from zipTree(libraryFile) {
            include 'assets/**', 'config.txt'
        }
        into destinationDir
    } else {
        println "未找到目标库：com.example:my-external-library"
    }
}

preBuild.dependsOn copyLibraryAssets

关键说明 #

• 自定义配置libraryAssetsExtractor通过extendsFrom implementation继承了原依赖声明，同时设置canBeResolved=true，满足解析依赖文件的要求。
• 任务直接依赖配置而非手动指定resolveDependencies，Gradle会自动处理依赖解析的时机，更可靠。
• 多模块项目中，需确保配置和任务定义在引入该外部库的模块内。

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