Lompat ke konten

capgo/capacitor-tugas-latar-belakang

Tugas latar belakang yang dinamai Expo untuk aplikasi Capacitor, didukung oleh Android WorkManager dan iOS BGTaskScheduler.

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.

  • 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 untuk finish Penggunaan Platform react-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.

PlatformJadwal pustaka asliPengaturan perilaku yang penting
AndroidWorkManagerPekerjaan periodik memiliki interval minimum 15 menit.
iOSBGTaskSchedulerminimumInterval adalah tanggal mulai yang paling awal, bukan kordensi yang dijamin.
WebFallback hanya untuk pengujianTidak ada scheduler latar belakang nyata yang tersedia.
MetodeDeskripsi
defineTaskMengdefinisikan panggilan balik JavaScript untuk sebuah tugas bernama.
registerTaskAsyncMengdaftar tugas latar belakang periodik bernama.
unregisterTaskAsyncMembatalkan tugas berjalan di masa depan.
isTaskRegisteredAsyncMengembalikan apakah sebuah tugas telah didaftarkan.
getRegisteredTasksAsyncMengdaftar nama-nama tugas yang didaftarkan.
getPendingTaskRunsAsyncMengdaftar event-event tugas asli yang menunggu selesai.
getStatusAsyncMengembalikan apakah pengaturan jadwal latar belakang native tersedia.
triggerTaskWorkerForTestingAsyncMengaktifkan tugas yang terdaftar untuk pengembangan dan QA.
addExpirationListenerMendengarkan peristiwa kedaluwarsa iOS.

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.