指南
How to use Capacitor in Capacitor
使用 @capgo/capacitor-live-reload
Capacitor 插件用于从远程 Vite 开发服务器实时重载 Capacitor 应用
安装
bun add @capgo/capacitor-live-reload
bunx cap sync
bunx cap sync 将插件的本机 code 复制到本机项目中。每次升级插件后都重新运行它
导入
import { LiveReload } from '@capgo/capacitor-live-reload';
API 简介
| 方法 | 描述 |
|---|---|
configureServer |
存储用于后续连接的远程开发服务器设置 |
connect |
建立一个 WebSocket 连接,如果没有正在活动的连接 |
disconnect |
关闭当前 WebSocket 连接并禁用自动重连 |
getStatus |
当前连接状态。 |
reload |
触发 Capacitor WebView 的全局重载。 |
reloadFile |
当运行时支持时,重新加载单个文件/模块(如果不支持则进行全局重新加载)。 |
示例
configureServer()
用于后续连接的远程开发服务器设置。
import { LiveReload } from '@capgo/capacitor-live-reload';
const result = await LiveReload.configureServer({ url: 'https://example.com' });
console.log(result);
connect()
建立 WebSocket 连接 (如果尚未激活)
import { LiveReload } from '@capgo/capacitor-live-reload';
const result = await LiveReload.connect();
console.log(result);
disconnect()
关闭当前 WebSocket 连接并禁用自动重连
import { LiveReload } from '@capgo/capacitor-live-reload';
const result = await LiveReload.disconnect();
console.log(result);
getStatus()
当前连接状态。
import { LiveReload } from '@capgo/capacitor-live-reload';
const result = await LiveReload.getStatus();
console.log(result);
reload()
触发 Capacitor WebView 的全局重载。
import { LiveReload } from '@capgo/capacitor-live-reload';
await LiveReload.reload();
reloadFile()
当运行时支持时,重新加载单个文件/模块(如果不支持则进行全局重新加载)。
import { LiveReload } from '@capgo/capacitor-live-reload';
await LiveReload.reloadFile({ path: 'path/to/file' });
监听事件
addListener 返回句柄,调用 handle.remove() 当屏幕卸载时,或者 LiveReload.removeAllListeners() 清除所有监听器。
完整参考
继续使用@capgo/capacitor-live-reload
继续使用 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-live-reload 使用@capgo/capacitor-live-reload 使用 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-live-reload @capgo/capacitor-live-reload @capgo/capacitor-live-reload 开始使用 为开始使用的实现细节 Capgo 插件目录 为Capgo 插件目录中的产品工作流程 Capacitor 由 Capgo 提供的插件 为Capacitor 由 Capgo 提供的插件的实现细节 添加或更新插件 为添加或更新插件的实现细节