实时重载(Live Reload)
Live Reload功能对于调试应用的网页端和在真机/模拟器上的原生功能非常有用。它会在检测到代码变更时自动刷新浏览器(或Web视图),而无需每次修改代码都重新部署原生二进制包。
若在真机上运行,请确保设备与电脑处于同一Wi-Fi网络。
与Ionic CLI配合使用
Ionic CLI提供完整的Live Reload体验,自动处理下文手动操作的所有步骤。请先安装CLI和native-run
(一个跨平台命令行工具,用于在设备和模拟器上运行原生应用):
npm install -g @ionic/cli native-run
接着使用ionic cap run
命令启动Live Reload:
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
命令,在en0
条目下的inet
后查找IP地址。或通过系统偏好设置 -> 网络 -> (选择活动网络) 在状态栏查看IP - Windows系统:运行
ipconfig
命令,查找IPv4
地址
接着启动本地开发服务器。服务器必须绑定到0.0.0.0
才能被局域网访问,启动命令因框架而异, 通常为:
npm run start
使用react-scripts时,请使用
HOST=0.0.0.0 npm run start
在capacitor.config.json
中创建server
配置项,并使用本地服务器的IP地址和端口配置url
字段:
"server": {
"url": "http://192.168.1.68:8100",
"cleartext": true
},
然后运行npx cap copy
将更新的配置同步到所有原生项目。
如果IDE尚未打开,执行以下命令:
npx cap open ios
npx cap open android
最后点击运行按钮启动应用,即可开始使用Live Reload功能。
注意不要将server配置提交到版本控制系统。