CRMEB Pro v1.2快速打包APP全流程指南

一、环境准备与前置条件

在开始CRMEB Pro v1.2的APP打包前，开发者需完成基础环境搭建。首先，确保系统已安装Node.js（建议版本14.x及以上），通过node -v和npm -v命令验证安装状态。同时，需配置HBuilderX开发工具（版本3.6.0+），该工具支持Uni-app框架的跨平台编译，是CRMEB Pro v1.2官方推荐的打包环境。

对于iOS打包，需额外准备Mac电脑及Xcode开发环境（Xcode 14+），并注册Apple开发者账号以获取证书。Android打包则需安装Android Studio，配置JDK 11及Gradle 7.x环境。建议开发者提前下载HBuilderX的Uni-app插件市场，获取CRMEB Pro v1.2的完整源码包，解压后检查manifest.json文件中的基础配置是否完整。

二、代码修改与定制化配置

1. 基础配置调整

打开项目根目录下的manifest.json文件，重点修改以下参数：

{
  "appid": "您的应用唯一标识",
  "appname": "自定义应用名称",
  "version": {
    "name": "1.2.0",
    "code": 102
  },
  "permission": {
    "scope.userLocation": {
      "desc": "您的位置信息将用于定位服务"
    }
  }
}

需确保appid与云端部署的ID一致，避免签名验证失败。

2. 页面路由优化

在pages.json中，检查路由配置是否包含所有业务模块。例如，首页路径应配置为：

{
  "path": "pages/index/index",
  "style": {
    "navigationBarTitleText": "首页",
    "enablePullDownRefresh": true
  }
}

建议删除测试页面路由，减少打包体积。

3. 接口地址替换

打开common/config.js文件，将测试环境API地址替换为生产环境地址：

export const API_BASE_URL = 'https://your-domain.com/api';

同时检查跨域配置，确保后端服务已开放CORS策略。

三、证书生成与配置

1. iOS证书申请流程

1. 登录Apple开发者账号，进入”Certificates, Identifiers & Profiles”
2. 创建App ID，勾选”Push Notifications”服务
3. 生成开发证书（Development CSR）和发布证书（Production CSR）
4. 下载.cer文件后，通过钥匙串访问工具导出.p12格式证书

2. Android签名配置

使用JDK自带的keytool生成签名文件：

keytool -genkey -v -keystore my-release-key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias my-alias

生成后，在project.config.json中配置签名信息：

{
  "android": {
    "keystore": "path/to/my-release-key.jks",
    "keystorePassword": "your-password",
    "keyAlias": "my-alias",
    "keyPassword": "your-password"
  }
}

四、跨平台打包实操

1. HBuilderX打包流程

1. 打开HBuilderX，导入CRMEB Pro v1.2项目
2. 点击菜单栏”发行”→”原生App-云打包”
3. 选择平台（iOS/Android）及打包类型（测试/正式）
4. 上传对应平台的证书文件
5. 点击”打包”按钮，等待云端编译完成（通常需要5-10分钟）

2. 命令行打包方案（高级）

对于自动化部署需求，可使用Uni-app CLI工具：

# 安装CLI工具
npm install -g @dcloudio/uni-cli
# Android打包
uni build --platform android --mode release
# iOS打包（需Mac环境）
uni build --platform ios --mode release

打包生成的.apk或.ipa文件位于/dist/build目录下。

五、常见问题解决方案

1. 白屏问题排查

• 检查main.js中是否正确引入Vuex和路由
• 验证static/js/config.js中的CDN资源是否可访问
• 使用Chrome DevTools远程调试Android设备

2. 接口500错误处理

• 确认后端服务已部署且Nginx配置正确
• 检查请求头是否包含Authorization字段
• 使用Postman测试接口连通性

3. 打包体积优化

• 启用Webpack的代码分割功能
• 压缩图片资源（建议使用TinyPNG）
• 移除未使用的依赖库

六、发布前最终检查清单

1. 验证所有支付功能是否正常
2. 检查微信分享、QQ登录等第三方SDK集成
3. 测试不同网络环境下的加载速度
4. 确认应用名称、图标、启动图符合规范
5. 准备应用商店描述文案和截图素材

通过以上系统化的操作流程，开发者可高效完成CRMEB Pro v1.2的APP打包工作。建议首次打包时预留充足时间进行多设备测试，确保应用在各种场景下的稳定性。对于企业级应用，建议建立持续集成（CI）流程，实现代码提交后自动打包部署，大幅提升开发效率。