@capgo/capacitor-background-task

iOSおよびAndroidでの定期的なバックグラウンドフェッチタスク。

概要

モジュールスコープのタスクを定義し、間隔をスケジュールして、同期とキャッシュウォームアップ用にOSが理解できる結果を返します。

プラットフォーム	サポート	備考
iOSと	はい	Info.plist の BGTaskScheduler identifier
Androidでは	はい	WorkManager スタイルのジョブ
Web	いいえ	Service Worker を使用

defineTask - 名前付きタスクの JavaScript コールバックを登録します。
registerTaskAsync - 定期タスクを永続化してスケジュールします。
unregisterTaskAsync - 1 つのタスクの将来の実行をキャンセルします。
isTaskRegisteredAsync - タスクが登録されているか確認します。
getRegisteredTasksAsync - 現在登録されているタスク名の一覧を取得します。
getPendingTaskRunsAsync - JavaScript が準備完了になる前に記録されたネイティブタスクイベントを調査します。
getStatusAsync - ネイティブバックグラウンドタスクの可用性を確認します。
triggerTaskWorkerForTestingAsync - 開発中に登録されたタスクを即座に実行します。
addExpirationListener - iOS の期限切れコールバックを処理します。
define, schedule, cancel, statusAsyncや finish - 互換性ヘルパー react-native-background-task.

バックグラウンドタスクは正確なタイマーではありません。Android と iOS は、バッテリー、ネットワーク、アプリの使用状況、システムポリシーに基づいて、スケジュールされたタスクの実行タイミングを決定します。

プラットフォーム	ネイティブスケジューラー	重要な動作
Androidでは	WorkManager	定期タスクの最小間隔は 15 分です。
iOSと	BGTaskScheduler	`minimumInterval` は、保証された頻度ではなく、開始可能な最も早い日付です。
Web	テスト用のフォールバック	実際のバックグラウンドスケジューラは利用できません。

メソッド	説明
`defineTask`	名前付きタスクの JavaScript コールバックを定義します。
`registerTaskAsync`	名前付きの定期バックグラウンドタスクを登録します。
`unregisterTaskAsync`	今後のタスク実行をキャンセルします。
`isTaskRegisteredAsync`	タスクが登録されているかどうかを返します。
`getRegisteredTasksAsync`	登録済みのタスク名を一覧表示します。
`getPendingTaskRunsAsync`	完了待ちのネイティブタスクイベントを一覧表示します。
`getStatusAsync`	ネイティブのバックグラウンドスケジューリングが利用可能か返します。
`triggerTaskWorkerForTestingAsync`	開発とQA用に登録済みタスクをトリガーします。
`addExpirationListener`	iOSの期限切れイベントをリッスンします。

このリファレンスは以下から同期されています： src/definitions.ts における capacitor-background-task.

使用している場合 @capgo/capacitor-background-task ネイティブプラグインの作業を計画するには、次と連携してください： @capgo/capacitor-background-task の使い方「Using @capgo/capacitor-background-task」のネイティブ機能については、 Capgo プラグインディレクトリ Capgo プラグインディレクトリのプロダクトワークフローについては、 Capgo による Capacitor プラグイン Capgo による Capacitor プラグインの実装詳細については、プラグインの追加または更新プラグインの追加または更新における実装詳細については、および Ionic Enterprise プラグインの代替案 Ionic Enterprise プラグインの代替案におけるプロダクトワークフローについては。