# React Native 新架构升级指南（iOS篇）
## 第一步：搭建环境
### 1. 安装 HomeBrew（M1芯片）
在 ARM64 环境下安装 HomeBrew：
```bash
/bin/bash -c "$(curl -fsSL https://gitee.com/ineo6/homebrew-install/raw/master/install.sh)"
安装完成后，运行 which brew 确保 HomeBrew 安装在 /opt/Homebrew。
2. 安装 Ruby
-
安装方式 1：使用 Homebrew 安装 Ruby
- 在 Rosetta 环境下安装：
brew install ruby - 在 ARM64 环境下安装：
arch -arm64 brew install ruby
- 在 Rosetta 环境下安装：
-
安装方式 2：使用 RVM 安装 Ruby
- 安装 RVM：
curl -L get.rvm.io | bash -s stable - 启用 RVM：
source ~/.rvm/scripts/rvm - 安装指定版本 Ruby：
rvm install 2.7.4 - 设置默认版本：
rvm use 2.7.4 --default
- 安装 RVM：
第三步：基于 Ruby 安装 CocoaPods
-
如果使用 HomeBrew 安装的 Ruby，则使用 HomeBrew 安装 CocoaPods：
- 在 Rosetta 环境下安装：
brew install cocoapods - 在 ARM64 环境下安装：
arch -arm64 brew install cocoapods
- 在 Rosetta 环境下安装：
-
如果使用 RVM 安装的 Ruby，则使用 RubyGems 安装 CocoaPods：
- 安装指定版本 CocoaPods：
gem install cocoapods -v 1.14.3
- 安装指定版本 CocoaPods：
关键提示：
- Ruby 的安装方式决定 CocoaPods 的安装方式。使用brew安装ruby则使用brew安装pod，使用rvm安装ruby则使用gem安装pod，保持干净的环境
- 使用 RVM 可以灵活管理不同的 Ruby 和 CocoaPods 版本。
第四步：安装 npm
从 Node.js 官网 下载并安装任意版本 Node.js（建议使用 18.19.0）。
第五步：安装 nvm 管理 Node.js
-
自动安装：
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.34.0/install.sh | bash -
建议手动安装：
- 下载 nvm 并手动运行
install.sh脚本。 - 安装完成后，运行
which nvm验证安装。
- 下载 nvm 并手动运行
第六步：使用 nvm 安装指定版本 Node.js
-
安装 Node.js 18.19.0：
nvm install 18.19.0 运行
nvm list确认安装版本。
第七步：安装 Yarn 等相关工具
根据 React Native 官方文档安装 Yarn 和其他所需工具。
第八步：创建使用新架构的 React Native 项目
- 创建新项目并使用 0.75 版本的 React Native。
第九步：查看新项目下 Gemfile文件
- 新项目默认生成 Gemfile，指定 pod 和 Ruby 版本，如当前环境不符，参照第十步调整
第十步：如遇和新项目下Gem文件要求（如ruby版本，pod版本）不符，安装符合的版本
-
卸载 CocoaPods（如已安装 1.15 以上版本）：
brew uninstall cocoapods -
卸载 Ruby（如ruby使用 HomeBrew 安装）：
brew uninstall ruby 改为使用 RVM 安装 Ruby 2.7.4，并使用 gem 安装 CocoaPods 1.14.3。
注意：安装 Ruby 时，如果在执行 -j8 时遇到错误，请检查 OpenSSL 版本，并将其更改为 1.1 版本。
查看 OpenSSL 版本：
openssl version
修改方式
设置环境变量
运行以下命令，设置 OpenSSL 1.1 版本的环境变量：
export PATH="$(brew --prefix openssl@1.1)/bin:$PATH"
export LDFLAGS="-L$(brew --prefix openssl@1.1)/lib"
export CPPFLAGS="-I$(brew --prefix openssl@1.1)/include"
export PKG_CONFIG_PATH="$(brew --prefix openssl@1.1)/lib/pkgconfig"
将环境变量添加到 .zshrc 文件
运行以下命令，将上述环境变量永久添加到 .zshrc 文件中：
echo 'export PATH="$(brew --prefix openssl@1.1)/bin:$PATH"' >> ~/.zshrc
echo 'export LDFLAGS="-L$(brew --prefix openssl@1.1)/lib"' >> ~/.zshrc
echo 'export CPPFLAGS="-I$(brew --prefix openssl@1.1)/include"' >> ~/.zshrc
echo 'export PKG_CONFIG_PATH="$(brew --prefix openssl@1.1)/lib/pkgconfig"' >> ~/.zshrc
第三步：刷新 .zshrc 文件
执行以下命令，使更改生效：
source ~/.zshrc
确认 OpenSSL 版本
openssl version
然后重新尝试安装 Ruby。
## 第十一步：迁移旧项目
* 将 iOS 旧项目迁移至 iOS 文件夹，移除旧的 React Native 环境，修改 Podfile 和构建脚本，使项目可编译。
## 第十二步：配置 RN 新架构
* 根据新架构要求编译 React Native 环境并设置 Xcode 中的相关部分。
## 第十三步：启用 TurboModule
* 在 iOS 上启用 TurboModule，参考 [React Native 官方文档](https://reactnative.cn/docs/new-architecture-app-modules-ios)。
代码整理后尽量改为单例管理，在 `AppDelegate` 中异步初始化 RNBridge，优化启动速度。
## 第十四步：跨平台一致性
* 确保 iOS 和 Android 侧的桥接方法名、参数名、参数类型一致。否则新架构不支持
