@capgo/capacitor-배경 작업

Expo-style 이름이 지정된 배경 작업을 위한 Capacitor 앱, Android WorkManager 및 iOS BGTaskScheduler에 의해 지원됩니다.

개요

사용 @capgo/capacitor-background-task Capacitor 앱이 주기적인 배경 fetch 작업이 필요한 경우, 예를 들어 동기화, 캐시 갱신, 인박스 폴링, 분석 데이터 플러시, 또는 가벼운 유지 관리 작업과 같은 경우.

플러그인은 Expo BackgroundTask의 실용적인 기능 집합을 따릅니다. 이름이 지정된 작업, 지속적인 등록, 상태 확인, 등록 해제, 개발 트리거, iOS 만료 이벤트를 포함합니다.

defineTask - 이름이 지정된 작업에 대한 자바스크립트 콜백을 등록합니다.
registerTaskAsync - 주기적인 작업을 저장하고 예약합니다.
unregisterTaskAsync - 특정 작업의 미래 실행을 취소합니다.
isTaskRegisteredAsync - 작업이 등록되어 있는지 확인합니다.
getRegisteredTasksAsync - 현재 등록된 작업 이름 목록을 표시합니다.
getPendingTaskRunsAsync - 자바스크립트가 준비되기 전에 기록된 네이티브 작업 이벤트를 검사합니다.
getStatusAsync - 네이티브 백그라운드 작업 사용 가능 여부를 확인합니다.
triggerTaskWorkerForTestingAsync - 개발 중에 등록된 작업을 즉시 실행합니다.
addExpirationListener - iOS 만료 콜백을 처리합니다.
define, schedule, cancel, statusAsync, 그리고 finish - Compatibility helpers for react-native-background-task.

배경 작업은 정확한 타이머가 아닙니다. Android 및 iOS는 배터리, 네트워크, 앱 사용, 시스템 정책에 따라 예약된 작업을 실행할 때를 결정합니다.

플랫폼	네이티브 스케줄러	중요한 동작
Android	WorkManager	주기적인 작업은 15분의 최소 간격을 갖습니다.
iOS	BGTaskScheduler	`minimumInterval` 은 가장 빠른 시작 날짜이며, 보장된 주기는 아님.
웹	테스트 전용 fallback	실제 배경 스케줄러가 사용할 수 없음.

메서드	설명
`defineTask`	이름이 지정된 작업의 자바스크립트 콜백을 정의합니다.
`registerTaskAsync`	이름이 지정된 주기적인 배경 작업을 등록합니다.
`unregisterTaskAsync`	미래의 작업 실행을 취소합니다.
`isTaskRegisteredAsync`	작업이 등록되어 있는지 여부를 반환합니다.
`getRegisteredTasksAsync`	등록된 작업 이름 목록입니다.
`getPendingTaskRunsAsync`	대기 중인 원시 작업 이벤트 목록입니다.
`getStatusAsync`	원시 배경 스케줄링이 사용 가능한지 여부를 반환합니다.
`triggerTaskWorkerForTestingAsync`	개발 및 QA 환경에서 등록된 작업을 트리거합니다.
`addExpirationListener`	iOS 만료 이벤트를 듣습니다.

이 참조는 src/definitions.ts 에서 synced됩니다. capacitor-background-task.

만약에 당신이 @capgo/capacitor-background-task native 플러그인 작업을 계획하고 싶다면, Using @capgo/capacitor-background-task for the native capability in Using @capgo/capacitor-background-task, for the product workflow in Capgo Plugin Directory, Capgo 플러그인들에 의해 __CAPGO_KEEP_1__ for the implementation detail in Capacitor Plugins by Capgo, for the implementation detail in Capacitor Plugins by Capgo, for the implementation detail in Adding or Updating Plugins, and Ionic Enterprise 플러그인 대체 Ionic Enterprise Plugin Alternatives {"targetLanguage":"Korean","pagePath":"/ko/docs/plugins/background-task/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"Ionic Enterprise 플러그인 대체 제품 워크플로우에 대한 정보입니다."},{"text":"편집 페이지"}]}