__CAPGO_KEEP_0__アプリが定期的なバックグラウンドフェッチワークが必要な場合に使用します。例えば、sync、キャッシュの更新、インボックスのポーリング、分析のフラッシュ、軽量なメンテナンスジョブなど。 @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.
主な機能
セクションのタイトルは “主な機能”
使用する場合defineTask- JavaScript callback を指定されたタスク名で登録します。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 | テスト用のフォールバック | 実際のバックグラウンド スケジューラが利用できない。 |
パブリック API
セクション「パブリック API」| メソッド | 説明 |
|---|---|
defineTask | 名前付きタスクのJavaScriptコールバックを定義します。 |
registerTaskAsync | 名前付きの周期的バックグラウンド タスクを登録します。 |
unregisterTaskAsync | 将来のタスク実行をキャンセルします。 |
isTaskRegisteredAsync | タスクが登録されているかどうかを確認します。 |
getRegisteredTasksAsync | 登録されたタスク名をリストします。 |
getPendingTaskRunsAsync | 実行待ちのネイティブタスクイベントをリストします。 |
getStatusAsync | ネイティブのバックグラウンド スケジュールが利用可能かどうかを返します。 |
triggerTaskWorkerForTestingAsync | 開発とQAで登録されたタスクをトリガーします。 |
addExpirationListener | iOSの有効期限切れイベントを待ち受けます。 |
ソース オブ トゥルース
「ソース オブ トゥルース」というセクションこのリファレンスは src/definitions.ts でsyncされています。 capacitor-バックグラウンド タスクから続けて.
Keep going from @capgo/capacitor-background-task
Section titled “Keep going from @capgo/capacitor-background-task”あなたが「__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-バックグラウンド タスク」 @capgo/capacitor-background-task ネイティブ プラグインの作業を計画するには、接続する Using @capgo/capacitor-バックグラウンド タスク ネイティブ機能のために使用するUsing @capgo/capacitor-バックグラウンド タスク Capgo プラグイン ディレクトリ Capgo プラグイン ディレクトリの製品ワークフロー Capacitor プラグイン ( Capgo によって) Capacitor プラグイン ( Capgo によって) の実装詳細 プラグインの追加または更新 プラグインの追加または更新の実装詳細 Ionic Enterprise プラグインの代替 Ionic Enterprise プラグインの代替の製品ワークフロー