跳到主要内容
版本:v7

实时重载

实时重载功能对于调试应用的网页部分以及设备硬件或模拟器上的原生功能都非常有用。它会在检测到应用代码变更时重新加载浏览器(或Web视图),而无需每次修改代码后都重新部署原生二进制包。

如果在真实设备上运行,请确保设备与电脑连接至同一Wi-Fi网络。

配合Ionic CLI使用

Ionic CLI提供了完整的实时重载体验,自动完成了下文手动操作的所有步骤。请先安装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构建、将网页资源复制到指定原生平台中,然后打开对应原生项目的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

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

注意不要将服务器配置提交到源代码版本控制中。