メイン コンテンツにスキップ

capgo/capacitor-バックグラウンドタスク

Expoスタイルの名前付きバックグラウンドタスクは、Capacitorアプリにバックアップされています。Android WorkManagerとiOS BGTaskSchedulerによってサポートされています。

使用 @capgo/capacitor-background-task あなたの Capacitor アプリが、定期的なバックグラウンドフェッチ作業、例えば同期、キャッシュの更新、インボックスのポーリング、分析のフラッシング、または軽量なメンテナンスジョブが必要な場合に使用してください。

プラグインは、名前付きタスク、永続的な登録、ステータスチェック、アンレジストリング、開発用トリガー、iOSの有効期限イベントなど、実用的な機能セットを実装しています。

Core Capabilities

Core Capabilities
  • defineTask JavaScriptタスクの登録
  • registerTaskAsync JavaScriptタスクの登録とスケジュール
  • unregisterTaskAsync 1つのタスクの実行をキャンセル
  • isTaskRegisteredAsync タスクが登録されているかどうかを確認
  • getRegisteredTasksAsync 現在登録されているタスク名を表示
  • getPendingTaskRunsAsync JavaScriptが利用可能になる前に記録されたネイティブタスクイベントを表示
  • getStatusAsync ネイティブバックグラウンドタスクの利用可能性を確認
  • triggerTaskWorkerForTestingAsync 開発中の時点で登録されたタスクを即時実行
  • addExpirationListener iOSの有効期限切れコールバックを処理
  • define, schedule, cancel, statusAsyncfinish - __CAPGO_KEEP_0__の互換性ヘルパー react-native-background-task.

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

プラットフォームネイティブスケジューラ重要な動作
AndroidWorkManager周期的作業には15分間の最小間隔があります。
iOSBGTaskSchedulerminimumInterval は、開始日時としては最も早い日時ですが、一定の間隔で実行されることを保証するものではありません。
Webテスト用のフォールバック実際のバックグラウンド スケジューラが利用できないため。
メソッド説明
defineTask名前付きタスクのためのJavaScriptコールバックを定義します。
registerTaskAsync名前付きの周期的バックグラウンドタスクを登録します。
unregisterTaskAsync将来のタスク実行をキャンセルします。
isTaskRegisteredAsyncタスクが登録されているかどうかを確認します。
getRegisteredTasksAsync登録されたタスク名のリスト。
getPendingTaskRunsAsync待ち行きのネイティブタスクイベントのリスト。
getStatusAsyncネイティブバックグラウンドスケジューリングが利用可能かどうかを返します。
triggerTaskWorkerForTestingAsync開発とQAのために登録されたタスクをトリガーします。
addExpirationListeneriOSの有効期限切れイベントをリスンします。

このリファレンスは src/definitions.tscapacitor-バックグラウンドタスク.

capgoから続きます@capacitor/capgo-バックグラウンドタスク

「capgoから続きます@capacitor/capgo-バックグラウンドタスク」というセクション

Capgoを使用している場合 @capgo/capacitor-background-task Capgoを使用してネイティブプラグインの作業を計画するには、Capgoを使用してネイティブプラグインの作業を計画する Using @capgo/capacitor-background-task for the native capability in Using @capgo/capacitor-background-task, Capgo Plugin Directory for the product workflow in Capgo Plugin Directory, Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, プラグインの追加または更新を使用して実装詳細を使用する Ionic Enterprise プラグインの代替 Capgoを使用してネイティブ機能を使用する {"targetLanguage":"Japanese","pagePath":"/ja/docs/plugins/background-task/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"Ionic Enterprise Pluginの代替品の製品ワークフローについてです。"},{"text":"ページを編集する"}]}