uni-app Android离线打包的多环境配置方案实用指南

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“uni-app Android离线打包的多环境配置方案”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序，把思路、关键写法和容易踩坑的地方讲清楚，便于大家直接对照操作。

很多 uni-app 项目在离线打包阶段都会遇到一个问题：
落到代码里，线上包、测试包共用一套设置，导致包名冲突、应用名称不区分、推送参数混用，甚至 release 包还带着 debug 开关。

理解这一步时，这篇文章基于一个真实项目，整理一套可落地的 Android 多环境设置方案，目标是：

• prod 包名：com.example.app
• dev 包名：com.example.app.dev
• prod 应用名：示例应用
• dev 应用名：示例应用开发版
• prod/dev 采用不同 dcloud_appkey
• release 自动关闭 dcloud_control.xml 里的 debug 设置

1. 在 app 模块启用 productFlavors

文件：simpleDemo/build.gradle

android {
    defaultConfig {
        applicationId "com.example.app"
        manifestPlaceholders = [
                "GETUI_APPID"           : "YOUR_GETUI_APPID",
                "plus.unipush.appid"    : "YOUR_UNIPUSH_APPID",
                "plus.unipush.appkey"   : "YOUR_UNIPUSH_APPKEY",
                "plus.unipush.appsecret": "YOUR_UNIPUSH_APPSECRET",
                "apk.applicationId"     : "${applicationId}"
        ]
    }
    flavorDimensions "env"
    productFlavors {
        prod {
            dimension "env"
            manifestPlaceholders["DCLOUD_APPKEY"] = "YOUR_PROD_DCLOUD_APPKEY"
        }
        dev {
            dimension "env"
            applicationIdSuffix ".dev"
            manifestPlaceholders["DCLOUD_APPKEY"] = "YOUR_DEV_DCLOUD_APPKEY"
        }
    }
}

说明：

• applicationIdSuffix ".dev" 会让 dev 最后包名变成 com.example.app.dev
• 把 apk.applicationId 写成 ${applicationId}，避免 dev 包里仍然写死 prod 包名
• DCLOUD_APPKEY 用 flavor 维度区分，避免测试和线上串环境

2. Manifest 中采用占位符注入 dcloud_appkey

文件：simpleDemo/src/main/AndroidManifest.xml

<meta-data
    android:name="dcloud_appkey"
    android:value="${DCLOUD_APPKEY}" />

说明：
不要把 dcloud_appkey 写死在 main，否则 prod/dev 无法自动切换。

3. 应用名称按环境覆盖

main 保持正式名称：

文件：simpleDemo/src/main/res/values/strings.xml

<resources>
    <string name="app_name">示例应用</string>
</resources>

dev 增加同名资源覆盖：

文件：simpleDemo/src/dev/res/values/strings.xml

<resources>
    <string name="app_name">示例应用开发版</string>
</resources>

说明：
从实现思路看，Android 资源会按构建变体自动覆盖，dev 下同名 app_name 会覆盖 main。

4. release 自动关闭 dcloud 调试开关

如果 dcloud_control.xml 放在 src/main 且写着 debug="true"，release 也会继承这个设置。
正确做法是按 buildType 拆分。

调试包设置：

文件：simpleDemo/src/debug/assets/data/dcloud_control.xml

<hbuilder debug="true" syncDebug="true">
<apps>
    <app appid="__UNI__XXXXXXX" appver=""/>
</apps>
</hbuilder>

发布包设置：

文件：simpleDemo/src/release/assets/data/dcloud_control.xml

<hbuilder debug="false" syncDebug="false">
<apps>
    <app appid="__UNI__XXXXXXX" appver=""/>
</apps>
</hbuilder>

并删除：

• simpleDemo/src/main/assets/data/dcloud_control.xml

5. 让输出 APK 名称带上 flavor

设置后会出现 prodDebug/devRelease 等多个变体，如果输出文件名只叫 android_release.apk，产物会互相覆盖。

建议在 androidComponents 中带上 flavor：

androidComponents {
    onVariants(selector().all()) { variant ->
        variant.outputs.forEach { output ->
            def bt = variant.buildType
            def flavor = variant.flavorName
            def flavorPart = (flavor != null && !flavor.isEmpty()) ? "${flavor}_" : ""
            output.outputFileName.set("android_${flavorPart}${bt}.apk")
        }
    }
}

6. 打包

结合项目来看，如果你采用 Android Studio 的 Build Variants 面板，正常会看到：

• prodDebug / prodRelease
• devDebug / devRelease

若只看到 debug/release，通常是 Gradle Sync 失败或未同步成功。

总结

uni-app Android 离线打包做多环境，核心是三件事：

• 用 productFlavors 区分环境（包名、key 等）
• 用 src/dev / src/release 做资源和资产覆盖（应用名、dcloud 控制文件）
• 用规范的变体命名和产物命名，避免人工误操作

这样一来，开发、测试、线上包能稳定同时行，发版也会更可控。

到此这篇关于 uni-app Android离线打包的多环境设置方案的文章就介绍到这了,更多相关 uni-app Android离线打包设置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多兼容脚本之家！