캘린더 Capacitor 플러그인

@capgo/capacitor-calendar 사용하기

이 @capgo/capacitor-calendar Capacitor 앱에서 이 패키지를 사용하면 iOS와 Android의 네이티브 캘린더 이벤트를 관리할 수 있습니다. 캘린더 권한 요청, 이벤트 생성 및 수정, 네이티브 캘린더 UI 열기, 캘린더와 이벤트 목록 조회, iOS의 Reminders 관리까지 지원합니다.

설치

npm install @capgo/capacitor-calendar
npx cap sync

네이티브 권한 설정

iOS에서는 앱에 필요한 사용 설명(usage description)을 다음 파일에 추가하세요: ios/App/App/Info.plist:

<key>NSCalendarsUsageDescription</key>
<string>This app needs calendar access.</string>
<key>NSCalendarsWriteOnlyAccessUsageDescription</key>
<string>This app needs permission to add calendar events.</string>
<key>NSCalendarsFullAccessUsageDescription</key>
<string>This app needs permission to read and manage calendar events.</string>
<key>NSRemindersFullAccessUsageDescription</key>
<string>This app needs permission to read and manage reminders.</string>

Android에서는 앱에 필요한 캘린더 권한을 다음 파일에 추가하세요: android/app/src/main/AndroidManifest.xml:

<uses-permission android:name="android.permission.READ_CALENDAR" />
<uses-permission android:name="android.permission.WRITE_CALENDAR" />

권한 요청

import { CapacitorCalendar } from '@capgo/capacitor-calendar';

const permission = await CapacitorCalendar.requestFullCalendarAccess();

if (permission.result !== 'granted') {
  throw new Error('Calendar permission was not granted');
}

이벤트 생성

const startDate = Date.now() + 60 * 60 * 1000;
const endDate = startDate + 60 * 60 * 1000;

const { id } = await CapacitorCalendar.createEvent({
  title: 'Product review',
  location: 'Capgo',
  startDate,
  endDate,
  description: 'Created with @capgo/capacitor-calendar',
});

console.log('Created event', id);

네이티브 이벤트 UI 열기

await CapacitorCalendar.createEventWithPrompt({
  title: 'Planning session',
  location: 'Office',
  startDate: Date.now() + 24 * 60 * 60 * 1000,
  endDate: Date.now() + 25 * 60 * 60 * 1000,
});

이벤트 목록

const now = Date.now();

const { result: events } = await CapacitorCalendar.listEventsInRange({
  from: now,
  to: now + 7 * 24 * 60 * 60 * 1000,
});

iOS 미리 알림

const permission = await CapacitorCalendar.requestFullRemindersAccess();

if (permission.result === 'granted') {
  await CapacitorCalendar.createReminder({
    title: 'Send launch notes',
    dueDate: Date.now() + 2 * 24 * 60 * 60 * 1000,
  });
}

Reminders 기능은 iOS에서만 사용할 수 있습니다.

전체 레퍼런스

• GitHub: https://github.com/Cap-go/capacitor-calendar/
• 문서: /docs/plugins/calendar/