uni-app Android离线打包的多环境配置方案_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")
        }
    }
}