React Native - 运行 iOS 应用

React Native - 在 iOS 上运行

要在 iOS 模拟器或真机设备上运行你的 React Native 应用，你必须使用 macOS 系统。你需要安装 Xcode 和 CocoaPods。

先决条件 (仅限 macOS)

• Xcode: 从 Mac App Store 安装最新版本。Xcode 是苹果公司的集成开发环境 (IDE)，包含了 iOS SDK、模拟器和构建工具。
• Xcode 命令行工具: 确保已安装。你可以通过打开 Xcode，然后选择 Preferences > Locations，在 Command Line Tools 下拉菜单中选择最新版本来安装。或者，在终端中运行 xcode-select --install。
• CocoaPods: 用于 Swift 和 Objective-C Cocoa 项目的依赖管理器。如果尚未安装，请运行: sudo gem install cocoapods。

在 iOS 模拟器上运行

1. 在终端中导航到你的 React Native 项目根目录。
2. 确保你的项目已安装 CocoaPods 依赖。如果是新项目或添加了原生模块，请运行: cd ios && pod install && cd ..
3. 运行以下命令在默认模拟器上启动你的应用:

npx react-native run-ios

或者，如果你更喜欢使用 Yarn:

yarn react-native run-ios

这将构建你的应用，将其安装到模拟器上，并启动 Metro 打包器。如果模拟器尚未运行，它将自动启动。

要在指定的模拟器上运行（例如，“iPhone 14 Pro”）：首先，通过运行 xcrun simctl list devices 查找可用模拟器的列表。然后使用 --simulator 标志:

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

在 iOS 真机设备上运行

1. 通过 USB 将你的 iOS 设备连接到 Mac。
2. 在 Xcode 中打开你的项目的 ios/{YourProjectName}.xcworkspace 文件。
3. 在 Xcode 中，从 Scheme 选择器（位于 Play/Stop 按钮旁边）中选择你的设备。
4. 配置代码签名: 在项目导航器中选择你的项目，然后选择你的应用目标。前往 ‘Signing & Capabilities’ 标签页并选择你的团队。你可能需要一个 Apple 开发者账户（免费账户允许部署到你自己的设备）。
5. 在 Xcode 中按下运行按钮 (▶)，或从终端运行（在 Xcode 中选择了设备或使用 --device "你的设备名称" 标志）:

npx react-native run-ios --device "Your iPhone's Name"

注意: 你可能需要在你的 iOS 设备上信任开发者证书（设置 > 通用 > 设备管理 或 VPN 与设备管理）。

访问开发者菜单

当你的应用在 iOS 模拟器或设备上运行时:

• 在 iOS 模拟器上: 按下 Cmd + D。
• 在真机设备上: 摇动设备。

你还可以通过在模拟器中按下 Cmd + R（或在 Metro 打包器终端中按下 R）来重新加载应用。通常默认启用 Fast Refresh（快速刷新），这为大多数代码更改提供即时更新。

对于排除 iOS 构建问题，在 Xcode 中打开项目 (ios/{YourProjectName}.xcworkspace) 并检查构建日志通常可以提供更详细的错误消息。请查阅官方 React Native 文档以获取更多详情。