type
status
date
summary
slug
tags
category
Created time
Mar 18, 2025 01:25 AM
icon
password
本文将详细介绍如何在 macOS 环境下安装和配置 React Native 开发环境，包括 Ruby、CocoaPods、Node.js、Yarn 等工具的安装，以及如何创建和运行第一个 React Native 项目。
前置条件
1. 安装 Ruby
React Native 在 iOS 平台的构建依赖于 Ruby 环境。
• 安装 rbenv：用于管理 Ruby 版本。
• 配置环境变量：将以下内容添加到 ~/.zshrc 文件中，以确保终端能够识别 rbenv 命令。
添加后，执行以下命令使配置生效：
• 安装 Ruby 3.2.3：使用 rbenv 安装指定版本的 Ruby，并设置为全局默认版本。
• 验证安装：确保 Ruby 安装成功。
2. 安装 CocoaPods
CocoaPods 是 iOS 项目依赖管理工具，React Native 使用它来管理原生模块依赖。
• 配置 RubyGems 镜像源：使用清华大学的镜像源，加速 gem 包的下载速度。
• 验证源配置：查看当前使用的 gem 源。
• 安装 CocoaPods：使用 gem 安装 CocoaPods。
• 配置环境变量：将 CocoaPods 的执行路径添加到环境变量中。
添加后，执行以下命令使配置生效：
3. 安装 Node.js 和 Yarn
React Native 需要 Node.js 作为运行环境，Yarn 用于管理 JavaScript 依赖。
• 安装 Node.js：建议使用 Homebrew 安装 Node.js。
• 验证安装：确保 Node.js 安装成功。
• 安装 Yarn：使用 npm 安装 Yarn。
• 验证安装：确保 Yarn 安装成功。
4. 安装 Watchman（可选）
Watchman 是 Facebook 开发的文件监视工具，React Native 使用它来监听文件变化，提高开发效率。
创建 React Native 项目
• 初始化项目：使用 React Native CLI 创建新项目。
这将创建一个名为 AwesomeProject 的新项目，并自动安装所需的依赖。
配置 iOS 构建环境
在 macOS 上开发 iOS 应用，需要确保 Xcode 和相关工具已正确安装。
• 安装 Xcode：从 Mac App Store 下载并安装 Xcode。
• 安装 Xcode 命令行工具：确保 Xcode 的命令行工具已安装。
• 同意 Xcode 许可协议：首次使用 Xcode 时，需要同意许可协议。
安装 iOS 依赖
• 进入 iOS 目录：进入项目的 iOS 部分。
• 安装 CocoaPods 依赖：使用 CocoaPods 安装 iOS 依赖。
运行项目
• 返回项目根目录：确保在项目的根目录下。
• 启动 Metro Bundler：Metro 是 React Native 的打包工具，负责打包 JavaScript 代码。
• 在模拟器或真机上运行应用：
• iOS：
• Android（需要配置 Android 开发环境）：
通过以上步骤，您已成功在 macOS 上设置了 React Native 开发环境，并创建和运行了第一个 React Native 项目。
参考资料
- 作者:文浩
- 链接:https://blog.wenhaofree.com/article/1ba28842-4922-80be-bcbd-e26aef5b0895
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议，转载请注明出处。
