Berechtigungen Capacitor Plugin

@capgo/capacitor-permissions verwenden

Ein TypeScript-API, um Runtime-Berechtigungen auf iOS, Android und Web zu prüfen und anzufordern – mit normalisierten Statuscodes.

Installieren

bun add @capgo/capacitor-permissions
bunx cap sync

Was dieses Plugin bereitstellt

• check - Liest den aktuellen Status einer Berechtigung ab, ohne eine Abfrage zu starten.
• request - Fordert eine Berechtigung vom Benutzer an.
• checkMultiple - Prüft mehrere Berechtigungen, ohne eine Abfrage zu starten.
• requestMultiple - Fordert mehrere Berechtigungen nacheinander an.
• shouldShowRationale - Ob Android vor einer erneuten Anfrage eine Begründung anzeigen soll.
• openSettings - Öffnet die App- oder Benachrichtigungseinstellungen, wenn der Zugriff blockiert ist.
• requestPreciseLocation - Upgrade auf präzise Standortbestimmung auf iOS und feine Standortbestimmung auf Android.
• getPluginVersion - Gibt die Versionsmarke der Plattform-Implementierung zurück.

Anwendungsbeispiel

check und request

import { Permissions } from '@capgo/capacitor-permissions';

export async function ensureCamera(): Promise<boolean> {
  const { status } = await Permissions.check({ permission: 'camera' });
  if (status === 'granted') return true;
  const { status: afterRequest } = await Permissions.request({ permission: 'camera' });
  return afterRequest === 'granted';
}

openSettings

import { Permissions } from '@capgo/capacitor-permissions';

document.getElementById('camera-settings')?.addEventListener('click', async () => {
  const { status } = await Permissions.check({ permission: 'camera' });
  if (status === 'blocked') {
    await Permissions.openSettings({ type: 'application' });
  }
});

Vollständige Referenz

• GitHub: https://github.com/Cap-go/capacitor-permissions/
• Doku: /docs/plugins/permissions/