嘉兴建企业网站,京东网上购物商城官方网站,网站 的特效,软件外包平台 接单本文档将详细介绍如何在 macOS 上搭建 iOS 开发环境#xff0c;以便进行 React Native 开发。#xff08;为了保证环境一致 全部在网络通畅的情况下运行#xff09; 1. 安装 Homebrew
Homebrew 是 macOS 的包管理工具#xff0c;我们将通过它来安装开发所需的工具。
安装…本文档将详细介绍如何在 macOS 上搭建 iOS 开发环境以便进行 React Native 开发。为了保证环境一致 全部在网络通畅的情况下运行 1. 安装 Homebrew
Homebrew 是 macOS 的包管理工具我们将通过它来安装开发所需的工具。
安装 Homebrew
打开终端并输入以下命令来安装 Homebrew
/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)验证安装
安装完成后可以运行以下命令来检查 Homebrew 是否安装成功
brew --version输出示例
Homebrew 4.4.112. 安装 Node 和 NPM
Node.js 是 React Native 开发的基础NPM 是 Node.js 的包管理工具。
使用 Homebrew 安装 Node.js
运行以下命令来安装 Node.js
brew install node验证安装
安装完成后使用以下命令检查 Node 和 NPM 是否成功安装
node --version输出示例
v23.4.0npm --version输出示例
10.9.23. 安装 Watchman 工具
Watchman 是一个监控文件系统的工具可以加速 React Native 项目的构建过程。
安装 Watchman
使用 Homebrew 安装 Watchman
brew install watchman验证安装
安装完成后运行以下命令检查是否成功安装
watchman --version输出示例
2024.12.02.004. 安装 Xcode
Xcode 是苹果官方的开发环境包含了构建 iOS 应用所需的工具链。最简单的安装方式是通过 Mac App Store。
安装步骤
打开 Mac App Store。搜索 Xcode 并点击安装。安装完成后Xcode 会自动安装 iOS 模拟器以及其他开发工具。 5. 安装 Ruby 和 rbenv
React Native 需要使用 Ruby 环境来管理 CocoaPodsCocoaPods 是一个用于管理 iOS 项目依赖的工具。
安装 rbenv 和 Ruby
使用 Homebrew 安装 rbenv 和 ruby-build
brew install rbenv ruby-build安装完成后运行以下命令进行初始化
rbenv init根据终端提示执行以下命令将 rbenv init 添加到 .zshrc 文件中
echo eval $(rbenv init - zsh) ~/.zshrc安装指定版本的 Ruby
使用以下命令安装 Ruby 版本 3.36
rbenv install 3.36
rbenv global 3.366. 安装 CocoaPods
CocoaPods 用于管理 React Native 项目的 iOS 依赖库。
安装 CocoaPods
使用 Gem 安装 CocoaPods
sudo gem install cocoapods验证安装
安装完成后使用以下命令验证是否成功安装
pod --version输出示例
1.16.27. 新建一个 React Native 项目
步骤 1创建新项目
如果您之前全局安装了 react-native-cli请先卸载它以避免潜在的问题
npm uninstall -g react-native-cli react-native-community/cli接着使用 React Native Community CLI 创建一个新的 React Native 项目
npx react-native-community/clilatest init AwesomeProject步骤 2启动 iOS 模拟器
在项目目录下运行以下命令启动 iOS 模拟器
npm run ios如果遇到问题请按照终端的提示进行修复。 其他可能遇到的问题
在使用 iOS 模拟器时可能会遇到以下问题
模拟器启动失败error Unable to open base configuration reference file ‘/Users/caredamon/project/github/workspaces-react/AwesomeProject/ios/Pods/Target Support Files/Pods-AwesomeProject/Pods-AwesomeProject.debug.xcconfig’. error Unable to load contents of file list: ‘/Target Support Files/Pods-AwesomeProject/Pods-AwesomeProject-resources-Debug-input-files.xcfilelist’ error Failed to build ios project. “xcodebuild” exited with error code ‘65’. 错误分析 Unable to open base configuration reference file 这是因为 CocoaPods 没有生成或正确配置 .xcconfig 文件。 Unable to load contents of file list 这是因为 Pods 相关的文件列表如 input-files.xcfilelist 和 output-files.xcfilelist不存在或路径不正确。 xcodebuild exited with error code 65 这是 iOS 项目配置或依赖问题的通用错误特别是在缺少 Pods 安装的情况下。 解决方案
按照以下步骤逐一检查和解决问题
1. 检查 CocoaPods 是否已正确安装
如果你的 macOS 没有安装 CocoaPods 或版本过旧可能会导致依赖无法解析。
检查版本pod --version如果没有安装或版本低于 1.11.3请重新安装或更新sudo gem install cocoapods2. 重新安装 Pods 依赖
进入项目的 ios 目录删除旧的 Pods 目录和锁文件重新安装 Pods 依赖
进入 ios 目录cd ios删除旧的 Pods 目录和锁文件rm -rf Pods Podfile.lock重新安装 Pods 依赖pod install确保 Podfile.lock 和 Pods 文件夹被成功生成。
运行项目
npx react-native run-ios在使用 iOS 模拟器时可能会遇到以下问题
node:events:491 throw er; // Unhandled ‘error’ event ^ Error: EMFILE: too many open files, watch at FSWatcher._handle.onchange (node:internal/fs/watchers:207:21) Emitted ‘error’ event on NodeWatcher instance at: at FSWatcher._checkedEmitError (/Users/caredamon/project/github/workspaces-react/baseProjectRN/node_modules/metro-file-map/src/watchers/NodeWatcher.js:82:12) at FSWatcher.emit (node:events:513:28) at FSWatcher._handle.onchange (node:internal/fs/watchers:213:12) { errno: -24, syscall: ‘watch’, code: ‘EMFILE’, filename: null } Node.js v23.4.0
解决方案
Delete node_modules folder and run npm install solved the issue
