resConfigs "zh", "xxhdpi" 应放在哪个文件？

Question

在 Android 多语言与多屏幕适配配置中，`resConfigs "zh", "xxhdpi"` 应放在 `build.gradle` 文件的 `android { }` 闭包内，通常位于 `defaultConfig` 或 `android { }` 的同级位置。常见问题是开发者误将其写入 `defaultConfig` 中，导致资源限定符未正确生效，或错误放置于 `gradle.properties` 等非构建脚本文件中。正确用法如下： ```groovy android { ... defaultConfig { ... } resConfigs "zh", "xxhdpi" } ``` 此配置可强制只打包中文和 xxhdpi 资源，减少 APK 体积。若放置位置错误，将无法过滤多余资源，影响构建结果。

Answer 1

1. 基础概念：resConfigs 的作用与 Android 资源适配机制

在 Android 开发中，resConfigs 是一个 Gradle DSL 方法，用于指定应用打包时应包含的资源限定符（resource qualifiers）。这些限定符包括语言（如 zh 表示中文）、屏幕密度（如 xxhdpi）等。通过配置 resConfigs "zh", "xxhdpi"，构建系统将仅保留与这些限定符匹配的资源文件夹（如 values-zh、drawable-xxhdpi），其余未匹配的资源将被排除。

这一机制是优化 APK 体积的关键手段之一，尤其适用于目标市场明确的应用场景。例如，若应用仅面向中国大陆用户且主要运行在高分辨率设备上，则可安全剔除其他语言和低密度资源。

2. 正确配置位置：build.gradle 中的 android 闭包层级

resConfigs 必须声明在模块级 build.gradle 文件的 android { } 闭包内，但不应嵌套在 defaultConfig 中。以下为正确结构示例：

android {
    compileSdk 34

    defaultConfig {
        applicationId "com.example.app"
        minSdk 21
        targetSdk 34
        versionCode 1
        versionName "1.0"
    }

    resConfigs "zh", "xxhdpi"
}

若错误地将 resConfigs 放入 defaultConfig 块中，虽然编译不会报错，但实际资源过滤行为可能失效或不可预测，导致多语言资源仍被打包进 APK。

3. 常见错误配置场景分析

• 误置于 defaultConfig 内部：部分开发者误认为所有构建参数都应在 defaultConfig 中设置，导致如下错误写法：

defaultConfig {
    ...
    resConfigs "zh", "xxhdpi" // ❌ 错误位置
}

• 放置于 gradle.properties 文件：gradle.properties 仅支持键值对属性定义，不解析 Groovy DSL，因此如下写法完全无效：

resConfigs=zh,xxhdpi # ❌ 不会被识别

• 拼写错误或使用非标准限定符：如将 xxhdpi 写成 xhdpi 或 xxxhdpi，或使用不存在的语言代码如 cn 而非 zh，均会导致预期外的资源保留。

4. 构建流程中的资源过滤机制剖析

当执行 ./gradlew assembleRelease 时，Android Gradle 插件会经历以下关键阶段：

1. 解析 resConfigs 配置项，生成允许的资源配置白名单。
2. 扫描 src/main/res/ 目录下所有资源子目录（如 values-en, drawable-mdpi 等）。
3. 根据资源目录名称中的限定符判断是否在白名单中。
4. 仅将匹配的资源传递给 aapt2 进行编译与打包。
5. 最终生成的 R.java 和 resources.arsc 中仅包含有效资源引用。

此过程可通过开启 Gradle 日志（--info）观察资源剪裁详情。

5. 实际效果验证方法与工具链支持

为确认 resConfigs 是否生效，推荐以下几种验证方式：

验证方法	操作步骤	预期结果
APK Analyzer	在 Android Studio 中打开 APK，查看 res/ 下的目录结构	仅存在 values-zh 和 drawable-xxhdpi 等相关目录
aapt dump	命令行执行：aapt dump configurations your_app.apk	输出中仅列出 zh 和 xxhdpi 相关配置
对比构建大小	分别构建启用与禁用 resConfigs 的版本	启用后 APK 体积显著减小（通常减少 10%-30%）

6. 高级应用场景与扩展配置建议

对于复杂项目，可结合产品维度（productFlavors）动态控制资源配置：

android {
    flavorDimensions "region"
    productFlavors {
        china {
            dimension "region"
            resConfigs "zh", "xxhdpi"
        }
        global {
            dimension "region"
            resConfigs "en", "xxhdpi", "xhdpi"
        }
    }
}

此外，还可配合 packagingOptions 排除特定文件，进一步精细化资源管理：

packagingOptions {
    exclude '/META-INF/*'
}

此类组合策略在大型企业级应用中广泛应用，实现“一套代码、多端发布”的高效交付模式。

7. Mermaid 流程图：resConfigs 生效全流程可视化

graph TD
    A[开始构建] --> B{读取 build.gradle}
    B --> C[提取 android.resConfigs]
    C --> D[建立资源白名单: zh, xxhdpi]
    D --> E[扫描 res/ 所有目录]
    E --> F{目录限定符是否匹配?}
    F -- 是 --> G[保留资源并参与编译]
    F -- 否 --> H[丢弃该资源目录]
    G --> I[生成精简版 resources.arsc]
    H --> I
    I --> J[输出最终 APK]

该流程清晰展示了从配置读取到资源剪裁的完整生命周期，有助于理解其底层运作逻辑。