Allez directement au contenu principal
@capgo/capacitor-permissions APIs des appareils Source

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.

Installer

bun add @capgo/capacitor-permissions
bunx cap sync

Qu'est-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 - Afficher un raisonnement avant de demander à nouveau sur Android.
  • openSettings - Ouvrez les paramètres de l'application ou des notifications lorsque l'accès est bloqué.
  • requestPreciseLocation - Mettre à niveau 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.

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

- Documentation 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 charge les natives code. Importez-l’à partir de « @capgo/capacitor-permissions » dans votre application code.

Fonctionne-t-il @capgo/capacitor-permissions avec React, Vue et Angular ?

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

Quelle version 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.

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

Oui. Le code source code est public sur GitHub à https://github.com/Cap-go/capacitor-permissions/ et le paquet est gratuit pour l'installer à partir de npm. Les rapports de bogues et les demandes de modification sont les bienvenus.

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

L'installation ou la mise à niveau du plugin change les natives code, il faut donc une nouvelle construction de l'application. Après cela, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être déployées instantanément avec les mises à jour Capgo.

Ship Permissions changes without waiting for app review

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

Commencez par Capgo