跳到主要内容
版本:v4

实时重载

实时重载对于调试应用的 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。

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

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

接下来,启动你的本地 Web 服务器。服务器必须绑定到 0.0.0.0 才能从 LAN 访问。要运行的命令因项目而异,但通常是:

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

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

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