__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.
基本機能
「基本機能」のセクション
CapacitordefineTask- 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 | テスト用のフォールバック | 実際のバックグラウンド スケジューラは利用できません。 |
パブリック API
API というタイトルのセクション| メソッド | 説明 |
|---|---|
defineTask | 名前付きタスクのためのJavaScriptコールバックを定義します。 |
registerTaskAsync | 名前付きの周期的バックグラウンドタスクを登録します。 |
unregisterTaskAsync | 将来のタスク実行をキャンセルします。 |
isTaskRegisteredAsync | タスクが登録されているかどうかを確認します。 |
getRegisteredTasksAsync | 登録されたタスク名をリストします。 |
getPendingTaskRunsAsync | ネイティブタスクイベントをリストします。 |
getStatusAsync | nativeバックグラウンドスケジュールが利用可能であるかどうかを返します。 |
triggerTaskWorkerForTestingAsync | 開発とQAで登録されたタスクをトリガーします。 |
addExpirationListener | iOSの有効期限切れイベントをリスンします。 |
ソースオブトゥルース
ソースオブトゥルースセクションこのリファレンスは src/definitions.ts から capacitor-バックグラウンドタスク.
@capgo/capacitor-バックグラウンドタスクから続きます
@capgo/capacitor-バックグラウンドタスクから続きますセクション__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-バックグラウンドタスクを使用している場合 @capgo/capacitor-バックグラウンドタスク native プラグインの作業を計画するには、を接続する必要があります。 @capgo/capacitor-background-taskを使用します。 @capgo/capacitor-background-taskのnative機能のために、 Capgo プラグイン ディレクトリ Capgo プラグイン ディレクトリの製品ワークフローについては、 Capacitor プラグインをCapgoで Capacitor プラグインをCapgoで実装する詳細については、 プラグインの追加または更新 プラグインの追加または更新の実装詳細については、 Ionic Enterprise プラグインの代替 Ionic Enterprise プラグインの代替の製品ワークフローについては。