概要
概要セクション使用 @capgo/capacitor-background-task あなたの Capacitor アプリが、定期的なバックグラウンドフェッチ作業、例えば同期、キャッシュの更新、インボックスのポーリング、分析のフラッシング、または軽量なメンテナンスジョブが必要な場合に使用してください。
プラグインは、名前付きタスク、永続的な登録、ステータスチェック、アンレジストリング、開発用トリガー、iOSの有効期限イベントなど、実用的な機能セットを実装しています。
Core Capabilities
Core CapabilitiesdefineTaskJavaScriptタスクの登録registerTaskAsyncJavaScriptタスクの登録とスケジュールunregisterTaskAsync1つのタスクの実行をキャンセルisTaskRegisteredAsyncタスクが登録されているかどうかを確認getRegisteredTasksAsync現在登録されているタスク名を表示getPendingTaskRunsAsyncJavaScriptが利用可能になる前に記録されたネイティブタスクイベントを表示getStatusAsyncネイティブバックグラウンドタスクの利用可能性を確認triggerTaskWorkerForTestingAsync開発中の時点で登録されたタスクを即時実行addExpirationListeneriOSの有効期限切れコールバックを処理define,schedule,cancel,statusAsync、finish- __CAPGO_KEEP_0__の互換性ヘルパーreact-native-background-task.
プラットフォームの動作
「プラットフォームの動作」セクションバックグラウンドタスクは正確なタイマーではありません。AndroidとiOSは、バッテリー、ネットワーク、利用状況、システムポリシーに基づいて、スケジュールされた作業を実行するタイミングを決定します。
| プラットフォーム | ネイティブスケジューラ | 重要な動作 |
|---|---|---|
| Android | WorkManager | 周期的作業には15分間の最小間隔があります。 |
| iOS | BGTaskScheduler | minimumInterval は、開始日時としては最も早い日時ですが、一定の間隔で実行されることを保証するものではありません。 |
| Web | テスト用のフォールバック | 実際のバックグラウンド スケジューラが利用できないため。 |
Public API
セクション: "Public API"| メソッド | 説明 |
|---|---|
defineTask | 名前付きタスクのためのJavaScriptコールバックを定義します。 |
registerTaskAsync | 名前付きの周期的バックグラウンドタスクを登録します。 |
unregisterTaskAsync | 将来のタスク実行をキャンセルします。 |
isTaskRegisteredAsync | タスクが登録されているかどうかを確認します。 |
getRegisteredTasksAsync | 登録されたタスク名のリスト。 |
getPendingTaskRunsAsync | 待ち行きのネイティブタスクイベントのリスト。 |
getStatusAsync | ネイティブバックグラウンドスケジューリングが利用可能かどうかを返します。 |
triggerTaskWorkerForTestingAsync | 開発とQAのために登録されたタスクをトリガーします。 |
addExpirationListener | iOSの有効期限切れイベントをリスンします。 |
真実の源
「真実の源」というセクションこのリファレンスは src/definitions.ts の capacitor-バックグラウンドタスク.
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":"ページを編集する"}]}