企业官网建设流程全解析

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中获取环境变量

通过原生插件将配置传递给JS：

public 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 assembleProdRelease

4.2 Android Studio配置

1. 打开Build Variants面板
2. 选择需要的变体组合：
   • 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.png

5.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 安全加固建议

1. 生产环境关闭调试功能：

<!-- AndroidManifest.xml --> <application android:debuggable="${isDebug}" ...>

2. 配置ProGuard规则：

# release环境启用代码混淆 -release { minifyEnabled true proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' }

这套方案在我们多个项目中稳定运行，关键点在于保持配置的集中管理，避免散落在代码各处。实际使用中建议结合CI/CD流程，实现开发->测试->生产的全自动构建发布。