使用 @capgo/capacitor-background-task あなたのCapacitorアプリが、定期的なバックグラウンドフェッチ作業、例えば同期、キャッシュの更新、インボックスのポーリング、分析のフラッシュ、または軽量なメンテナンスジョブが必要な場合に使用します。
プラグインは、Expo BackgroundTaskの実用的な機能セットを実装しています。名前付きタスク、永続的な登録、ステータスチェック、アンレジストリング、開発用のトリガー、iOSの期限切れイベントなどが含まれます。
主な機能
セクション「主な機能」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 | テスト用のフォールバック | 実際のバックグラウンド スケジューラは利用できません。 |
Public API
「Public API」というセクション| メソッド | 説明 |
|---|---|
defineTask | 名前付きタスクのJavaScriptコールバックを定義します。 |
registerTaskAsync | 名前付きの周期的バックグラウンドタスクを登録します。 |
unregisterTaskAsync | 将来のタスク実行をキャンセルします。 |
isTaskRegisteredAsync | タスクが登録されているかどうかを返します。 |
getRegisteredTasksAsync | 登録されたタスク名の一覧を表示します。 |
getPendingTaskRunsAsync | 完了待ちのネイティブタスクイベントの一覧を表示します。 |
getStatusAsync | ネイティブのバックグラウンドスケジューリングが利用可能かどうかを返します。 |
triggerTaskWorkerForTestingAsync | 開発とQA用に登録されたタスクをトリガーします。 |
addExpirationListener | iOSの期限切れイベントをリスンします。 |
真実の源
「真実の源」というセクションこのリファレンスはSyncdから src/definitions.ts で capacitor-バックグラウンドタスク.
capgoから続けてください@capgo/capacitor-バックグラウンドタスク
セクションのタイトル “capgoから続けてください@capgo/capacitor-バックグラウンドタスク”__CAPGO_KEEP_0__を使用している場合 @capgo/capacitor-バックグラウンドタスク native plugin の作業を計画するには、を接続する capgoを使用してネイティブ機能を使用する場合、@capgo/capacitor-バックグラウンドタスク Capacitorのネイティブ機能のために@capgo/capacitor-バックグラウンドタスクを使用します。 Capgo Plugin Directoryを使用して製品ワークフローを計画する場合 Capgo Plugin Directory Capacitor Capgo Capgoのプラグインの実装詳細については、CapacitorプラグインによってCapgoで実装されています。 プラグインの追加または更新 プラグインの実装詳細については、プラグインの追加または更新、 Ionic Enterprise プラグインの代替 Ionic Enterprise プラグインの製品ワークフローについて