Erste Schritte

Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-permissions`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/permissions/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

Installieren

Du kannst unser KI-gestütztes Setup nutzen, um das Plugin zu installieren. Füge die Capgo Skills mit dem folgenden Befehl deinem KI-Tool hinzu:

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

Nutze dann diesen Prompt:

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

Wenn du ein manuelles Setup bevorzugst, installiere das Plugin mit den folgenden Befehlen und befolge die plattformspezifischen Anweisungen unten:

bun add @capgo/capacitor-permissions
bunx cap sync

Importieren

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

Quickstart

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

const { status } = await Permissions.check({ permission: 'camera' });

Beispiel: request

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

const { status } = await Permissions.request({ permission: 'notifications' });

Beispiel: checkMultiple

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

const { statuses } = await Permissions.checkMultiple({
  permissions: ['camera', 'microphone'],
});

Häufige Stolperfallen

Nativer Sync: ausführen bunx cap sync nach Plugin-Upgrades.
Single Source of Truth: Vertrauen src/definitions.ts im GitHub Repo.

Plattform-Setup

iOS-Setup für Info.plist-Usage-Strings pro PermissionName.
Android-Setup für uses-permission Einträge und minSdk 24.

Nutzung

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

Wenn status ist blocked, leite den Benutzer zu den Einstellungen weiter:

await Permissions.openSettings({ type: 'application' });