@capgo/capacitor-배경 작업 사용

이름이 지정된 작업, 지속적인 등록, 상태 확인, 등록 해제 및 개발 트리거를 사용하여 Capacitor 앱에서 정기적인 배경 다운로드 작업을 등록하세요. 플러그인은 Android WorkManager 및 iOS BGTaskScheduler를 사용합니다.

설치

npm install @capgo/capacitor-background-task
npx cap sync

iOS 설정

iOS 배경 처리 지원을 추가하세요. ios/App/App/Info.plist:

<key>UIBackgroundModes</key>
<array>
  <string>processing</string>
</array>
<key>BGTaskSchedulerPermittedIdentifiers</key>
<array>
  <string>app.capgo.backgroundtask.processing</string>
</array>

그런 다음 실행하세요.

npx cap sync ios

이 플러그인이 제공하는 것

defineTask - 이름이 지정된 작업에 대한 JavaScript 콜백을 정의하세요.
registerTaskAsync - 주기적인 작업을 저장하고 예약하세요.
unregisterTaskAsync - 하나의 작업을 취소하세요.
isTaskRegisteredAsync - 하나의 작업의 등록 상태를 확인하세요.
getRegisteredTasksAsync - 등록된 작업 이름 목록을 확인하세요.
getStatusAsync - iOS 배경 작업 사용 가능 여부를 확인하세요.
triggerTaskWorkerForTestingAsync - 개발 시에 등록된 작업을 즉시 트리거하세요.
addExpirationListener - iOS가 작업을 만료할 때 반응하세요.

예시 사용

__CAPGO_KEEP_0__ 모듈 범위에서 작업을 정의하여 OS가 앱을 깨울 때 사용할 수 있도록 하세요.

import { BackgroundTask, BackgroundTaskResult } from '@capgo/capacitor-background-task';

const SYNC_TASK = 'sync-offline-data';

BackgroundTask.defineTask(SYNC_TASK, async () => {
  try {
    await fetch('https://api.example.com/sync', { method: 'POST' });
    return BackgroundTaskResult.Success;
  } catch {
    return BackgroundTaskResult.Failed;
  }
});

await BackgroundTask.registerTaskAsync(SYNC_TASK, {
  minimumInterval: 30,
  requiresNetwork: true,
});

상태를 확인하고 등록된 작업 이름을 확인하세요.

const status = await BackgroundTask.getStatusAsync();
const tasks = await BackgroundTask.getRegisteredTasksAsync();

console.log({ status, tasks });

개발 실행을 트리거하세요.

await BackgroundTask.triggerTaskWorkerForTestingAsync();

작업을 취소하세요.

await BackgroundTask.unregisterTaskAsync(SYNC_TASK);

플랫폼 참고사항

배경 작업 스케줄은 정확한 타이머가 아닌 기회주의적입니다.
Android는 15분의 최소 간격을 가집니다.
iOS는 minimumInterval 을 가장 빠른 시작 날짜로 처리하고 나중에 실행될 수 있습니다.
iOS 배경 처리를 물리적 장치에서 테스트하세요.

전체 참조

GitHub: https://github.com/Cap-go/capacitor-background-task/
문서: /docs/plugins/background-task/

capgo를 사용하여 @capgo/capacitor-background-task

__CAPGO_KEEP_0__를 사용하고 있나요? @capgo/capacitor-background-task을 사용하여 자연스러운 플러그인 작업을 계획하려면 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-background-task과 연결하세요. @capgo/capacitor-background-task을 사용하여 자연스러운 플러그인 작업의 구현 세부 사항을 @capgo/capacitor-background-task에서 확인하세요. 시작하기 시작하기의 구현 세부 사항을 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-background-task에서 확인하세요. Capgo 플러그인 디렉토리 제품 워크플로우를 위한 Capgo 플러그인 디렉토리에서 Capacitor 플러그인에 의해 Capgo 제품 구현 세부 사항을 위한 Capacitor 플러그인에 의해 Capgo, 그리고 플러그인을 추가하거나 업데이트 플러그인을 추가하거나 업데이트 구현 세부 사항을 위한.

배경 작업

배경 작업에 대한 튜토리얼