Lompat ke konten utama
@capgo/capacitor-permissions API Perangkat Open source

Izin plugin Capacitor

Cek dan minta izin runtime di iOS, Android, dan web dengan satu enum PermissionName dan status code yang ternormalisasi

Instal

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

Panduan

Cara menggunakan Permissions di Capacitor

Menggunakan @capgo/capacitor-permissions

Satu API TypeScript untuk cek dan meminta runtime permission di iOS, Android, dan web dengan status code yang dinormalisasi.

Instal

bun add @capgo/capacitor-permissions
bunx cap sync

Yang Diekspos Plugin Ini

  • check - Baca status izin saat ini tanpa memunculkan prompt.
  • request - Minta satu izin dari pengguna.
  • checkMultiple - Cek beberapa izin tanpa prompt.
  • requestMultiple - Minta beberapa izin secara berurutan.
  • shouldShowRationale - Apakah Android harus menampilkan alasan sebelum meminta lagi.
  • openSettings - Buka pengaturan aplikasi atau notifikasi saat akses diblokir.
  • requestPreciseLocation - Upgrade ke precise location di iOS dan fine location di Android.
  • getPluginVersion - Mengembalikan penanda versi implementasi platform.

Contoh Penggunaan

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

Referensi Lengkap

FAQ

FAQ plugin Permissions

Bagaimana cara install plugin Permissions di aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-permissions" (atau "npm install @capgo/capacitor-permissions"), lalu jalankan "bunx cap sync" agar proyek iOS dan Android mendeteksi code native. Import dari "@capgo/capacitor-permissions" di dalam code aplikasi Anda.

Apakah @capgo/capacitor-permissions bisa digunakan dengan React, Vue, dan Angular?

Ya. Permissions adalah package Capacitor, jadi bisa digunakan dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript murni.

Versi Capacitor mana yang didukung oleh @capgo/capacitor-permissions?

Plugin Capgo mengikuti versi major Capacitor: gunakan versi major plugin yang cocok dengan versi major Capacitor Anda (misalnya plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang di-maintain.

Apakah @capgo/capacitor-permissions gratis dan open source?

Ya. Source code tersedia secara publik di GitHub pada https://github.com/Cap-go/capacitor-permissions/ dan package ini gratis untuk diinstall via npm. Bug report dan pull request sangat kami terima.

Bisakah saya update code yang menggunakan Permissions tanpa review App Store?

Install atau upgrade plugin akan mengubah code native, sehingga butuh build store baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin tersebut bisa langsung dikirim via Capgo live updates.

Rilis perubahan Permission tanpa menunggu review aplikasi

Setelah plugin ada di build store Anda, Capgo live updates mengirim perubahan JavaScript, HTML, dan CSS ke pengguna dalam hitungan menit.

Mulai dengan Capgo