跳到主要内容

在设备上运行

在向用户发布应用之前,最好先在实际设备上测试您的应用。本文档将指导您完成在设备上运行 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”)的那一行消失了。这就是我们关心的那一行。

总线 001 设备 003:ID 22b8:2e76 摩托罗拉 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 的指南了解更多信息。