Ringkasan
Bagian berjudul “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 set fitur yang praktis dari Expo BackgroundTask dengan tugas yang dinamai, pendaftaran yang persisten, pengecekan status, penghapusan pendaftaran, pengaktifan pengembangan, dan kejadian kadaluarsa iOS.
Kemampuan Utama
Bagian berjudul “Kemampuan Utama”defineTask- Daftarkan panggilan JavaScript untuk sebuah tugas bernama.registerTaskAsync- Simpan dan jadwalkan tugas periodik.unregisterTaskAsync- Batalkan jalankan 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- Bantuan kompatibilitas untukfinishPenggunaan Platformreact-native-background-task.
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 pustaka asli | Pengaturan perilaku yang penting |
|---|---|---|
| Android | WorkManager | Pekerjaan periodik memiliki interval minimum 15 menit. |
| iOS | BGTaskScheduler | minimumInterval adalah tanggal mulai yang paling awal, bukan kordensi yang dijamin. |
| Web | Fallback hanya untuk pengujian | Tidak ada scheduler latar belakang nyata yang tersedia. |
Publik API
Judul bagian “Publik API”| Metode | Deskripsi |
|---|---|
defineTask | Mengdefinisikan panggilan balik 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 | Mengdaftar nama-nama tugas yang didaftarkan. |
getPendingTaskRunsAsync | Mengdaftar event-event tugas asli yang menunggu selesai. |
getStatusAsync | Mengembalikan apakah pengaturan jadwal latar belakang native tersedia. |
triggerTaskWorkerForTestingAsync | Mengaktifkan tugas yang terdaftar untuk pengembangan dan QA. |
addExpirationListener | Mendengarkan peristiwa kedaluwarsa iOS. |
Sumber Kebenaran
Judul bagian “Sumber Kebenaran”Referensi ini disinkronkan dari src/definitions.ts di capacitor-tugas-latar-belakang.
Teruskan dari @capgo/capacitor-tugas-latar-belakang
Judul bagian “Teruskan dari @capgo/capacitor-tugas-latar-belakang”Jika Anda menggunakan @capgo/capacitor-tugas-latar-belakang Untuk merencanakan pekerjaan plugin native, hubungkannya dengan Menggunakan @capgo/capacitor-task-latar-belakang Untuk kemampuan native di Menggunakan @capgo/capacitor-task-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.