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
- GitHub : https://github.com/Cap-go/capacitor-permissions/
- Docs : /docs/plugins/permissions/