【React Native】ios开发的基础环境搭建 - 踩坑记录

基础配置

1. MacBook Pro (M1) - Ventura 13.2.1
2. Node - v18.15.0
3. JDK - v11.0.18 （不是必需，开发必备）
4. nvm - v0.39.3 （不是必需，按需安装）

前期准备

安装yarn

npm install -g yarn

将npm设置成淘宝镜像

npm get registry 
npm config set registry https://registry.npm.taobao.org

开始环境搭建

安装 Homebrew

• Go to Homebrew - 使用首页命令行进行安装
• 配置环境变量：export PATH="/opt/homebrew/bin:$PATH （本机路径，自行替换）

安装Watchman

brew install watchman

栽坑一之：需要删文件
解决方法：一般这种报错是会给出本地路径下的某个文件，按照路径删除指定文件即可，由于系统文件的目录大部分是隐藏的（如User/Library），可以通过如下方法打开：Finder - go - go to folder… - 输入 ~/Library

栽坑二之：网络问题

解决方法：使用合适的科学上网工具，网络问题只能多试试看啰

安装rbenv - 在安装ruby之前，需要先安装它的包管理工具，我选择的是rbenv

brew install rbenv ruby-build

load rbenv in your shell

brenv init

安装ruby

brenv install 2.7.6 //官方文档上要求安装指定版本ruby，但是这个情况应该并不是必须

通过 ruby --version 查看版本，如果能查到的话，就是安装成功了

安装ruby gems
select a ruby version for your project using rbenv local 2.7.6

sudo gem install bundler //这里使用sudo是因为没使用之前，由于权限不够报错

可以通过ls -lt /Library/Ruby/Gems查看权限

安装xcode
这里没什么好说的，可以在apple store下载，也可以通过 版本首页下载，建议后者，下载速度较快。

需要避雷的就是，不要在此处下载最新版本以外的其他版本，我就是这么做，然后ios simulator跑不起来。原因不太了解。

安装xcode CLI

xcode-select -install

安装cocoapods

查看ruby源

gem sources -l

删除ruby源

gem sources --remove https://rubygems.org/

添加新源（国内ruby镜像）

gem source -a https://gems.ruby-china.com

安装 cocoapods

sudo gem install -n /usr/local/bin cocoapods

查看是否安装成功

pod --version

执行pod setup没有效果的话，就可以直接git clone https://github.com/CocoaPods/Specs.git ~/.cocoapods/repos/trunk

初始化项目

如果之前装过CLI的话，需要执行如下卸载

npm uninstall -g react-native-cli @react-native-community/cli

初始化项目

npx react-native init AwesomeProject -verbose

我初始化这里，有报错，所以我直接cd ios pod install，有网络问题报错，可以先将git文件在chrome中打开，再次执行pod install

开启虚拟机

npx react-native run-ios -simulator='iPhone 14 Pro'

虚拟机的选择，可以根据本地配置进行修改，不要和我一样

完。

附上react native官方文档的环境配置Guide，整个流程是以官方文档为主：Guide