Aller au contenu principal
@capgo/capacitor-permissions API de l'appareil Open source

Autorisations Plugin Capacitor

Gérez et demandez les permissions au runtime sur iOS, Android et le web avec un seul enum PermissionName et des codes de statut normalisés

Installer

bun add @capgo/capacitor-permissions bunx cap sync
npm, pnpm ou yarn
  • npm install @capgo/capacitor-permissions
  • pnpm add @capgo/capacitor-permissions
  • yarn add @capgo/capacitor-permissions

Guide

Comment utiliser les permissions dans Capacitor

Utiliser @capgo/capacitor-permissions

Un API TypeScript pour vérifier et demander les permissions au runtime sur iOS, Android et le web avec des codes de statut normalisés.

Installer

bun add @capgo/capacitor-permissions
bunx cap sync

Ce que ce plugin expose

  • check - Lire le statut actuel d'une permission sans afficher de prompt.
  • request - Demander une permission à l'utilisateur.
  • checkMultiple - Vérifier plusieurs permissions sans afficher de prompt.
  • requestMultiple - Demander plusieurs permissions de manière séquentielle.
  • shouldShowRationale - Indiquer si Android doit afficher une justification avant une nouvelle demande.
  • openSettings - Ouvrir les paramètres de l'application ou des notifications si l'accès est bloqué.
  • requestPreciseLocation - Passer à la localisation précise sur iOS et à la localisation exacte sur Android.
  • getPluginVersion - Renvoie le marqueur de version de l'implémentation de la plateforme.

Exemple d'utilisation

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

Référence complète

FAQ

FAQ du plugin Permissions

Comment installer le plugin Permissions dans une application Capacitor ?

Exécutez « bun add @capgo/capacitor-permissions » (ou « npm install @capgo/capacitor-permissions »), puis lancez « bunx cap sync » pour que les projets iOS et Android récupèrent le code natif. Importez-le depuis « @capgo/capacitor-permissions » dans le code de votre application.

Est-ce que @capgo/capacitor-permissions fonctionne avec React, Vue et Angular ?

Oui. Permissions est un package Capacitor, il fonctionne donc avec n'importe quel framework web qui s'exécute dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et le JavaScript pur.

Quelle version de Capacitor est supportée par @capgo/capacitor-permissions ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

Est-ce que @capgo/capacitor-permissions est gratuit et open source ?

Oui. Le code source code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-permissions/ et le package est gratuit à installer depuis npm. Les rapports de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code utilisant Permissions sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez les changements de permissions sans attendre la validation de l'app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo