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

Izin plugin Capacitor

Cek dan minta runtime permission di iOS, Android, dan web dengan satu enum PermissionName dan kode status yang dinormalisasi

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 memeriksa dan meminta izin runtime di iOS, Android, dan web dengan status code yang dinormalisasi.

Instal

bun add @capgo/capacitor-permissions
bunx cap sync

Apa yang Diekspos Plugin Ini

  • check - Membaca status satu izin saat ini tanpa memunculkan prompt.
  • request - Meminta satu izin dari pengguna.
  • checkMultiple - Memeriksa beberapa izin tanpa memunculkan prompt.
  • requestMultiple - Meminta beberapa izin secara berurutan.
  • shouldShowRationale - Apakah Android harus menampilkan alasan sebelum meminta izin lagi.
  • openSettings - Membuka pengaturan aplikasi atau notifikasi saat akses diblokir.
  • requestPreciseLocation - Meningkatkan ke lokasi presisi di iOS dan lokasi akurat 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 dipakai dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript biasa.

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

Plugin Capgo mengikuti versi mayor Capacitor: gunakan versi mayor plugin yang sesuai dengan versi mayor Capacitor Anda (contoh: plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang masih di-maintain.

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

Ya. Source code tersedia publik di GitHub pada https://github.com/Cap-go/capacitor-permissions/ dan package-nya gratis diinstall dari npm. Laporan bug dan pull request sangat diterima.

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

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

Rilis perubahan Permissions tanpa menunggu review aplikasi

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

Mulai dengan Capgo