@capgo/capacitor-background-task

Ikhtisar

Tentukan scope task modul, jadwal interval, dan kembalikan hasil yang dipahami OS untuk sinkronisasi dan cache warming.

Dukungan platform

Platform	Dukungan	Catatan
iOS	Ya	Identifier BGTaskScheduler di Info.plist
Android	Ya	Job bergaya WorkManager
Web	Tidak	Gunakan service workers

Kemampuan Utama

• defineTask - Daftarkan callback JavaScript untuk task bernama.
• registerTaskAsync - Simpan dan jadwalkan task periodik.
• unregisterTaskAsync - Batalkan eksekusi mendatang untuk satu task.
• isTaskRegisteredAsync - Cek apakah sebuah task sudah terdaftar.
• getRegisteredTasksAsync - Tampilkan nama task yang sedang terdaftar.
• getPendingTaskRunsAsync - Periksa event task native yang tercatat sebelum JavaScript siap.
• getStatusAsync - Cek ketersediaan native background task.
• triggerTaskWorkerForTestingAsync - Jalankan task terdaftar langsung saat development.
• addExpirationListener - Menangani callback ekspirasi iOS.
• define, schedule, cancel, statusAsync, dan finish - Helper kompatibilitas untuk react-native-background-task.

Perilaku Platform

Background task bukanlah timer yang presisi. Android dan iOS menentukan kapan menjalankan tugas terjadwal berdasarkan baterai, jaringan, penggunaan aplikasi, dan kebijakan sistem.

Platform	Penjadwal Native	Perilaku penting
Android	WorkManager	Periodic work memiliki interval minimum 15 menit.
iOS	BGTaskScheduler	minimumInterval adalah tanggal mulai paling awal, bukan jadwal yang dijamin.
Web	Fallback khusus testing	Tidak ada background scheduler asli yang tersedia.

API Publik

Metode	Deskripsi
defineTask	Menentukan callback JavaScript untuk task bernama.
registerTaskAsync	Mendaftarkan periodic background task bernama.
unregisterTaskAsync	Membatalkan eksekusi task mendatang.
isTaskRegisteredAsync	Mengembalikan apakah task terdaftar.
getRegisteredTasksAsync	Menampilkan daftar nama task yang terdaftar.
getPendingTaskRunsAsync	Menampilkan daftar native task event yang menunggu diselesaikan.
getStatusAsync	Mengembalikan apakah native background scheduling tersedia.
triggerTaskWorkerForTestingAsync	Memicu task yang terdaftar untuk development dan QA.
addExpirationListener	Mendengarkan event expiration iOS.

Sumber Kebenaran

Referensi ini disinkronkan dari src/definitions.ts di capacitor-background-task.

Lanjutkan dari @capgo/capacitor-background-task

Jika Anda menggunakan @capgo/capacitor-background-task untuk merencanakan pekerjaan plugin native, hubungkan dengan Menggunakan @capgo/capacitor-background-task untuk kapabilitas native di Menggunakan @capgo/capacitor-background-task, Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin Capacitor oleh Capgo untuk detail implementasi pada Capacitor Plugins oleh Capgo Menambahkan atau Memperbarui Plugin untuk detail implementasi di Menambahkan atau Memperbarui Plugin, dan Alternatif Plugin Ionic Enterprise untuk alur kerja produk dalam Alternatif Plugin Ionic Enterprise.