Zum Inhalt springen

Einstieg

GitHub

Sie können unsere AI-gestützte Einrichtung verwenden, um das Plugin zu installieren. Fügen Sie den Capgo-Fähigkeiten Ihrer AI-Werkzeugleiste hinzu, indem Sie den folgenden Befehl ausführen:

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

Verwenden Sie dann den folgenden Prompt:

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

Wenn Sie die manuelle Einrichtung bevorzugen, installieren Sie das Plugin, indem Sie die folgenden Befehle ausführen und folgen Sie den darunter angegebenen Plattform-spezifischen Anweisungen:

Terminal-Fenster
npm install @capgo/capacitor-calendar
npx cap sync

Fügen Sie den Verwendungsbeschreibungen hinzu, die Ihre App benötigt 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 und neuer unterscheidet zwischen schreibgeschützten und vollständigen Kalenderzugriffen. Fügen Sie nur Verwendungsbeschreibungen für Erinnerungen hinzu, wenn Ihre App die APIs für Erinnerungen aufruft.

Apple-Referenz: Zum neuesten Kalenderzugriff level migrieren.

Fügen Sie die Kalenderberechtigungen hinzu, die Ihre App benötigt android/app/src/main/AndroidManifest.xml:

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

Android-Referenz: Kalender-Provider-Berechtigungen.

Kalender-Zugriff anfordern

Abschnitt: 'Kalender-Zugriff anfordern'
import { CapacitorCalendar } from '@capgo/capacitor-calendar';
const permission = await CapacitorCalendar.requestFullCalendarAccess();
if (permission.result !== 'granted') {
throw new Error('Calendar permission was not granted');
}

Für Apps, die nur Termine hinzufügen, verwenden requestWriteOnlyCalendarAccess(). Für Android-only-Lese-Flows verwenden requestReadOnlyCalendarAccess().

Die Daten sind Unix-Timestamps in Millisekunden.

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

Den nativen Ereignis-Editor öffnen

Abschnitt: 'Den nativen Ereignis-Editor öffnen'
await CapacitorCalendar.createEventWithPrompt({
title: 'Planning session',
location: 'Office',
startDate: Date.now() + 24 * 60 * 60 * 1000,
endDate: Date.now() + 25 * 60 * 60 * 1000,
});

Bei Android-Anwendungen werden Anfragen zum Erstellen und Bearbeiten von Ereignissen auf Basis von Anfragen zurückgegeben null. Wenn Sie das erstellte Ereignis-ID finden müssen, werden die Ereignisse danach aufgelistet.

const now = Date.now();
const oneWeekFromNow = now + 7 * 24 * 60 * 60 * 1000;
const { result: events } = await CapacitorCalendar.listEventsInRange({
from: now,
to: oneWeekFromNow,
});
const { result: calendars } = await CapacitorCalendar.listCalendars();
const { result: defaultCalendar } = await CapacitorCalendar.getDefaultCalendar();
const calendarId = defaultCalendar?.id ?? calendars[0]?.id;

selectCalendarsWithPrompt() für iOS ist verfügbar, wenn Sie den Systemkalenderpicker anzeigen möchten.

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

Reminder-APIs sind iOS-basiert.

Das Repository enthält ein Beispiel-App mit Capacitor Berechtigungsprüfungen, Ereignis-Erstellung, native Ereignis-Anfragen, Kalender-Liste und Ereignis-Rang-Liste.

iOSAndroid
iOS-Demo für native Kalender-Ereignis-ErstellungAndroid-Demo für native Kalender-Ereignis-Erstellung

Die vollständige API-Referenz wird in der Paket-README und den TypeScript-Definitionen aufrechterhalten: