Zum Hauptinhalt springen
@capgo/capacitor-Rechte Geräte-APIs Open-Source

Rechte Capacitor Plugin

Überprüfen und Anfragen von Laufzeitrechten auf iOS, Android und Web mit einem PermissionName-Enum und normalisierten Statuscodes

Installieren

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

Richtlinie

Wie man Capacitor-Berechtigungen verwendet

Verwendung von @capgo/capacitor-permissions

Einen TypeScript-API zum Überprüfen und Anfordern von Laufzeitberechtigungen auf iOS, Android und Web mit normalisierten Statuscodes.

Installieren

bun add @capgo/capacitor-permissions
bunx cap sync

Was dieses Plugin bereitstellt

  • check - Die aktuelle Status eines Rechts ohne Aufforderung lesen.
  • request - Ein Recht vom Benutzer anfordern.
  • checkMultiple - Mehrere Rechte ohne Aufforderung überprüfen.
  • requestMultiple - Mehrere Rechte nacheinander anfordern.
  • shouldShowRationale - Ob Android vor dem erneuten Anfordern eine Begründung anzeigen soll.
  • openSettings - Die Anwendung oder Benachrichtigungs-Einstellungen öffnen, wenn der Zugriff blockiert ist.
  • requestPreciseLocation - Auf iOS die genaue und auf Android die feine Standort-Erweiterung verwenden.
  • getPluginVersion - Die Versionsmarke der Plattform-Implementierung zurückgeben.

- Beispielverwendung

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

- Vollständige Referenz

FAQ

FAQs zum Berechtigungs-Plugin

Wie installiere ich das Berechtigungs-Plugin in einer Capacitor-Anwendung?

Führen Sie &quot;bun add @capgo/capacitor-permissions&quot; (oder &quot;npm install @capgo/capacitor-permissions&quot;) aus, führen Sie dann &quot;bunx cap sync&quot; aus, damit die iOS- und Android-Projekte die nativen code-Komponenten aufnehmen. Importieren Sie es aus &quot;@capgo/capacitor-permissions&quot; in Ihrer code-Anwendung.

Funktioniert @capgo/capacitor-permissions mit React, Vue und Angular?

Ja. Permissions ist ein Capacitor-Paket, daher funktioniert es mit jedem Webframework, das innerhalb von Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und plain JavaScript.

Welche Capacitor-Version unterstützt @capgo/capacitor-permissions?

Capgo-Plugins folgen der Capacitor-Version: Wählen Sie die Plugin-Major-Version, die Ihrem Capacitor-Major-Version entspricht (z. B. Plugin v8 mit Capacitor 8). Die Kompatibilitäts-Tabelle im GitHub-README enthält die unterstützten Versionen.

Ist @capgo/capacitor-permissions kostenlos und Open-Source?

Ja. Die Quellcode von code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-permissions/ verfügbar und das Paket kann kostenlos installiert werden von npm. Bug-Reports und Pull-Requests sind willkommen.

Kann ich code aktualisieren, das Permissions verwendet, ohne eine App-Store-Bewertung?

Die Installation oder das Upgrade des Plugins ändert die nativen code-Komponenten, daher benötigt es eine neue Store-Build. Nachdem Sie dies getan haben, können Sie JavaScript-, HTML- und CSS-Änderungen, die den Plugin aufrufen, sofort mit Capgo-Live-Updates bereitstellen.

Shipmenge von Berechtigungen ohne Wartezeit für die App-Überprüfung

Sobald das Plugin in Ihrem Store-Builder integriert ist, Capgo leiten live Updates Ihre JavaScript-, HTML- und CSS-Änderungen an Benutzer in Minuten weiter.

Starten Sie mit Capgo