自定义APK命名后切换不同Android版本设备运行报错如何解决？

问题根源 #

你当前的代码手动拼接了path路径作为APK输出路径，导致所有构建变体、不同设备的增量构建产物都会写入同一个固定路径的APK文件。切换不同Android版本设备构建时，Gradle的增量构建逻辑会尝试往已有APK中追加新的DEX等资源文件，触发zip文件条目不允许覆盖的错误。

优化方案 #

方案1：直接修正自定义命名逻辑（推荐） #

不要手动拼接输出路径，仅给outputFileName赋值文件名字符串即可，Gradle会自动将不同变体的APK输出到build/outputs/apk/[变体名]对应的独立子目录下，从根源避免文件覆盖冲突。
正确代码如下：

android.applicationVariants.all { variant ->
    variant.outputs.all { output ->
        // 仅指定文件名，无需手动拼接路径
        outputFileName = "my_app_name-${variant.name}-${variant.versionName}.apk"
    }
}

方案2：如需统一归档APK到自定义目录 #

如果有需求要把所有生成的APK汇总到指定目录，不要直接修改outputFileName的路径，而是在构建任务完成后添加拷贝逻辑：

// 自定义APK归档目录，这里示例是项目根目录下的apk_outputs文件夹
def archiveDir = new File(rootProject.rootDir, "apk_outputs")

android.applicationVariants.all { variant ->
    variant.assembleProvider.configure { assembleTask ->
        assembleTask.doLast {
            variant.outputs.each { output ->
                def sourceApk = output.outputFile
                if (sourceApk.exists()) {
                    copy {
                        from sourceApk
                        into archiveDir
                        // 自定义归档后的文件名
                        rename { "my_app_name-${variant.name}-${variant.versionName}.apk" }
                    }
                }
            }
        }
    }
}

补充适配场景 #

如果开启了ABI拆分、DEX拆分等特性，建议在文件名中添加拆分维度标识，避免同一变体下不同拆分产物的命名冲突：

android.applicationVariants.all { variant ->
    variant.outputs.all { output ->
        // 适配ABI拆分场景，无拆分时默认用universal标识
        def abi = output.getFilter(com.android.build.OutputFile.ABI) ?: "universal"
        outputFileName = "my_app_name-${variant.name}-${abi}-${variant.versionName}.apk"
    }
}

修改后切换不同设备构建无需执行clean操作，也不会出现文件覆盖冲突。

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