Saltar al contenido principal
@capgo/capacitor-permissions API de dispositivos Código abierto

Permisos plugin Capacitor

Comprueba y solicita permisos en tiempo de ejecución en iOS, Android y web con un único enum PermissionName y códigos de estado normalizados

Instalar

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

Guía

Cómo usar Permissions en Capacitor

Uso de @capgo/capacitor-permissions

Un API de TypeScript para consultar y solicitar permisos en tiempo de ejecución en iOS, Android y web con códigos de estado normalizados.

Instalar

bun add @capgo/capacitor-permissions
bunx cap sync

Lo que expone este plugin

  • check - Leer el estado actual de un permiso sin mostrar un prompt.
  • request - Solicitar un permiso al usuario.
  • checkMultiple - Verificar varios permisos sin mostrar un prompt.
  • requestMultiple - Solicitar varios permisos secuencialmente.
  • shouldShowRationale - Si Android debe mostrar una justificación antes de solicitar de nuevo.
  • openSettings - Abrir la configuración de la aplicación o las notificaciones cuando el acceso está bloqueado.
  • requestPreciseLocation - Actualizar a ubicación precisa en iOS y ubicación fina en Android.
  • getPluginVersion - Devuelve el marcador de versión de la implementación de la plataforma.

Ejemplo de uso

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

Referencia completa

FAQ

FAQ del plugin de permisos

¿Cómo instalo el plugin de Permissions en una app de Capacitor?

Ejecuta "bun add @capgo/capacitor-permissions" (o "npm install @capgo/capacitor-permissions") y luego "bunx cap sync" para que los proyectos de iOS y Android incorporen el código nativo code. Impórtalo desde "@capgo/capacitor-permissions" en el code de tu app.

¿Funciona @capgo/capacitor-permissions con React, Vue y Angular?

Sí. Permissions es un paquete de Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluido Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor soporta @capgo/capacitor-permissions?

Los plugins de Capgo siguen la versión mayor de Capacitor: usa la versión mayor del plugin que coincida con la versión mayor de tu Capacitor (por ejemplo, el plugin v8 con Capacitor 8). La tabla de compatibilidad del README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-permissions gratuito y de código abierto?

Sí. El code está publicado en GitHub en https://github.com/Cap-go/capacitor-permissions/ y el paquete se instala gratis desde npm. Se aceptan informes de errores y pull requests.

¿Puedo actualizar code que usa Permissions sin una revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

Lanza cambios de permisos sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo