Empezar

Instalar

npm install @capgo/capacitor-calendar
npx cap sync

Configuración de iOS

Agregue las descripciones de uso que su aplicación necesite 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>NSRemindersUsageDescription</key>
<string>This app needs reminders access.</string>
<key>NSRemindersFullAccessUsageDescription</key>
<string>This app needs permission to read and manage reminders.</string>

iOS 17 y posteriores distinguen entre acceso de escritura solo y acceso completo al calendario. Solo incluya descripciones de uso de recordatorios si su aplicación llama a las API de Recordatorios.

Referencia de Apple: Migrar a los niveles de acceso de calendario más recientes.

Configuración de Android

Agregue las permisos del calendario que su aplicación necesite android/app/src/main/AndroidManifest.xml:

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

Referencia de Android: Permisos del proveedor de calendario del usuario.

Solicitar acceso al calendario

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

const permission = await CapacitorCalendar.requestFullCalendarAccess();

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

Para aplicaciones que solo agregan eventos, utilice requestWriteOnlyCalendarAccess(). Para flujos de lectura solo para Android, utilice requestReadOnlyCalendarAccess().

Crear un evento

Las fechas son timestamps de Unix en milisegundos.

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

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

Abrir el editor de eventos nativo

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

En Android, las llamadas de creación y modificación basadas en solicitudes devuelven null. Listar eventos después si necesita encontrar el ID del evento creado.

Listar Eventos Próximos

const now = Date.now();
const oneWeekFromNow = now + 7 * 24 * 60 * 60 * 1000;

const { result: events } = await CapacitorCalendar.listEventsInRange({
  from: now,
  to: oneWeekFromNow,
});

Elegir Un Calendario

const { result: calendars } = await CapacitorCalendar.listCalendars();
const { result: defaultCalendar } = await CapacitorCalendar.getDefaultCalendar();

const calendarId = defaultCalendar?.id ?? calendars[0]?.id;

selectCalendarsWithPrompt() está disponible en iOS cuando desea mostrar el selector de calendario del sistema.

Crear Un Recordatorio De 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,
    notes: 'Created with @capgo/capacitor-calendar',
  });
}

Las APIs de recordatorio solo están disponibles para iOS.

App de ejemplo

El repositorio incluye una aplicación de ejemplo Capacitor con comprobaciones de permisos, creación de eventos, promoción de eventos nativos, lista de calendario y lista de rangos de eventos.

iOS	Android

Referencia de API

La referencia completa de API se mantiene en el archivo README del paquete y las definiciones de TypeScript:

• README
• Definiciones de tipo