Lompat ke konten

@capgo/capacitor-tugas-latar-belakang

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

Gunakan ketika aplikasi __CAPGO_KEEP_0__ Anda memerlukan pekerjaan fetch latar belakang berkala seperti sinkronisasi, pembaruan cache, polling kotak masuk, pengosongan analitik, atau pekerjaan perawatan ringan. @capgo/capacitor-background-task when your Capacitor app needs periodic background fetch work such as sync, cache refreshes, inbox polling, analytics flushing, or lightweight maintenance jobs.

Kemampuan Inti

  • defineTask - Simpan dan jadwalkan tugas berkala.
  • registerTaskAsync - Batalkan jalankan masa depan untuk satu tugas.
  • unregisterTaskAsync - Periksa apakah tugas telah didaftarkan.
  • isTaskRegisteredAsync - Daftarkan nama tugas yang saat ini terdaftar.
  • getRegisteredTasksAsync - Inspeksi kejadian tugas native yang direkam sebelum JavaScript siap.
  • getPendingTaskRunsAsync - Periksa ketersediaan tugas latar belakang native.
  • getStatusAsync Core Capabilities
  • 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.

Tugas latar belakang bukanlah timer yang tepat. Android dan iOS menentukan kapan menjalankan pekerjaan yang telah dijadwalkan berdasarkan baterai, jaringan, penggunaan aplikasi, dan kebijakan sistem.

PlatformJadwal pustaka nativeTindakan penting
AndroidWorkManagerPekerjaan berkala memiliki interval minimum 15 menit.
iOSBGTaskSchedulerminimumInterval Tidak ada tanggal mulai yang paling awal, melainkan jadwal yang tidak dapat dipastikan.
WebFallback uji coba hanya untuk tes.Tidak ada scheduler latar belakang yang nyata tersedia.
MetodeDeskripsi
defineTaskMengdefinisikan callback JavaScript untuk sebuah tugas bernama.
registerTaskAsyncMendaftarkan tugas latar belakang berjadwal yang dinamai.
unregisterTaskAsyncMembatalkan tugas yang akan dijalankan di masa depan.
isTaskRegisteredAsyncMengembalikan apakah tugas telah didaftarkan.
getRegisteredTasksAsyncMenampilkan nama-nama tugas yang didaftarkan.
getPendingTaskRunsAsyncMenampilkan event-event tugas native yang menunggu untuk diselesaikan.
getStatusAsyncMengembalikan apakah pengaturan latar belakang native tersedia.
triggerTaskWorkerForTestingAsyncMengaktifkan tugas yang didaftarkan untuk pengembangan dan QA.
addExpirationListenerMendengarkan event-expirasi 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 asli, hubungkannya dengan Menggunakan @capgo/capacitor-tugas-latar-belakang untuk kemampuan asli dalam Menggunakan @capgo/capacitor-tugas-latar-belakang, Direktori Plugin Capgo untuk alur kerja produk dalam Direktori Plugin Capgo Plugin-Plugin Capacitor oleh Capgo untuk detail implementasi dalam Plugin-Plugin Capacitor oleh Capgo Mengambah atau Mengupdate Plugin untuk detail implementasi di Mengambah atau Mengupdate Plugin, dan Alternatif Plugin Enterprise Ionic untuk alur kerja produk di Alternatif Plugin Enterprise Ionic.