__CAPGO_KEEP_0__アプリが定期的にバックグラウンドでフェッチワークを実行する必要がある場合に使用します。 @capgo/capacitor-background-task when your Capacitor app needs periodic background fetch work such as sync, cache refreshes, inbox polling, analytics flushing, or lightweight maintenance jobs.
「概要」
Core Capabilities
Core CapabilitiesdefineTaskJavaScriptタスクの登録registerTaskAsyncJavaScriptタスクの定期実行unregisterTaskAsyncタスクの実行をキャンセルisTaskRegisteredAsyncタスクの登録確認getRegisteredTasksAsyncタスク名のリストgetPendingTaskRunsAsyncタスクイベントの確認getStatusAsyncバックグラウンドタスクの有効性確認triggerTaskWorkerForTestingAsync開発時タスクの即時実行addExpirationListeneriOSのタスク切断コールバックdefine,schedule,cancel,statusAsync,finish- Android と iOS 用の互換性 ヘルパー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 __CAPGO_KEEP_0__-background-task capacitor/__CAPGO_KEEP_1__-background-taskから続きます。.
「capgo/capacitor-background-taskから続きます。」というセクション
Section titled “Keep going from @capgo/capacitor-background-task”Capgoを使用している場合 @capgo/capacitor-background-taskを使用 Capgoを使用してnativeプラグインの作業を計画するには、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-background-taskを接続する Capgoを使用してnative機能を計画するには、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を使用してnativeプラグインの作業を計画するには、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-background-taskを接続する {"targetLanguage":"Japanese","pagePath":"/ja/docs/plugins/background-task/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"Ionic Enterprise プラグインの代替製品ワークフロー用に"},{"text":"ページを編集する"}]}