跳到主要内容
版本:v7

实时重载

实时重载对于调试应用的 Web 部分以及设备硬件或模拟器上的原生功能都很有用。它不需要每次更改代码时都部署新的原生二进制文件,而是在检测到应用中的更改时重新加载浏览器(或 Web View)。

如果在设备上运行,请确保它与你的计算机连接到同一个 Wi-Fi 网络。

与 Ionic CLI 一起使用

Ionic CLI 包含完整的实时重载体验,自动执行下面详细说明的所有步骤。将其与 native-run(一个用于在设备和模拟器上运行原生二进制文件的跨平台命令行工具)一起安装:

npm install -g @ionic/cli native-run

接下来,使用 ionic cap run 命令启动实时重载过程:

ionic cap run android -l --external
ionic cap run ios -l --external

这将执行 ionic build,将 Web 资产复制到指定的原生平台,然后为你的原生项目打开 IDE(iOS 使用 Xcode,Android 使用 Android Studio)。

capacitor.config.json 中自动创建的 server 条目会在命令终止后被移除。有关 ionic cap run 命令的完整详情,请参见此处

与框架 CLI 一起使用

Capacitor 支持具有实时重载功能的 CLI。

首先,确定你的计算机在局域网上的 IP 地址。

  • 在 macOS 上,运行 ifconfig。IP 地址列在 en0 条目下,inet 之后。或者,打开系统偏好设置 -> 网络 ->(选择活动网络),然后在状态下方找到列出的 IP。
  • 在 Windows 上,运行 ipconfig。查找 IPv4 地址。

接下来,启动你的本地 Web 服务器。服务器必须绑定到 0.0.0.0 才能从局域网访问。运行的命令会有所不同,但通常是:

npm run start

使用 react-scripts 时,使用 HOST=0.0.0.0 npm run start

capacitor.config.json 中,创建一个 server 条目,然后使用本地 Web 服务器的 IP 地址和端口配置 url 字段:

"server": {
"url": "http://192.168.1.68:8100",
"cleartext": true
},

接下来,运行 npx cap copy 以将更新的 Capacitor 配置复制到所有原生项目中。

如果原生 IDE 尚未打开,请打开它:

npx cap open ios
npx cap open android

最后,点击 Run 按钮启动应用并开始使用实时重载。

注意不要将服务器配置提交到源代码管理。

除了在 capacitor.config.json 中设置 url 之外,你还可以在从命令行运行应用时直接从 CLI 设置实时重载 URL:

npx cap run --live-reload --port 8100