React Native CodePush项目iOS多环境部署测试指南-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00777/article/details/148419116

React Native CodePush项目iOS多环境部署测试指南

react-native-code-push React Native module for CodePush 项目地址: https://gitcode.com/gh_mirrors/re/react-native-code-push

前言

在React Native应用开发中，CodePush作为热更新解决方案被广泛使用。在实际开发流程中，我们通常需要区分测试环境(Staging)和生产环境(Production)进行不同版本的部署和测试。本文将详细介绍如何在iOS平台上配置React Native CodePush实现多环境部署测试。

核心概念

多环境部署测试主要解决以下问题：

测试环境和生产环境使用不同的部署密钥(Deployment Key)
不同环境的构建产物可以共存于同一设备
通过构建配置区分不同环境

配置步骤详解

1. 创建新的构建配置

Xcode允许为每个配置(如Debug、Release)定义自定义构建设置：

在Xcode中打开项目，选择项目导航器中的项目节点
选择"Info"标签页
在"Configurations"部分点击"+"按钮，选择"Duplicate 'Release' Configuration"
将新配置命名为"Staging"（或其他你喜欢的名称）

2. 配置用户自定义设置

解决构建路径问题

由于React Native 0.40.0及以上版本的已知问题，我们需要特殊处理构建路径：

点击工具栏的"+"按钮，选择"Add User-Defined Setting"
命名为"Multi_Deployment_Config"
为Release配置设置值：$(BUILD_DIR)/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME)
为Staging配置设置值：$(BUILD_DIR)/Release$(EFFECTIVE_PLATFORM_NAME)

技术说明：这个步骤确保Staging配置使用与Release相同的构建路径，避免RN模块查找问题

设置部署密钥

再次添加用户自定义设置，命名为"CODEPUSH_KEY"
展开该设置，为Staging配置指定测试环境部署密钥
为Release配置指定生产环境部署密钥

提示：部署密钥可通过命令行工具获取

3. 修改Info.plist配置

打开项目的Info.plist文件
将CodePushDeploymentKey的值修改为$(CODEPUSH_KEY)

这样设置后，构建系统会根据当前构建配置自动选择对应的部署密钥。

高级配置选项

区分应用标识和图标

为了使测试版和正式版应用能在同一设备上共存并易于区分：

修改"Product Bundle Identifier"：为Staging配置添加后缀（如".staging"）
调整"Product Name"：为测试版添加标识（如"MyApp(Test)"）
更改"Asset Catalog App Icon Set Name"：使用不同的应用图标

CocoaPods注意事项

如果项目使用CocoaPods管理依赖，在添加新配置后需要：

运行pod install命令
确保Pod项目的配置与新添加的配置匹配

常见问题解决

库未找到错误：如果遇到ld: library not found for ...错误，通常是由于构建路径配置不正确导致，请检查"Multi_Deployment_Config"设置
React Native版本兼容性：RN 0.40.0及以上版本需要特殊处理构建路径，这是已知问题
部署密钥不生效：确保Info.plist中的键名与代码中使用的完全一致，包括大小写