Getting Started

@capgo/capacitor-background-task Capacitor 앱이 등록된 주기적인 작업, 캐시 갱신, 분석 데이터 전송, 및 다른 배경 가져오기 작업을 위해 이름을 사용할 수 있습니다.

설치

AI-Assisted Setup을 사용하여 플러그인을 설치할 수 있습니다. 다음 명령어를 사용하여 AI 도구에 Capgo 스킬을 추가하세요:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

그런 다음 다음 명령어를 사용하세요:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-background-task` plugin in my project.

만약 Manual Setup을 선호한다면, 다음 명령어를 실행하고 아래의 플랫폼별 지침을 따르세요:

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

iOS 설정

__CAPGO_KEEP_0__ 모드와 허용된 작업 식별자를 추가하세요: 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

수입

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

작업을 정의하세요

애플리케이션이 운영 체제에 의해 시작되면 모듈 스코프에서 콜백을 정의하여 즉시 등록합니다.

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;
  }
});

스케줄을 등록하세요

호출 registerTaskAsync __CAPGO_KEEP_0__

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

minimumInterval __CAPGO_KEEP_2__

__CAPGO_KEEP_3__

const status = await BackgroundTask.getStatusAsync();
const isRegistered = await BackgroundTask.isTaskRegisteredAsync(SYNC_TASK);
const registeredTasks = await BackgroundTask.getRegisteredTasksAsync();

console.log({ status, isRegistered, registeredTasks });

__CAPGO_KEEP_6__

__CAPGO_KEEP_8__

await BackgroundTask.triggerTaskWorkerForTestingAsync();

__CAPGO_KEEP_10__

await BackgroundTask.unregisterTaskAsync(SYNC_TASK);

iOS 만료

iOS는 JavaScript 작업이 끝나기 전에 백그라운드 작업을 중단할 수 있습니다. cleanup 또는 checkpointing이 중요할 때 만료 이벤트를 듣는 것이 좋습니다.

const expiration = await BackgroundTask.addExpirationListener((event) => {
  console.warn('Background task expired', event.taskName, event.taskId);
});

await expiration.remove();

React Native 백그라운드 작업 호환성

이 플러그인은 React Native 앱이 Capacitor로 마이그레이션하는 경우에 작은 호환성 layer를 노출합니다. react-native-background-task.

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

BackgroundTask.define(async () => {
  await fetch('https://api.example.com/sync', { method: 'POST' });
});

await BackgroundTask.schedule({
  period: 1800,
});

프로덕션 노트

• 배경 스케줄링은 정확하지 않습니다.
• 작업을 짧고 idempotent하게 유지하세요.
• 필요한 모든 상태를 반환하기 전에 저장하세요. BackgroundTaskResult.Success.
• 사용자에게 보이는 마감일이나 알람을 위해 배경 작업에 의존하지 마세요.

Getting Started에서 계속하세요.

이 기능을 사용하고 있다면 Getting Started native 플러그인 작업을 계획하기 위해 연결하세요. @capgo/capacitor-background-task를 사용하여 native 기능을 사용하는 경우 @capgo/capacitor-background-task를 사용하는 native 기능의 경우 Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리의 경우 제품 워크플로우를 사용하세요. Capacitor 플러그인들에 의해 Capgo Capacitor 플러그인들에 의해 Capgo의 구현 세부 사항에 대해 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트의 구현 세부 사항에 대해, 및 아이오닉 엔터프라이즈 플러그인 대체 아이오닉 엔터프라이즈 플러그인 대체의 제품 워크플로에 대해.