Lebih cepat ke konten

@capgo/capacitor-background-task

Tugas latar belakang dengan gaya 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, pengosongan 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 pengembang, dan kejadian kadaluarsa iOS.

  • defineTask - Mendaftarkan panggilan JavaScript untuk sebuah tugas bernama.
  • registerTaskAsync - Menyimpan dan mengatur jadwal tugas berulang.
  • unregisterTaskAsync - Membatalkan pelaksanaan masa depan untuk satu tugas.
  • isTaskRegisteredAsync - Memeriksa apakah sebuah tugas telah didaftarkan.
  • getRegisteredTasksAsync - Menampilkan daftar nama tugas yang saat ini didaftarkan.
  • getPendingTaskRunsAsync - Menginspeksi event tugas native yang direkam sebelum JavaScript siap.
  • getStatusAsync - Memeriksa ketersediaan tugas latar belakang native.
  • triggerTaskWorkerForTestingAsync - Menjalankan tugas yang didaftarkan secara langsung selama pengembangan.
  • addExpirationListener - Menghandle panggilan callback iOS yang telah kedaluwarsa.
  • define, schedule, cancel, statusAsync, dan finish - Bantuan kompatibilitas untuk react-native-background-task.

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

PlatformPengaturan scheduler asliPerilaku penting
AndroidPekerjaan ManajerKerja periodik memiliki jarak minimum 15 menit.
iOSPengaturan Tugas Latar BelakangminimumInterval adalah tanggal mulai paling awal, bukan kecepatan yang dijamin.
WebJalankan uji cobaTidak ada scheduler latar belakang nyata yang tersedia.
MetodeDeskripsi
defineTaskMengdefinisikan panggilan balik JavaScript untuk sebuah tugas bernama.
registerTaskAsyncMendaftarkan tugas latar belakang berulang yang bernama.
unregisterTaskAsyncMembatalkan tugas berjalan di masa depan.
isTaskRegisteredAsyncMengembalikan apakah sebuah tugas sudah didaftarkan.
getRegisteredTasksAsyncDaftar nama tugas yang terdaftar.
getPendingTaskRunsAsyncDaftar event tugas native yang menunggu selesai.
getStatusAsyncMengembalikan apakah pengaturan latar belakang native tersedia.
triggerTaskWorkerForTestingAsyncMengaktifkan tugas yang terdaftar untuk pengembangan dan QA.
addExpirationListenerMendengarkan event kadaluarsa iOS.

Referensi ini disinkronkan dari src/definitions.ts di capacitor-tugas-latar-belakang.

Teruskan dari @capgo/capacitor-tugas-latar-belakang

Bagian berjudul “Teruskan dari @capgo/capacitor-tugas-latar-belakang”

Jika Anda menggunakan @capgo/capacitor-background-task untuk merencanakan pekerjaan plugin native, hubungkannya dengan Menggunakan @capgo/capacitor-background-task untuk kemampuan native di Menggunakan @capgo/capacitor-background-task, 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 {"targetLanguage":"Indonesian","pagePath":"/id/docs/plugins/background-task/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"Untuk alur kerja produk dalam Ionic Enterprise Plugin Alternatif."},{"text":"Edit halaman"}]}