@capgo/capacitor-배경 작업

개요

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

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

기본 기능

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

Platform Behavior

Background tasks are not exact timers. Android and iOS decide when to run scheduled work based on battery, network, app usage, and system policy.

Platform	Native scheduler	Important behavior
Android	WorkManager	Periodic work has a 15-minute minimum interval.
iOS	BGTaskScheduler	minimumInterval 은 가장 빠른 시작 날짜이며, 보장된 주기와는 다릅니다.
웹	테스트 전용 fallback	실제 배경 스케줄러가 사용할 수 없습니다.

공개 API

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

진실의 근원

__CAPGO_KEEP_0__-배경 작업 src/definitions.ts __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-배경 작업에서 계속 capacitor/__CAPGO_KEEP_1__-배경 작업에서 계속.

capgo/capacitor-배경 작업에서 계속

만약에 당신이 @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 플러그인 대체 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-background-task {"targetLanguage":"Korean","pagePath":"/ko/docs/plugins/background-task/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"Ionic 이나 Enterprise 플러그인 대체 제품의 제품 워크플로우를 위해."},{"text":"편집 페이지"}]}