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