Prise en main

Copiez un prompt de configuration incluant les étapes d'installation et le guide markdown complet pour ce 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.

Installer

Vous pouvez utiliser notre configuration assistée par IA pour installer le plugin. Ajoutez les skills Capgo à votre outil d'IA avec la commande suivante :

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

Utilisez ensuite le prompt suivant :

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

Si vous préférez une installation manuelle, installez le plugin en exécutant les commandes suivantes et suivez les instructions spécifiques à chaque plateforme ci-dessous :

bun add @capgo/capacitor-permissions
bunx cap sync

Importer

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

Démarrage rapide

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

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

Exemple : requête

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

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

Exemple : checkMultiple

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

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

Erreurs courantes

Sync native : exécuter bunx cap sync après les mises à jour du plugin.
Source de vérité : fiez-vous src/definitions.ts au repo GitHub.

Configuration de la plateforme

Configuration iOS pour les chaînes d’utilisation Info.plist par PermissionName.
Configuration Android pour uses-permission entrées et minSdk 24.

Utilisation

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

Quand le statut est blocked, redirigez l'utilisateur vers les réglages :

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