__CAPGO_KEEP_0__ 앱이 주기적인 배경 가져오기 작업이 필요할 때 사용합니다. 예를 들어, 동기화, 캐시 업데이트, 인박스 폴링, 분석 플러시, 또는 가벼운 유지 관리 작업. @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.
핵심 기능
defineTask- __CAPGO_KEEP_0__ callback을 이름이 지정된 작업에 등록하세요.registerTaskAsync- JavaScript callback이 등록된 작업을 지속하고 예약하세요.unregisterTaskAsync- 하나의 작업에 대해 미래의 실행을 취소하세요.isTaskRegisteredAsync- 작업이 등록되어 있는지 확인하세요.getRegisteredTasksAsync- 현재 등록된 작업 이름 목록을 확인하세요.getPendingTaskRunsAsync- JavaScript가 준비되기 전에 기록된 네이티브 작업 이벤트를 검사하세요.getStatusAsync- 네이티브 백그라운드 작업 사용 가능 여부를 확인하세요.triggerTaskWorkerForTestingAsync- 개발 중에 등록된 작업을 즉시 실행하세요.addExpirationListener- iOS 만료 콜백을 처리하세요.define,schedule,cancel,statusAsync, andfinish- __CAPGO_KEEP_0__ 호환성 도우미react-native-background-task.
플랫폼 동작
플랫폼 동작배경 작업은 정확한 타이머가 아닙니다. Android와 iOS는 배터리, 네트워크, 앱 사용, 시스템 정책에 따라 스케줄된 작업을 실행할 때를 결정합니다.
| 플랫폼 | 네이티브 스케줄러 | 중요한 동작 |
|---|---|---|
| Android | WorkManager | 주기적인 작업은 15분의 최소 간격을 가지고 있습니다. |
| iOS | BGTaskScheduler | minimumInterval 가장 빠른 시작 날짜이며, 보장된 주기는 아닙니다. |
| 웹 | 테스트 전용 fallback | 실제 배경 스케줄러가 사용할 수 없습니다. |
공개 API
API라는 제목의 공개 섹션| 메소드 | 설명 |
|---|---|
defineTask | 이름이 지정된 작업을 위한 자바스크립트 콜백을 정의합니다. |
registerTaskAsync | 이름이 지정된 주기적인 배경 작업을 등록합니다. |
unregisterTaskAsync | 미래의 작업 실행을 취소합니다. |
isTaskRegisteredAsync | 작업이 등록되어 있는지 여부를 반환합니다. |
getRegisteredTasksAsync | 등록된 작업 이름 목록을 반환합니다. |
getPendingTaskRunsAsync | 대기 중인 원시 작업 이벤트 목록을 반환합니다. |
getStatusAsync | 원시 배경 스케줄링이 사용 가능한지 여부를 반환합니다. |
triggerTaskWorkerForTestingAsync | 개발 및 QA에서 등록된 작업을 트리거합니다. |
addExpirationListener | iOS 만료 이벤트를 듣습니다. |
Source Of Truth
Source Of Truth이 참조는 src/definitions.ts 에서 capacitor-배경 작업에서 계속하기.
Keep going from @capgo/capacitor-배경 작업에서 계속하기
Keep going from @capgo/capacitor-배경 작업에서 계속하기Capgo를 사용 중이라면 @capgo/capacitor-배경 작업에서 계속하기 native 플러그인 작업을 계획하기 위해, 그것을 연결하세요. Using @capgo/capacitor-background-task native 기능을 위한 Using @capgo/capacitor-background-task Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리에서 제품 워크플로우 Capacitor 플러그인들에 의해 Capgo Capacitor 플러그인들에 의해 Capgo의 구현 세부 사항 플러그인을 추가하거나 업데이트 플러그인을 추가하거나 업데이트하는 구현 세부 사항 Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우