Aller directement au contenu principal
@capgo/capacitor-permissions APIs de dispositif Source ouvert

Permissions plugin Capacitor

Vérifiez et demandez les permissions d'exécution sur iOS, Android et web avec un seul énuméré 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

Utilisation de @capgo/capacitor-permissions

Un seul fichier TypeScript API pour vérifier et demander les permissions d'exécution sur iOS, Android et web avec des codes de statut normalisés.

Installation

bun add @capgo/capacitor-permissions
bunx cap sync

Ce que ce plugin expose

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

Utilisation d'exemple

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 de permissions

Comment installer le plugin de permissions dans une application Capacitor ?

Exécutez « bun add @capgo/capacitor-permissions » (ou « npm install @capgo/capacitor-permissions »), puis exécutez « bunx cap sync » afin que les projets iOS et Android prennent en compte le code natif code. Importez-l’à partir de « @capgo/capacitor-permissions » dans votre application code.

Le plugin @capgo/capacitor-permissions fonctionne-t-il avec React, Vue et Angular ?

Oui. Le plugin de permissions est un package Capacitor, il fonctionne donc avec tout framework web qui s'exécute à l'intérieur de Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript pur.

Quelle version de Capacitor est prise en charge 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, plugin v8 avec Capacitor 8). La table de compatibilité dans le README du GitHub liste les versions maintenues.

Le plugin @capgo/capacitor-permissions est-il 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 à partir de npm. Les rapports de bugs et les demandes de pull sont les bienvenus.

Peut-on mettre à jour code qui utilise Permissions sans passer par une revue de l'App Store ?

Installing or upgrading the plugin changes native code, so it needs a new store build. After that, JavaScript, HTML and CSS changes that call the plugin can ship instantly with Capgo live updates.

Envoyer les modifications des permissions sans attendre la revue de l'application

Une fois le plugin est dans votre magasin de build, Capgo mises à jour en direct push vos modifications JavaScript, HTML et CSS vers les utilisateurs en quelques minutes.

Commencez avec Capgo