@capgo/capacitor-background-task

Ringkasan

Gunakan @capgo/capacitor-background-task ketika aplikasi Capacitor Anda memerlukan pekerjaan fetch latar belakang berkala 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 yang dinamai, pendaftaran yang berlangsung, pengecekan status, penghapusan pendaftaran, pengaktifan pengembang, dan kejadian kadaluarsa iOS.

Kemampuan Utama

• defineTask - Daftarkan panggilan JavaScript untuk tugas bernama tertentu.
• registerTaskAsync - Simpan dan jadwalkan tugas berkala.
• unregisterTaskAsync - Batalkan pelaksanaan masa depan untuk satu tugas.
• isTaskRegisteredAsync - Periksa apakah tugas telah terdaftar.
• getRegisteredTasksAsync - Daftarkan nama-nama tugas saat ini.
• getPendingTaskRunsAsync - Inspeksi event tugas native yang direkam sebelum JavaScript siap.
• getStatusAsync - Periksa ketersediaan tugas latar belakang native.
• triggerTaskWorkerForTestingAsync - Jalankan tugas yang terdaftar 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	Jadwal Native	Tindakan penting
Android	WorkManager	Pekerjaan periodik memiliki interval minimum 15 menit.
iOS	BGTaskScheduler	minimumInterval adalah tanggal awal mulai, bukan kecepatan yang dijamin.
Web	Fallback hanya untuk pengujian	Tidak ada scheduler latar belakang nyata yang tersedia.

Publik API

Metode	Deskripsi
defineTask	Mengdefinisikan panggilan kembali JavaScript untuk sebuah tugas bernama.
registerTaskAsync	Mengdaftar tugas latar belakang periodik bernama.
unregisterTaskAsync	Membatalkan tugas berjalan di masa depan.
isTaskRegisteredAsync	Mengembalikan apakah sebuah tugas telah didaftarkan.
getRegisteredTasksAsync	Daftar nama tugas yang terdaftar.
getPendingTaskRunsAsync	Daftar event tugas native 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-background-task untuk merencanakan pekerjaan plugin native, hubungkannya dengan Menggunakan @capgo/capacitor-background-task untuk kemampuan native di Menggunakan @capgo/capacitor-background-task, 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 pada Alternatif Plugin Enterprise Ionic.