Capacitor Background Runner中自定义数据共享与事件通信问题

我正在使用Capacitor 5.4和Svelte 3.49开发应用，功能是基于远程API发送通知：定期调用接口，根据API返回的最新活动计算LocalNotification的调度时间，同时给用户展示倒计时。前台逻辑运行正常，关闭电池优化后，Android模拟器和真机上的通知都能按时触发。

但后台/息屏状态下，已调度的通知能正常触发，但如果用户不再打开应用，就无法生成新的调度通知。所以我打算用带内置间隔的Capacitor Background Runner来调用API并调度下一条通知，目前已经完成如下配置：

capacitor.config.json 配置 #

"plugins": {
    ...
    "BackgroundRunner": {
      "label": "com.myproject.background.task",
      "src": "background.js",
      "event": "myCustomEvent",
      "repeat": true,
      "interval": 5,
      "autoStart": true
    },
    ...
  }

public/background.js 代码 #

addEventListener('myCustomEvent', (resolve, reject, args) => {
    CapacitorNotifications.schedule([
        {
            id: 100,
            title: 'myCustomEvent public',
            body: 'New scheduling available',
            scheduleAt: new Date(Date.now() + 10000),
        },
    ]);
    resolve();
});

interval的精度虽然不够，但周期性运行的需求已经满足。不过这里受API限制，没法直接导入异步计算方法，需要重写逻辑、携带变量请求接口，再通过CapacitorNotifications.schedule调度新通知。

我的问题如下：

1. 能不能从background.js向App.svelte派发事件，让App.svelte里的异步函数重新计算通知调度？（已经试过dispatchEvent但没成功）
2. 应用和background.js之间能不能共享数据？我需要把"username"变量传给接口，所以得在background.js里访问这个变量。（知道有CapacitorKV，但不清楚怎么用）

问题解答 #

1. 从Background Runner向前台Svelte应用派发事件

Capacitor的Background Runner运行在独立上下文，直接使用dispatchEvent无法与前台Svelte应用通信，需要借助Capacitor的App插件事件系统实现：

• 在background.js中发送自定义原生事件：

addEventListener('myCustomEvent', async (resolve, reject, args) => {
    // 执行现有通知调度逻辑
    await CapacitorNotifications.schedule([/* 通知配置 */]);
    // 发送事件到前台应用
    await Capacitor.App.fireNativeEvent('background-update', {
        trigger: 'recalculate-schedule'
    });
    resolve();
});

• 在App.svelte中监听该事件：

<script>
    import { App } from '@capacitor/app';
    let unsubscribeListener;

    onMount(async () => {
        // 监听来自Background Runner的事件
        unsubscribeListener = await App.addListener('background-update', async () => {
            // 执行异步计算通知调度的逻辑
            await recalculateNotificationSchedule();
        });
    });

    onDestroy(() => {
        // 组件销毁时取消监听
        unsubscribeListener?.();
    });

    async function recalculateNotificationSchedule() {
        // 你的通知调度计算逻辑
    }
</script>

注意：只有应用处于前台或后台活跃状态时，前台监听才能收到事件；若应用完全被杀死，前台监听不会触发，此时仍需在Background Runner内直接处理逻辑。

2. 用Capacitor KV实现跨上下文数据共享

Capacitor KV是官方提供的跨上下文（前台、Background Runner、原生插件）键值存储工具，使用步骤如下：

• 安装依赖：

npm install @capacitor/kv
npx cap sync

• 在前台Svelte应用中存储username：

<script>
    import { KV } from '@capacitor/kv';

    async function saveUserInfo(username) {
        // 存储字符串类型的username
        await KV.set('username', username);
        // 若需存储对象，先序列化：await KV.set('user', JSON.stringify({username, id}));
    }
</script>

• 在background.js中读取username：

addEventListener('myCustomEvent', async (resolve, reject, args) => {
    // 读取存储的username
    const { value: username } = await CapacitorKV.get('username');
    if (username) {
        // 携带username请求API
        const apiResponse = await fetch(`https://your-api-domain.com/activities?user=${username}`);
        const activityData = await apiResponse.json();
        // 根据API数据计算调度时间并创建通知
        const targetTime = calculateScheduleTime(activityData);
        await CapacitorNotifications.schedule([{
            id: Date.now(), // 用时间戳确保通知ID唯一
            title: '新活动提醒',
            body: '检测到新的活动，请注意查看',
            scheduleAt: targetTime
        }]);
    }
    resolve();
});

注意：KV默认存储字符串，若需存取复杂对象，需用JSON.stringify和JSON.parse做序列化/反序列化处理。

内容的提问来源于stack exchange，提问作者Ben K.