开发平台：macOS

目标平台：IOS

rn版本：0.72

Xcode版本：14.2

安装依赖

Node、Watchman、Xcode 和CocoaPods

1. 安装Homebrew

   Homebrew是MacOS（或 Linux）的软件包管理器。

   通过它，我们可以方便的对Mac上的各种应用软件进行管理，例如：安装、更新、查看、搜索、卸载等。

   1. 官方给出的安装命令：

      /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
      

      如果没有VPN，不要使用此命令安装！因为

      curl: (7) Failed to connect to raw.githubusercontent.com port 443: Connection refused
      

   2. 国内安装

      /bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
      

      1. 选择下载镜像

         # 中科大下载源
         1 
         

      2. 确认删除旧版本

         # 如果存在旧版本，会弹出删除旧版本提示
         Y
         

      3. 输入开机密码

      4. 安装git（如果之前没有安装过git，会终止Homebrew安装，弹出git安装提示，点击“安装”，如果没有弹出则自己在官网安装）

         https://sourceforge.net/projects/git-osx-installer/

      5. 安装Xcode，弹出安装提示，点击“安装”

      6. 再次执行Homebrew安装指令

      7. 验证是否安装成功

         # 如果正确输出版本信息，表示成功安装
         brew -v
         

      8. 如要卸载

         /bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/HomebrewUninstall.sh)"
         

2. 安装Node（使用nvm）

   1. 安装指令

      # 版本需要v16以上
      brew install node@16
      

   2. 将Node添加到PATH

      # 确保在命令行界面中使用通过Homebrew安装的Node.js（版本16），你需要将其二进制文件添加到你的PATH中
      echo 'export PATH="/usr/local/opt/node@16/bin:$PATH"' >> ~/.bash_profile
      

   3. 更新编译器标志

      # 帮助编译器定位Node.js 16的安装位置
      export LDFLAGS="-L/usr/local/opt/node@16/lib"
      export CPPFLAGS="-I/usr/local/opt/node@16/include"
      

   4. 刷新更新后的.bash_profile

      source ~/.bash_profile
      

   5. 验证安装和版本

      node -v
      

3. 安装Watchman

   1. 安装指令

      brew install watchman
      

      若因网络下载失败

      1. 设置 npm 镜像（淘宝源）以加速后面的过程

         # 使用nrm工具切换淘宝源
         npx nrm use taobao
         
         # 如果之后需要切换回官方源可使用
         npx nrm use npm
         

      2. 镜像源切换

         # 切换到清华大学的镜像源
         git -C "$(brew --repo)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git
         

      3. 使用代理

4. 安装Xcode

   React Native 目前需要Xcode (opens new window) 12 或更高版本

   启动 Xcode，并在Xcode | Preferences | Locations菜单中检查一下是否装有某个版本的Command Line Tools

   Xcode打开项目需要打开在 ios 目录中.xcworkspace 文件，CocoaPods不执行不生成该文件

5. CocoaPods

   1. 安装指令

      brew install cocoapods
      

      注意二：0.60 及以上版本的原生依赖是通过 CocoaPods 集成安装的。CocoaPods 的源必须使用代理访问（镜像源也无效）。如果在 CocoaPods 的依赖安装步骤卡住（命令行停在 Installing CocoaPods dependencies 很久，或各种网络超时重置报错，或在 ios 目录中无法生成.xcworkspace 文件），请务必检查确定你的代理配置是否对命令行有效。

   2. 查看版本

      pod --version
      

      如：Xcode, Pods ProjectName.debug.xcconfig unable to open file. Wrong directory (opens new window)

      pod deintegrate
      pod install
      

   3. 安装

      pod install
      

   4. 运行应用

      yarn react-native run-ios
      
      

6. CocoaPods（以Ruby安装）

   1. 安装Ruby

   2. 安装完后检查

      which -a ruby
      

      只有一个系统目录

   3. 把新版本加到环境变量中

      echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.zshrc
      source ~/.zshr
      

   4. 安装CocoaPods

      gem install cocoapods
      

   5. 查看版本

      pod --version
      

真机运行

使用Xcode运行项目

1. 通过 USB 数据线连接设备

2. 用 Xcode 打开 项目中的ios 文件夹，打开.xcworkspace文件，如果是 0.60 以前的版本则打开.xcodeproj文件

   如果这是第一次在 iOS 设备上运行 app，需要注册开发设备。从 Xcode 菜单栏打开Product菜单，然后前往Destination。从列表中查找并选择设备。Xcode 将注册为开发设备

3. 配置代码签名

   公司开发者账号Apple developer account (opens new window)，个人账号加入公司team

   1. 在左侧导航栏中，选择你的项目
   2. 在项目设置中，选择 Targets下的你的主应用程序目标（通常是你的项目名称）
   3. 选择Signing & Capabilities下，在Signing部分，选择 Automatically manage signing 选项，Team下拉框选择公司的开发者账号，Bundle Identifier填入应用程序的唯一标识符。通常它采用 com.yourcompany.yourappname 的格式
   4. Targets下还有一个主应用程序名Tests，同样以上的操作
   5. 构建并运行你的 React Native 项目

4. 若报该错误[Error] Could not find node. It looks like that the .xcode.env or .xcode.env.local

   解决办法：sudo ln -s $(which node) /usr/local/bin/node

   来源：ios - New RN project in M1 mbp built failed. "Could not find node. Make sure it is in bash PATH or set the NODE_BINARY environment variable." - Stack Overflow (opens new window)

nvm

1. 安装

   brew install nvm
   

2. 将 nvm 添加到您的 shell 配置文件：要使 nvm 在每次打开新终端窗口时可用，您需要将以下行添加到您的 shell 配置文件（例如 ~/.bash_profile 或 ~/.zshrc）

   source $(brew --prefix nvm)/nvm.sh
   

3. 安装 Node.js

   nvm install node
   

4. 安装所需版本

   nvm install 16
   

5. 使用已安装的版本

   nvm use 16
   

6. 设置默认版本

   nvm alias default 16