uni-app Android离线打包多环境配置实战

1. 项目背景与核心需求在uni-app跨平台开发中Android离线打包是许多中大型项目的刚需场景。当我们需要对接第三方SDK、深度定制原生功能或规避云端打包限制时离线打包方案就成为了必选项。而实际开发中最让人头疼的莫过于如何优雅地管理不同环境如prod生产环境和dev开发环境的配置差异。我最近主导的一个电商项目就遇到了典型痛点测试阶段API地址是测试服务器支付使用沙箱环境上线后需要切换为生产环境配置。如果每次打包都手动修改配置不仅效率低下而且极易出错。经过多次迭代我们总结出一套稳定可靠的多环境配置方案现在把完整实现过程分享给大家。2. 环境配置方案设计2.1 配置文件结构设计在Android离线打包工程中通常位于HBuilder-Integrate-AS目录我们建立如下配置结构app/src/ ├── dev/ │ ├── assets/ # 开发环境静态资源 │ └── res/ # 开发环境资源配置 ├── prod/ │ ├── assets/ # 生产环境静态资源 │ └── res/ # 生产环境资源配置 └── main/ # 公共配置 ├── AndroidManifest.xml └── java/2.2 关键配置实现在app模块的build.gradle中添加以下配置android { flavorDimensions environment productFlavors { dev { dimension environment manifestPlaceholders [ APP_NAME: 测试版, API_HOST: https://dev.api.com ] } prod { dimension environment manifestPlaceholders [ APP_NAME: 正式版, API_HOST: https://api.com ] } } sourceSets { dev { assets.srcDirs [src/dev/assets] res.srcDirs [src/dev/res] } prod { assets.srcDirs [src/prod/assets] res.srcDirs [src/prod/res] } } }3. uni-app与原生交互配置3.1 全局变量注入在assets/data目录下创建环境专属配置文件// dev环境配置 { apiBaseUrl: https://dev.api.com, debugMode: true, paymentEnv: sandbox } // prod环境配置 { apiBaseUrl: https://api.com, debugMode: false, paymentEnv: production }在原生代码中通过以下方式读取public class EnvConfig { public static JSONObject getConfig(Context context) { try { InputStream is context.getAssets().open(data/config.json); int size is.available(); byte[] buffer new byte[size]; is.read(buffer); is.close(); return new JSONObject(new String(buffer, UTF-8)); } catch (Exception e) { e.printStackTrace(); return new JSONObject(); } } }3.2 uni-app中获取环境变量通过原生插件将配置传递给JSpublic class EnvModule extends UniModule { JSMethod(uiThread false) public void getEnvConfig(JSCallback callback) { JSONObject config EnvConfig.getConfig(mUniSDKInstance.getContext()); callback.invoke(config); } }在vue组件中使用const env ref({}) uni.requireNativePlugin(EnvModule).getEnvConfig(res { env.value res })4. 打包与调试实战4.1 命令行打包在项目根目录执行# 开发环境打包 ./gradlew assembleDevDebug # 生产环境打包 ./gradlew assembleProdRelease4.2 Android Studio配置打开Build Variants面板选择需要的变体组合devDebug (开发调试版)prodRelease (生产发布版)4.3 环境切换验证技巧在MainActivity中加入环境检测代码if (BuildConfig.FLAVOR.equals(dev)) { Toast.makeText(this, 当前为开发环境, Toast.LENGTH_LONG).show(); } else { Toast.makeText(this, 当前为生产环境, Toast.LENGTH_LONG).show(); }5. 常见问题解决方案5.1 资源合并冲突当不同环境的res目录存在同名资源时gradle会优先使用当前环境配置。建议公共资源放在main/res目录环境特有资源添加环境前缀如dev_icon.png5.2 动态库加载问题如果遇到so库加载失败检查jniLibs配置sourceSets { dev { jniLibs.srcDirs [libs/dev] } prod { jniLibs.srcDirs [libs/prod] } }5.3 渠道包兼容处理结合多渠道打包时需要调整dimensions顺序flavorDimensions channel, environment productFlavors { official { dimension channel } dev { dimension environment } }6. 高级配置技巧6.1 环境专属依赖可以为不同环境引入特定依赖dependencies { devImplementation com.squareup.leakcanary:leakcanary-android:2.9.1 prodImplementation com.google.firebase:firebase-crashlytics:18.3.2 }6.2 自动化构建脚本在Jenfile中配置自动化流程pipeline { agent any stages { stage(Build Dev) { steps { sh ./gradlew clean assembleDevDebug } } stage(Build Prod) { when { branch main } steps { sh ./gradlew clean assembleProdRelease } } } }6.3 安全加固建议生产环境关闭调试功能!-- AndroidManifest.xml -- application android:debuggable${isDebug} ...配置ProGuard规则# release环境启用代码混淆 -release { minifyEnabled true proguardFiles getDefaultProguardFile(proguard-android.txt), proguard-rules.pro }这套方案在我们多个项目中稳定运行关键点在于保持配置的集中管理避免散落在代码各处。实际使用中建议结合CI/CD流程实现开发-测试-生产的全自动构建发布。