__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 CapabilitiesdefineTask- __CAPGO_KEEP_0__registerTaskAsync- __CAPGO_KEEP_0__を登録します。unregisterTaskAsync- __CAPGO_KEEP_0__を保存し、定期実行を設定します。isTaskRegisteredAsync- __CAPGO_KEEP_0__の実行をキャンセルします。getRegisteredTasksAsync- __CAPGO_KEEP_0__が登録されているかどうかを確認します。getPendingTaskRunsAsync- __CAPGO_KEEP_0__の名前を現在登録されているものをリストします。getStatusAsync- JavaScriptが利用可能になる前に記録されたネイティブタスクイベントを検査します。triggerTaskWorkerForTestingAsync- ネイティブバックグラウンドタスクの利用可能性を確認します。addExpirationListener- 開発中のときに登録されたタスクを即時実行します。define,schedule,cancel,statusAsync- iOSの有効期限切れコールバックを処理します。finish- __CAPGO_KEEP_0__の互換性をサポートするヘルパーreact-native-background-task.
- __CAPGO_KEEP_0__の動作
プラットフォームの動作バックグラウンドタスクは正確なタイマーではありません。AndroidとiOSはバッテリー、ネットワーク、アプリの使用状況、システムポリシーに基づいてスケジュールされたワークを実行するタイミングを決定します。
| プラットフォーム | ネイティブのスケジューラ | 重要な動作 |
|---|---|---|
| Android | WorkManager | 定期的なワークには15分間隔の最小間隔があります。 |
| iOS | BGTaskScheduler | minimumInterval は最も早い開始日であり、確実なカドランスではありません。 |
| Web | テスト用のフォールバック | 実際のバックグラウンド スケジューラが利用できない。 |
パブリック API
「パブリック API」というタイトルのセクション| メソッド | 説明 |
|---|---|
defineTask | 名前付きタスクのためのJavaScriptコールバックを定義します。 |
registerTaskAsync | 名前付きの周期的バックグラウンドタスクを登録します。 |
unregisterTaskAsync | 将来のタスク実行をキャンセルします。 |
isTaskRegisteredAsync | タスクが登録されているかどうかを確認します。 |
getRegisteredTasksAsync | 登録されたタスク名の一覧を表示します。 |
getPendingTaskRunsAsync | 完了待ちのネイティブタスクイベントの一覧を表示します。 |
getStatusAsync | ネイティブのバックグラウンド スケジュールが利用可能かどうかを返します。 |
triggerTaskWorkerForTestingAsync | 開発とQAで登録されたタスクをトリガーします。 |
addExpirationListener | iOSの有効期限切れイベントをリスンします。 |
ソース オブ トゥルース
「ソース オブ トゥルース」というセクション__CAPGO_KEEP_0__から同步されたこのリファレンスは src/definitions.ts で capacitor-バックグラウンド タスク.
capgo/capacitor-バックグラウンド タスクから続けて
「capgo/capacitor-バックグラウンド タスクから続けて」というセクション__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-バックグラウンド タスクを使用している場合 capgo/capacitor-バックグラウンド タスク ネイティブ プラグインの作業を計画するには、接続する Using @capgo/capacitor-background-task ネイティブ機能のために Using @capgo/capacitor-background-task を使用する Capgo プラグイン ディレクトリ Capgo プラグイン ディレクトリの製品ワークフロー Capacitor プラグインの Capgo Capacitor プラグインの Capgo の実装詳細 プラグインの追加または更新 プラグインの追加または更新の実装詳細 Ionic Enterprise プラグインの代替 Ionic Enterprise プラグインの代替の製品ワークフロー