跳到主内容

在设备上运行

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

信息

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

在 Android 设备上运行你的应用

开发操作系统

1. 通过 USB 启用调试

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

若要在设备上启用 USB 调试,首先需要通过前往 设置关于手机软件信息,然后连续七次点击底部的 版本号 行来启用“开发者选项”菜单。然后你可以返回 设置开发者选项 启用“USB 调试”。

2. 通过 USB 连接设备

现在让我们设置一个 Android 设备来运行我们的 React Native 项目。请将你的设备通过 USB 连接到你的开发机器。

接下来,使用 `lsusb` 检查制造商代码(在 Mac 上,你必须首先安装 lsusb)。`lsusb` 应该输出类似这样的内容

bash
$ 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 设备。

你想要表示你手机的那一行。如果你有疑问,请尝试拔下手机并再次运行命令

bash
$ 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`。这是摩托罗拉的标识符。

你需要将其输入到你的 udev 规则中,以便启动和运行

shell
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 调试桥)。

shell
$ adb devices
List of devices attached
emulator-5554 offline # Google emulator
14ed2fcc device # Physical device

在右侧列看到 `device` 表示设备已连接。你必须一次只连接一个设备

3. 运行你的应用

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

shell
npm run android

如果你收到“bridge configuration isn't available”错误,请参阅使用 adb reverse

提示:你还可以使用 `React Native CLI` 生成并运行 `release` 版本(例如,在项目根目录运行:`yarn android --mode release`)。

连接到开发服务器

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

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

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

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

要查找设备名称,请运行以下 adb 命令

shell
$ adb devices

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

方法 2:通过 Wi-Fi 连接

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

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

  1. 确保你的笔记本电脑和手机连接到同一个 Wi-Fi 网络。
  2. 在你的设备上打开 React Native 应用。
  3. 你会看到一个带有错误的红屏。这没关系。以下步骤将修复它。
  4. 打开应用内开发菜单
  5. 前往 开发设置设备调试服务器主机和端口
  6. 输入你的机器的 IP 地址和本地开发服务器的端口(例如 `10.0.1.1:8081`)。
  7. 返回 开发菜单 并选择 重新加载 JS

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

为生产环境构建你的应用

你已经使用 React Native 构建了一个很棒的应用,现在你迫不及待地想在 Play 商店发布它。这个过程与任何其他原生 Android 应用相同,但需要考虑一些额外因素。请遵循生成签名 APK 的指南以了解更多信息。