版本：0.80

在设备上运行

在将应用发布给用户之前，在实际设备上测试你的应用总是一个好主意。本文档将指导你完成在设备上运行 React Native 应用并将其准备好投入生产所需的步骤。

信息

如果你使用 create-expo-app 设置项目，可以通过扫描运行 npm start 时显示的二维码在 Expo Go 中的设备上运行应用。有关更多信息，请参阅 Expo 指南在设备上运行你的项目。

Android
iOS

在 Android 设备上运行你的应用

开发操作系统

macOS
Windows
Linux

1. 启用 USB 调试

大多数 Android 设备默认只能安装和运行从 Google Play 下载的应用。你需要在设备上启用 USB 调试才能在开发期间安装你的应用。

要在设备上启用 USB 调试，首先需要启用“开发者选项”菜单，方法是进入设置 → 关于手机 → 软件信息，然后连续七次点击底部的 构建版本号 行。然后你可以返回设置 → 开发者选项 启用"USB 调试”。

2. 通过 USB 连接你的设备

现在让我们设置一个 Android 设备来运行我们的 React Native 项目。继续并通过 USB 将你的设备插入开发机器。

现在通过运行 adb devices 检查你的设备是否正确连接到 ADB（Android Debug Bridge）。

$ adb devices
List of devices attached
emulator-5554 offline   # Google 模拟器
14ed2fcc device         # 物理设备

在右列看到 device 意味着设备已连接。你必须一次只连接一个设备。

备注

如果你在列表中看到 unauthorized，你需要运行 adb reverse tcp:8081 tcp:8081 并在设备上允许 USB 调试。

3. 运行你的应用

从项目的根目录；在命令提示符中输入以下内容以在设备上安装并启动你的应用：

npm
Yarn

npm run android

yarn android

如果你收到 "bridge configuration isn't available" 错误，请参阅使用 adb reverse。

提示：你也可以使用 React Native CLI 生成并运行 release 构建（例如，从项目根目录：yarn android --mode release）。

连接到开发服务器

你还可以通过连接到开发机器上运行的开发服务器在设备上快速迭代。根据你是否可以使用 USB 电缆或 Wi-Fi 网络，有几种方法可以实现这一点。

方法 1：使用 adb reverse（推荐）

如果你的设备运行的是 Android 5.0 (Lollipop) 或更高版本，已启用 USB 调试，并且通过 USB 连接到开发机器，则可以使用此方法。

在命令提示符中运行以下命令：

$ adb -s <device name> reverse tcp:8081 tcp:8081

要查找设备名称，运行以下 adb 命令：

$ adb devices

你现在可以从开发菜单启用快速刷新。每当你的 JavaScript 代码发生更改时，你的应用都会重新加载。

方法 2：通过 Wi-Fi 连接

你也可以通过 Wi-Fi 连接到开发服务器。首先需要使用 USB 电缆在设备上安装应用，但完成后可以按照以下说明进行无线调试。继续之前你需要开发机器的当前 IP 地址。

你可以在 系统设置（或系统偏好设置） → 网络中找到 IP 地址。

确保你的笔记本电脑和手机在 同一个 Wi-Fi 网络上。
在设备上打开你的 React Native 应用。
你会看到一个带有错误的红色屏幕。这是正常的。以下步骤将修复它。
打开应用内的开发菜单。
进入 开发设置 → 设备的调试服务器主机和端口。
输入你的机器 IP 地址和本地开发服务器的端口（例如 10.0.1.1:8081）。
返回 开发菜单 并选择 重新加载 JS。

你现在可以从开发菜单启用快速刷新。每当你的 JavaScript 代码发生更改时，你的应用都会重新加载。

为生产环境构建你的应用

你已经使用 React Native 构建了一个很棒的应用，现在渴望将其发布到 Play 商店。过程与任何其他原生 Android 应用相同，但有一些额外的注意事项。遵循生成签名 APK 指南以了解更多信息。

1. 启用 USB 调试

大多数 Android 设备默认只能安装和运行从 Google Play 下载的应用。你需要在设备上启用 USB 调试才能在开发期间安装你的应用。

2. 通过 USB 连接你的设备

现在让我们设置一个 Android 设备来运行我们的 React Native 项目。继续并通过 USB 将你的设备插入开发机器。

现在通过运行 adb devices 检查你的设备是否正确连接到 ADB（Android Debug Bridge）。

$ adb devices
List of devices attached
emulator-5554 offline   # Google 模拟器
14ed2fcc device         # 物理设备

在右列看到 device 意味着设备已连接。你必须一次只连接一个设备。

3. 运行你的应用

从项目的根目录，在命令提示符中运行以下命令以在设备上安装并启动你的应用：

npm
Yarn

npm run android

yarn android

提示：你也可以使用 React Native CLI 生成并运行 release 构建（例如，从项目根目录：yarn android --mode release）。

连接到开发服务器

你还可以通过连接到开发机器上运行的开发服务器在设备上快速迭代。根据你是否可以使用 USB 电缆或 Wi-Fi 网络，有几种方法可以实现这一点。

方法 1：使用 adb reverse（推荐）

如果你的设备运行的是 Android 5.0 (Lollipop) 或更高版本，已启用 USB 调试，并且通过 USB 连接到开发机器，则可以使用此方法。

在命令提示符中运行以下命令：

$ adb -s <device name> reverse tcp:8081 tcp:8081

要查找设备名称，运行以下 adb 命令：

$ adb devices

你现在可以从开发菜单启用快速刷新。每当你的 JavaScript 代码发生更改时，你的应用都会重新加载。

方法 2：通过 Wi-Fi 连接

打开命令提示符并输入 ipconfig 以查找机器的 IP 地址（更多信息）。

确保你的笔记本电脑和手机在 同一个 Wi-Fi 网络上。
在设备上打开你的 React Native 应用。
你会看到一个带有错误的红色屏幕。这是正常的。以下步骤将修复它。
打开应用内的开发菜单。
进入 开发设置 → 设备的调试服务器主机和端口。
输入你的机器 IP 地址和本地开发服务器的端口（例如 10.0.1.1:8081）。
返回 开发菜单 并选择 重新加载 JS。

你现在可以从开发菜单启用快速刷新。每当你的 JavaScript 代码发生更改时，你的应用都会重新加载。

为生产环境构建你的应用

1. 启用 USB 调试

大多数 Android 设备默认只能安装和运行从 Google Play 下载的应用。你需要在设备上启用 USB 调试才能在开发期间安装你的应用。

2. 通过 USB 连接你的设备

现在让我们设置一个 Android 设备来运行我们的 React Native 项目。继续并通过 USB 将你的设备插入开发机器。

接下来，通过使用 lsusb 检查制造商代码（在 mac 上，你必须首先安装 lsusb）。lsusb 应该输出如下内容：

$ lsusb
Bus 002 Device 002: ID 8087:0024 Intel Corp. Integrated Rate Matching Hub
Bus 002 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 001 Device 003: ID 22b8:2e76 Motorola PCS
Bus 001 Device 002: ID 8087:0024 Intel Corp. Integrated Rate Matching Hub
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 004 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
Bus 003 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

这些行代表当前连接到你的机器的 USB 设备。

你需要找到代表你手机的那一行。如果有疑问，尝试拔掉手机并再次运行命令：

$ lsusb
Bus 002 Device 002: ID 8087:0024 Intel Corp. Integrated Rate Matching Hub
Bus 002 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 001 Device 002: ID 8087:0024 Intel Corp. Integrated Rate Matching Hub
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 004 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
Bus 003 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

你会看到拔掉手机后，具有手机型号的行（本例中为 "Motorola PCS"）从列表中消失了。这就是我们关心的行。

Bus 001 Device 003: ID 22b8:2e76 Motorola PCS

从上面的行中，你需要获取设备 ID 的前四位数字：

22b8:2e76

在本例中，它是 22b8。这是 Motorola 的标识符。

你需要将其输入到你的 udev 规则中才能正常运行：

echo 'SUBSYSTEM=="usb", ATTR{idVendor}=="22b8", MODE="0666", GROUP="plugdev"' | sudo tee /etc/udev/rules.d/51-android-usb.rules

确保你将 22b8 替换为上述命令中获得的标识符。

现在通过运行 adb devices 检查你的设备是否正确连接到 ADB（Android Debug Bridge）。

$ adb devices
List of devices attached
emulator-5554 offline   # Google 模拟器
14ed2fcc device         # 物理设备

在右列看到 device 意味着设备已连接。你必须一次只连接一个设备。

3. 运行你的应用

从项目的根目录，在命令提示符中输入以下内容以在设备上安装并启动你的应用：

npm
Yarn

npm run android

yarn android

如果你收到 "bridge configuration isn't available" 错误，请参阅使用 adb reverse。

提示：你也可以使用 React Native CLI 生成并运行 release 构建（例如，从项目根目录：yarn android --mode release）。

连接到开发服务器

你还可以通过连接到开发机器上运行的开发服务器在设备上快速迭代。根据你是否可以使用 USB 电缆或 Wi-Fi 网络，有几种方法可以实现这一点。

方法 1：使用 adb reverse（推荐）

如果你的设备运行的是 Android 5.0 (Lollipop) 或更高版本，已启用 USB 调试，并且通过 USB 连接到开发机器，则可以使用此方法。

在命令提示符中运行以下命令：

$ adb -s <device name> reverse tcp:8081 tcp:8081

要查找设备名称，运行以下 adb 命令：

$ adb devices

你现在可以从开发菜单启用快速刷新。每当你的 JavaScript 代码发生更改时，你的应用都会重新加载。

方法 2：通过 Wi-Fi 连接

打开终端并输入 /sbin/ifconfig 以查找机器的 IP 地址。

确保你的笔记本电脑和手机在 同一个 Wi-Fi 网络上。
在设备上打开你的 React Native 应用。
你会看到一个带有错误的红色屏幕。这是正常的。以下步骤将修复它。
打开应用内的开发菜单。
进入 开发设置 → 设备的调试服务器主机和端口。
输入你的机器 IP 地址和本地开发服务器的端口（例如 10.0.1.1:8081）。
返回 开发菜单 并选择 重新加载 JS。

你现在可以从开发菜单启用快速刷新。每当你的 JavaScript 代码发生更改时，你的应用都会重新加载。

为生产环境构建你的应用

你已经使用 React Native 构建了一个很棒的应用，现在迫不及待地想要将其发布到 Play Store。该过程与任何其他原生 Android 应用相同，但有一些额外的注意事项需要考虑。请参阅生成签名的 APK 指南以了解更多。

在 iOS 设备上运行你的应用

开发操作系统

macOS
Windows
Linux

1. 通过 USB 连接你的设备

使用 USB 转 Lightning 或 USB-C 线缆将你的 iOS 设备连接到 Mac。导航到项目中的 ios 文件夹，然后在其中使用 Xcode 打开 .xcodeproj 文件，或者如果你使用的是 CocoaPods 则打开 .xcworkspace。

如果这是你第一次在 iOS 设备上运行应用，你可能需要注册你的设备以进行开发。从 Xcode 菜单栏打开产品菜单，然后转到目标。在列表中查找并选择你的设备。Xcode 随后将注册你的设备以进行开发。

2. 配置代码签名

如果你还没有 Apple Developer 账户，请注册一个。

在 Xcode 项目导航器中选择你的项目，然后选择你的主目标（它应该与你的项目名称相同）。查找“通用”标签页。转到“签名”并确保你的 Apple Developer 账户或团队在团队下拉菜单中被选中。对测试目标也执行相同的操作（它以 Tests 结尾，位于你的主目标下方）。

对项目中的 Tests 目标重复此步骤。

3. 构建并运行你的应用

如果一切设置正确，你的设备将列为 Xcode 工具栏中的构建目标，并且它也会出现在设备面板中 (Shift ⇧ + Cmd ⌘ + 2)。你现在可以按下 构建并运行 按钮 (Cmd ⌘ + R) 或从产品菜单中选择运行。你的应用将很快在你的设备上启动。

如果遇到任何问题，请查看 Apple 的在设备上启动你的应用文档。

连接到开发服务器

你也可以使用开发服务器在设备上快速迭代。你只需要与计算机处于同一个 Wi-Fi 网络即可。摇动你的设备以打开开发菜单，然后启用 Fast Refresh。每当你的 JavaScript 代码发生更改时，你的应用都将重新加载。

故障排除

如果遇到任何问题，请确保你的 Mac 和设备处于同一个网络上并且可以互相访问。许多带有强制门户的开放无线网络配置为防止设备访问网络上的其他设备。在这种情况下，你可以使用设备的个人热点功能。你还可以通过 USB 将你的互联网 (Wi-Fi/以太网) 连接从 Mac 共享到你的设备，并通过此隧道连接到 bundler 以获得非常高的传输速度。

尝试连接开发服务器时，你可能会得到一个带有错误的红屏，显示：

连接到 http://localhost:8081/debugger-proxy?role=client 超时。你是否运行了 node 代理？如果你在设备上运行，请检查 RCTWebSocketExecutor.m 中是否有正确的 IP 地址。

要解决此问题，请检查以下几点。

1. Wi-Fi 网络。

确保你的笔记本电脑和手机在 同一个 Wi-Fi 网络上。

2. IP 地址

确保构建脚本正确检测到了你机器的 IP 地址（例如 10.0.1.123）。

打开 报告导航器 标签，选择最近的构建并搜索 IP= 后跟一个 IP 地址。嵌入到应用中的 IP 地址应与你机器的 IP 地址匹配。

为生产环境构建你的应用

你已经使用 React Native 构建了一个很棒的应用，现在迫不及待地想要将其发布到 App Store。该过程与任何其他原生 iOS 应用相同，但有一些额外的注意事项需要考虑。请参阅发布到 Apple App Store 指南以了解更多。

需要 Mac 才能为 iOS 设备构建你的应用。或者，你可以参考我们的环境设置指南了解如何使用 Expo CLI 构建你的应用，这将允许你使用 Expo 客户端应用运行你的应用。

在 Android 设备上运行你的应用​

开发操作系统​

1. 启用 USB 调试​

2. 通过 USB 连接你的设备​

3. 运行你的应用​

连接到开发服务器

方法 1：使用 adb reverse（推荐）​

方法 2：通过 Wi-Fi 连接​

为生产环境构建你的应用​

1. 启用 USB 调试​

2. 通过 USB 连接你的设备​

3. 运行你的应用​

连接到开发服务器

方法 1：使用 adb reverse（推荐）​

方法 2：通过 Wi-Fi 连接​

为生产环境构建你的应用​

1. 启用 USB 调试​

2. 通过 USB 连接你的设备​

3. 运行你的应用​

连接到开发服务器

方法 1：使用 adb reverse（推荐）​

方法 2：通过 Wi-Fi 连接​

为生产环境构建你的应用​

在 iOS 设备上运行你的应用​

开发操作系统​

1. 通过 USB 连接你的设备​

2. 配置代码签名​

3. 构建并运行你的应用​

连接到开发服务器

故障排除​

1. Wi-Fi 网络。​

2. IP 地址​

为生产环境构建你的应用​

在 Android 设备上运行你的应用

开发操作系统

1. 启用 USB 调试

2. 通过 USB 连接你的设备

3. 运行你的应用

方法 1：使用 adb reverse（推荐）

方法 2：通过 Wi-Fi 连接

为生产环境构建你的应用

1. 启用 USB 调试

2. 通过 USB 连接你的设备

3. 运行你的应用

方法 1：使用 adb reverse（推荐）

方法 2：通过 Wi-Fi 连接

为生产环境构建你的应用

1. 启用 USB 调试

2. 通过 USB 连接你的设备

3. 运行你的应用

方法 1：使用 adb reverse（推荐）

方法 2：通过 Wi-Fi 连接

为生产环境构建你的应用

在 iOS 设备上运行你的应用

开发操作系统

1. 通过 USB 连接你的设备

2. 配置代码签名

3. 构建并运行你的应用

故障排除

1. Wi-Fi 网络。

2. IP 地址

为生产环境构建你的应用