@capgo/capacitor-tugas-latar

Ringkasan

Gunakan @capgo/capacitor-background-task ketika aplikasi Capacitor Anda memerlukan pekerjaan fetch latar berulang seperti sinkronisasi, pembaruan cache, polling kotak masuk, pengosongan analitik, atau pekerjaan perawatan ringan.

Plugin ini mengikuti setelan fitur yang praktis dari Expo BackgroundTask dengan tugas bernama, pendaftaran persisten, pengecekan status, penghapusan pendaftaran, pengaktifan pengembang, dan kejadian kedaluwarsa iOS.

Kemampuan Utama

• defineTask - Daftarkan panggilan JavaScript untuk tugas bernama.
• registerTaskAsync - Simpan dan jadwalkan tugas berkala.
• unregisterTaskAsync - Batalkan jalannya masa depan untuk satu tugas.
• isTaskRegisteredAsync - Periksa apakah tugas telah didaftarkan.
• getRegisteredTasksAsync - Daftar nama tugas yang saat ini didaftarkan.
• getPendingTaskRunsAsync - Inspeksi event tugas native yang direkam sebelum JavaScript siap.
• getStatusAsync - Periksa ketersediaan tugas latar belakang native.
• triggerTaskWorkerForTestingAsync - Jalankan tugas yang didaftarkan secara langsung selama pengembangan.
• addExpirationListener - Tangani panggilan callback iOS yang telah kedaluwarsa.
• define, schedule, cancel, statusAsync, dan finish - Bantuan kompatibilitas untuk react-native-background-task.

Tindakan Platform

Tugas latar belakang bukanlah timer yang tepat. Android dan iOS menentukan kapan menjalankan pekerjaan yang dijadwalkan berdasarkan baterai, jaringan, penggunaan aplikasi, dan kebijakan sistem.

Platform	Pengaturan Native	Perilaku penting
Android	WorkManager	Pekerjaan periodik memiliki jarak minimum 15 menit.
iOS	BGTaskScheduler	minimumInterval adalah tanggal mulai terdahulu, bukan kordensi yang dijamin.
Web	Fallback hanya untuk tes	Tidak ada scheduler latar belakang nyata yang tersedia.

Publik API

Metode	Deskripsi
defineTask	Mengdefinisikan callback JavaScript untuk sebuah tugas bernama.
registerTaskAsync	Mengdaftar tugas latar belakang berulang yang bernama.
unregisterTaskAsync	Membatalkan tugas berjalan di masa depan.
isTaskRegisteredAsync	Mengembalikan apakah sebuah tugas telah didaftarkan.
getRegisteredTasksAsync	Menampilkan nama-nama tugas yang didaftarkan.
getPendingTaskRunsAsync	Menampilkan event tugas asli yang menunggu selesai.
getStatusAsync	Mengembalikan apakah jadwal latar belakang native tersedia.
triggerTaskWorkerForTestingAsync	Mengaktifkan tugas yang terdaftar untuk pengembangan dan QA.
addExpirationListener	Mendengarkan event kedaluwarsa iOS.

Sumber Kebenaran

Referensi ini disinkronkan dari src/definitions.ts di capacitor-tugas-kebelakang.

Teruskan dari @capgo/capacitor-tugas-kebelakang

Jika Anda menggunakan @capgo/capacitor-tugas-kebelakang untuk merencanakan pekerjaan plugin native, hubungkannya dengan Menggunakan @capgo/capacitor-tugas-latar-belakang untuk kemampuan native di Menggunakan @capgo/capacitor-tugas-latar-belakang, Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin-Plugin Capacitor oleh Capgo untuk detail implementasi di Plugin-Plugin Capacitor oleh Capgo, Menambahkan atau Mengupdate Plugin untuk detail implementasi di Menambahkan atau Mengupdate Plugin, dan Alternatif Plugin Enterprise Ionic untuk alur kerja produk di Alternatif Plugin Enterprise Ionic.