如何将一组类从一个dex文件迁移至另一个独立dex文件？

1. Gradle配置实现类拆分与独立Dex生成 #

核心思路是通过自定义Gradle任务指定要拆分的类，生成独立dex文件，同时配置主APK打包时排除这些类。

步骤1：明确拆分范围 #

先确定要拆分的类，比如指定某个包下的所有类（如com.example.downloadmodule.*），或者具体的类名列表。

步骤2：配置主APK排除目标类 #

在模块的build.gradle（Groovy）或build.gradle.kts（Kotlin）中，通过packagingOptions排除要拆分的类，确保它们不会被打包进主APK的classes.dex：

Groovy版本

android {
    // 保留原有配置...

    packagingOptions {
        // 通配符匹配要排除的类，替换为你的目标包/类路径
        exclude 'com/example/downloadmodule/**/*.class'
    }
}

Kotlin DSL版本

android {
    // 保留原有配置...

    packagingOptions {
        exclude("com/example/downloadmodule/**/*.class")
    }
}

步骤3：添加自定义任务生成独立Dex #

使用Android SDK中的dx（或高版本的d8）工具，编写Gradle任务编译指定类生成独立dex：

Groovy版本任务配置

// 生成独立拆分dex的任务
task generateSplitDex(type: Exec) {
    // 获取Android SDK路径，自动适配本地环境
    def androidSdkDir = android.sdkDirectory
    // 替换为本地已安装的build-tools版本，如34.0.0
    def buildToolsVersion = "34.0.0"
    // 选择dx或d8工具，d8是高版本SDK推荐工具
    def toolPath = "$androidSdkDir/build-tools/$buildToolsVersion/d8"

    // 类文件的编译输出目录
    def inputClassDir = file("$project.buildDir/intermediates/javac/debug/classes")
    // 独立dex的输出目录
    def outputDir = file("$project.buildDir/outputs/split_dex")
    outputDir.mkdirs()

    // 指定要打包进独立dex的类，替换为你的目标范围
    def targetClasses = "com/example/downloadmodule/**/*.class"

    // 执行d8命令生成dex
    commandLine toolPath, "--output", "$outputDir/split.dex", inputClassDir.absolutePath, "--include", targetClasses
}

// 让拆分任务在编译完成后自动执行
afterEvaluate {
    compileDebugJavaWithJavac.finalizedBy(generateSplitDex)
}

Kotlin DSL版本任务配置

tasks.register<Exec>("generateSplitDex") {
    val androidSdkDir = android.sdkDirectory
    val buildToolsVersion = "34.0.0"
    val toolPath = "${androidSdkDir}/build-tools/${buildToolsVersion}/d8"

    val inputClassDir = file("${project.buildDir}/intermediates/javac/debug/classes")
    val outputDir = file("${project.buildDir}/outputs/split_dex")
    outputDir.mkdirs()

    val targetClasses = "com/example/downloadmodule/**/*.class"

    commandLine(toolPath, "--output", "${outputDir}/split.dex", inputClassDir.absolutePath, "--include", targetClasses)
}

afterEvaluate {
    tasks.named("compileDebugJavaWithJavac").configure {
        finalizedBy("generateSplitDex")
    }
}

步骤4：验证结果 #

编译项目后：

• 解压主APK，用dexdump工具查看classes.dex，确认目标类已被排除；
• 检查build/outputs/split_dex/split.dex，验证拆分的类是否存在其中。

2. 关键注意事项 #

• 依赖兼容性：拆分的类若依赖主dex中的类（如你提到的接口），必须确保主dex保留这些依赖类，否则加载独立dex时会触发ClassNotFoundException。
• 混淆适配：若开启了ProGuard/R8，需在混淆规则中保留拆分类的名称，以及它们依赖的主dex类/接口：

  # 保留拆分模块的类结构
  -keep class com.example.downloadmodule.** { *; }
  # 保留主dex中被依赖的接口
  -keep interface com.example.base.IDownloadService { *; }
  

• SDK版本适配：若使用低版本SDK，可将工具替换为dx，命令格式为：dx --dex --output split.dex 目标类路径。

3. 加载逻辑适配 #

你已实现的dex加载逻辑只需稍作调整：将下载后的split.dex路径传入DexClassLoader，并指定主APK的类加载器作为父加载器，确保拆分类能正确引用主dex中的依赖：

File splitDexFile = new File(getExternalFilesDir(null), "split.dex");
DexClassLoader dexLoader = new DexClassLoader(
    splitDexFile.getAbsolutePath(),
    getCacheDir().getAbsolutePath(), // 优化目录
    null,
    getClassLoader() // 主类加载器作为父加载器，解决依赖问题
);
Class<?> targetClass = dexLoader.loadClass("com.example.downloadmodule.DownloadServiceImpl");
IDownloadService service = (IDownloadService) targetClass.newInstance();
service.executeTask();

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