# React Native 新架構升級指南（iOS篇）
## 第一步：搭建環(huán)境
### 1. 安裝 HomeBrew（M1芯片）
在 ARM64 環(huán)境下安裝 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 環(huán)境下安裝：
brew install ruby - 在 ARM64 環(huán)境下安裝：
arch -arm64 brew install ruby
- 在 Rosetta 環(huán)境下安裝：
-
安裝方式 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 環(huán)境下安裝：
brew install cocoapods - 在 ARM64 環(huán)境下安裝：
arch -arm64 brew install cocoapods
- 在 Rosetta 環(huán)境下安裝：
-
如果使用 RVM 安裝的 Ruby，則使用 RubyGems 安裝 CocoaPods：
- 安裝指定版本 CocoaPods：
gem install cocoapods -v 1.14.3
- 安裝指定版本 CocoaPods：
關鍵提示：
- Ruby 的安裝方式決定 CocoaPods 的安裝方式。使用brew安裝ruby則使用brew安裝pod飒筑，使用rvm安裝ruby則使用gem安裝pod渤涌，保持干凈的環(huán)境
- 使用 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 和其他所需工具调鬓。
第八步：創(chuàng)建使用新架構的 React Native 項目
- 創(chuàng)建新項目并使用 0.75 版本的 React Native。
第九步：查看新項目下 Gemfile文件
- 新項目默認生成 Gemfile酌伊，指定 pod 和 Ruby 版本袖迎，如當前環(huán)境不符，參照第十步調整
第十步：如遇和新項目下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 時归形，如果在執(zhí)行 -j8 時遇到錯誤托慨，請檢查 OpenSSL 版本，并將其更改為 1.1 版本暇榴。
查看 OpenSSL 版本：
openssl version
修改方式
設置環(huán)境變量
運行以下命令厚棵，設置 OpenSSL 1.1 版本的環(huán)境變量：
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"
將環(huán)境變量添加到 .zshrc 文件
運行以下命令，將上述環(huán)境變量永久添加到 .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 文件
執(zhí)行以下命令蔼紧，使更改生效：
source ~/.zshrc
確認 OpenSSL 版本
openssl version
然后重新嘗試安裝 Ruby婆硬。
## 第十一步：遷移舊項目
* 將 iOS 舊項目遷移至 iOS 文件夾，移除舊的 React Native 環(huán)境奸例，修改 Podfile 和構建腳本彬犯，使項目可編譯。
## 第十二步：配置 RN 新架構
* 根據新架構要求編譯 React Native 環(huán)境并設置 Xcode 中的相關部分查吊。
## 第十三步：啟用 TurboModule
* 在 iOS 上啟用 TurboModule谐区，參考 [React Native 官方文檔](https://reactnative.cn/docs/new-architecture-app-modules-ios)。
代碼整理后盡量改為單例管理逻卖，在 `AppDelegate` 中異步初始化 RNBridge宋列，優(yōu)化啟動速度。
## 第十四步：跨平臺一致性
* 確保 iOS 和 Android 側的橋接方法名评也、參數(shù)名炼杖、參數(shù)類型一致。否則新架構不支持
