Pendahuluan
Bab berjudul “Pendahuluan”Pakai @capgo/capacitor-background-task ketika aplikasi Capacitor Anda memerlukan pekerjaan fetch latar belakang berkala seperti sinkronisasi, pembaruan cache, polling kotak masuk, pengeluaran analitik, atau pekerjaan perawatan ringan.
Plugin ini mengikuti setelan fitur yang praktis dari Expo BackgroundTask dengan tugas bernama, pendaftaran yang berlangsung, pengecekan status, penghapusan pendaftaran, pengaktifan pengembangan, dan kejadian kadaluarsa iOS.
Kemampuan Utama
Bab berjudul “Kemampuan Utama”defineTask- Daftarkan panggilan JavaScript untuk sebuah tugas bernama.registerTaskAsync- Simpan dan jadwalkan tugas berkala.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.
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 Pemrograman Asli |
|---|---|---|
| Pengaturan penting | Android | WorkManager |
| Pekerjaan periodik memiliki jarak minimum 15 menit. | iOS | minimumInterval BGTaskScheduler |
| adalah tanggal mulai terdahulu, bukan kordensi yang dijamin. | Fallback hanya untuk pengujian | Tidak ada scheduler latar belakang nyata yang tersedia. |
Publik API
Judul bagian “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 | Mengdaftar nama-nama tugas yang didaftarkan. |
getPendingTaskRunsAsync | Mengdaftar event tugas asli yang menunggu selesai. |
getStatusAsync | Mengembalikan apakah pengaturan latar belakang native tersedia. |
triggerTaskWorkerForTestingAsync | Mengaktifkan tugas yang terdaftar untuk pengembangan dan QA. |
addExpirationListener | Mendengarkan event 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-tugas-latar untuk kemampuan native di Menggunakan @capgo/capacitor-tugas-latar, Capgo Direktori Plugin untuk alur kerja produk di Capgo Direktori Plugin, Capacitor Plugin oleh Capgo untuk detail implementasi di Capacitor Plugin 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.