全新Expokit项目Detox Android构建失败：Dexing错误

你碰到的是Java 8特性在低Android API版本下的兼容性问题——项目minSdkVersion设为21，但依赖的unimodules核心库使用了Java 8的默认接口方法，这种特性在Android N（API 24）以下需要额外配置才能被D8编译器正确处理。下面是具体的解决步骤：

1. 配置项目支持Java 8编译 #

打开android/app/build.gradle文件，在android代码块中添加Java 8编译选项，强制编译器处理Java 8特性并转译为低版本兼容的字节码：

android {
    // 保留你原有的其他配置（比如defaultConfig、buildTypes等）
    
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

2. 启用Desugar支持（关键步骤） #

为了让低版本Android设备兼容Java 8的新特性，需要开启Desugar工具。在项目根目录的gradle.properties文件中添加以下配置：

android.enableD8.desugar=true

3. 修正Detox构建命令（可选但建议） #

检查你Detox配置中的Android build命令，确保转义符正确（当前配置里的&&是HTML转义，应该替换为普通的&&）：

"android.device.debug": {
  "binaryPath": "android/app/build/outputs/apk/debug/app-debug.apk",
  "build": "cd android && ./gradlew assembleDebug assembleAndroidTest -DtestBuildType=debug && cd ..",
  "type": "android.attached",
  "name": "HYF0219402003939"
}

4. 清理缓存并重新构建 #

执行以下命令清理旧的构建缓存，避免残留问题：

# 清理Android Gradle缓存
cd android && ./gradlew clean && cd ..

# 清理Yarn缓存
yarn cache clean

之后重新运行Detox构建命令：

detox build -c android.device.debug

问题根源解释 #

Java 8引入的默认接口方法（比如org.unimodules.core.interfaces.Package.createExportedModules）在Android 7.0（API 24）及以上才原生支持。对于更低版本的API，需要通过Google的Desugar工具将这些Java 8特性转换为兼容低版本的字节码，否则D8编译器会抛出你看到的错误。

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