Saltar al contenido principal
@capgo/capacitor-permisos Dispositivos de API Fuente abierta

Permisos plugin de Capacitor

Verifique y solicite permisos de ejecución en iOS, Android y web con un 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 Permisos en Capacitor

Usando @capgo/capacitor-permissions

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

Instalar

bun add @capgo/capacitor-permissions
bunx cap sync

¿Qué se expone con este plugin?

  • check - Leer el estado actual de una permiso sin solicitar.
  • request - Solicitar una permiso al usuario.
  • checkMultiple - Verificar varias permisos sin solicitar.
  • requestMultiple - Solicitar varias permisos secuencialmente.
  • shouldShowRationale - ¿Debería Android mostrar una justificación antes de solicitar nuevamente?
  • openSettings - Abrir configuración de aplicación o notificaciones cuando el acceso está bloqueado.
  • requestPreciseLocation - Actualizar a ubicación precisa en iOS y ubicación fina en Android.
  • getPluginVersion - Devuelve la marca de versión de la implementación del 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 permisos en una aplicación Capacitor?

Run &quot;bun add @capgo/capacitor-permissions&quot; (o &quot;npm install @capgo/capacitor-permissions&quot;), luego ejecuta &quot;bunx cap sync&quot; para que los proyectos iOS y Android capturen los nativos code. Importa desde &quot;@capgo/capacitor-permissions&quot; en tu app code.

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

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

¿Cuál versión de Capacitor soporta @capgo/capacitor-permissions?

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

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

Sí. El código fuente de code está disponible en GitHub en https://github.com/Cap-go/capacitor-permissions/ y el paquete es gratuito para instalar desde npm. Se aceptan informes de errores y solicitudes de cambios.

Puedo actualizar code que utiliza Permissions sin una revisión de la Tienda?

Instalar o actualizar el plugin cambia los nativos code, por lo que necesita una nueva compilación del almacenamiento. Después de eso, los cambios en JavaScript, HTML y CSS que llaman al plugin pueden enviar instantáneamente con Capgo actualizaciones en vivo.

Envía cambios de permisos sin esperar a la revisión de la aplicación

Una vez que el plugin esté en tu tienda de construcción, Capgo actualizaciones en vivo envían los cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Inicia con Capgo