Lompat ke konten

@capgo/capacitor-tugas-latar-belakang

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

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.

  • 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 untuk finish Penggunaan Platform 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.PlatformJadwal Pemrograman Asli
Pengaturan pentingAndroidWorkManager
Pekerjaan periodik memiliki jarak minimum 15 menit.iOSminimumInterval BGTaskScheduler
adalah tanggal mulai terdahulu, bukan kordensi yang dijamin.Fallback hanya untuk pengujianTidak ada scheduler latar belakang nyata yang tersedia.
MetodeDeskripsi
defineTaskMengdefinisikan callback JavaScript untuk sebuah tugas bernama.
registerTaskAsyncMengdaftar tugas latar belakang berulang yang bernama.
unregisterTaskAsyncMembatalkan tugas berjalan di masa depan.
isTaskRegisteredAsyncMengembalikan apakah sebuah tugas telah didaftarkan.
getRegisteredTasksAsyncMengdaftar nama-nama tugas yang didaftarkan.
getPendingTaskRunsAsyncMengdaftar event tugas asli yang menunggu selesai.
getStatusAsyncMengembalikan apakah pengaturan latar belakang native tersedia.
triggerTaskWorkerForTestingAsyncMengaktifkan tugas yang terdaftar untuk pengembangan dan QA.
addExpirationListenerMendengarkan event 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-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.