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

概要

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

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

Core Capabilities

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

プラットフォームの動作

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

プラットフォーム	ネイティブのスケジューラ	重要な動作
Android	WorkManager	パーショナルワークの最小間隔は15分です。
iOS	BGTaskScheduler	minimumInterval は開始日であり、確実なスケジュールではない。
Web	テスト用のフォールバック	実際のバックグラウンド スケジューラは利用できない。

パブリック API

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

真実の源

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

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

Capgoを使用している場合 @capgo/capacitor-background-task Capgoを使用してネイティブプラグインの作業を計画するには、Capgoを使用してネイティブプラグインの作業を計画する Using @capgo/capacitor-background-task for the native capability in Using @capgo/capacitor-background-task, Capgo プラグインディレクトリを使用して製品ワークフローを使用する Capgo プラグイン 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 プラグインの代替製品ワークフローについてです。"},{"text":"編集ページ"}]}