Salta al contenuto principale
@capgo/capacitor-permessi API dei dispositivi Open source

Autenticazione plugin Capacitor

Controlla e richiedi autorizzazioni runtime su iOS, Android e web con un'unica enumerazione PermissionName e codici di stato normalizzati

Installa

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

Guida

Come utilizzare le autorizzazioni in Capacitor

Utilizzando @capgo/capacitor-permissions

One TypeScript API to check and request runtime permissions on iOS, Android, and web with normalized status codes.

Installa

bun add @capgo/capacitor-permissions
bunx cap sync

Cos'è che questo Plugin Espone

  • check - Leggi lo stato corrente di un permesso senza sollecitare.
  • request - Richiedi un permesso all'utente.
  • checkMultiple - Verifica più permessi senza sollecitare.
  • requestMultiple - Richiedi più permessi in sequenza.
  • shouldShowRationale - Se Android deve mostrare una giustificazione prima di richiedere nuovamente.
  • openSettings - Apri le impostazioni dell'applicazione o delle notifiche quando l'accesso è bloccato.
  • requestPreciseLocation - Aggiorna a posizione precisa su iOS e posizione fine su Android.
  • getPluginVersion - Restituisce la versione del marker di implementazione della piattaforma.

Esempi di Utilizzo

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

Riferimento Completo

FAQ

FAQ del plugin delle autorizzazioni

Come installare il plugin delle autorizzazioni in un'app Capacitor?

Esegui &quot;bun add @capgo/capacitor-permissions&quot; (o &quot;npm install @capgo/capacitor-permissions&quot;), quindi esegui &quot;bunx cap sync&quot; affinché i progetti iOS e Android recuperino le autorizzazioni native code. Importa il plugin da &quot;@capgo/capacitor-permissions&quot; nella tua app code.

Funziona @capgo/capacitor-permissions con React, Vue e Angular?

Sì. Il plugin delle autorizzazioni è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno di Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Qual è la versione di Capacitor supportata da @capgo/capacitor-permissions?

Il plugin Capgo segue la versione maggiore di Capacitor: utilizza la versione maggiore del plugin che corrisponde alla tua versione maggiore di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README del GitHub elenca le versioni mantenute.

È gratuito e open source @capgo/capacitor-permissions?

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-permissions/ e il pacchetto è gratuito da installare su npm. Sono accetti i rapporti di bug e le richieste di pull.

Posso aggiornare code che utilizza le autorizzazioni senza una revisione dell'App Store?

Installando o aggiornando il plugin cambia il codice nativo code, quindi richiede una nuova costruzione dello store. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere distribuite immediatamente con Capgo aggiornamenti live.

Invia modifiche alle autorizzazioni senza attendere la revisione dell'app

Una volta che il plugin è presente nella tua store build, Capgo aggiornamenti live inviano le tue modifiche JavaScript, HTML e CSS agli utenti in pochi minuti.

Inizia con Capgo