@capgo/capacitor-background-task

iOS 및 Android에서 주기적인 백그라운드 fetch 작업을 수행합니다.

개요

모듈 범위 태스크를 정의하고, 실행 간격을 스케줄링하며, 동기화 및 캐시 워밍용으로 OS가 이해하는 결과를 반환합니다.

플랫폼	지원	참고 사항
iOS	지원	Info.plist의 BGTaskScheduler 식별자
Android	지원	WorkManager 스타일 작업
웹	아니요	서비스 워커 사용

defineTask - 이름이 지정된 작업에 대한 JavaScript 콜백을 등록합니다.
registerTaskAsync - 주기 태스크 저장 및 스케줄링
unregisterTaskAsync - 특정 작업의 향후 실행을 취소합니다.
isTaskRegisteredAsync - 작업이 등록되어 있는지 확인합니다.
getRegisteredTasksAsync - 현재 등록된 작업 이름을 나열합니다.
getPendingTaskRunsAsync - JavaScript가 준비되기 전에 기록된 네이티브 작업 이벤트를 검사합니다.
getStatusAsync - 네이티브 백그라운드 태스크 사용 가능 여부 확인
triggerTaskWorkerForTestingAsync - 개발 중 등록된 작업을 즉시 실행합니다.
addExpirationListener - iOS 만료 콜백을 처리합니다.
define, schedule, cancel, statusAsync, 그리고 finish - 호환성 헬퍼 react-native-background-task.

백그라운드 작업은 정확한 타이머가 아닙니다. Android와 iOS는 배터리, 네트워크, 앱 사용량, 시스템 정책에 따라 예약된 작업 실행 시점을 결정합니다.

플랫폼	네이티브 스케줄러	주요 동작
Android	WorkManager	주기적 작업의 최소 간격은 15분입니다.
iOS	BGTaskScheduler	`minimumInterval` 가장 이른 시작 날짜일 뿐, 실행 주기를 보장하지는 않습니다.
웹	테스트 전용 폴백	실제 백그라운드 스케줄러를 사용할 수 없습니다.

메서드	설명
`defineTask`	지정된 태스크의 JavaScript 콜백을 정의합니다.
`registerTaskAsync`	지정된 주기적 백그라운드 태스크를 등록합니다.
`unregisterTaskAsync`	미래 태스크 실행을 취소합니다.
`isTaskRegisteredAsync`	태스크가 등록되어 있는지 반환합니다.
`getRegisteredTasksAsync`	등록된 태스크 이름을 나열합니다.
`getPendingTaskRunsAsync`	완료 대기 중인 네이티브 태스크 이벤트를 나열합니다.
`getStatusAsync`	네이티브 백그라운드 스케줄링이 사용 가능한지 반환합니다.
`triggerTaskWorkerForTestingAsync`	개발 및 QA를 위해 등록된 태스크를 트리거합니다.
`addExpirationListener`	iOS 만료 이벤트를 수신 대기합니다.

이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-background-task.

사용 중이라면 @capgo/capacitor-background-task 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-background-task 사용하기 @capgo/capacitor-background-task 사용에서 네이티브 기능을 위해, Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor 플러그인 구현 상세 내용에 대해서는, 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트 구현 상세 내용에 대해서는, Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우에 대해서는.