Primeros pasos

Inicio rápido

bun add @capgo/capacitor-plus
npx cap sync

Errores comunes

• Reemplaza todas las dependencias @capacitor/*.
• Regenera los proyectos nativos tras la migración.
• Lee las notas de la versión antes de actualizar.

Instalación en un proyecto nuevo

Puedes usar nuestro Setup asistido por IA para instalar Capacitor. Añade las capacidades de Capgo a tu herramienta de IA con este comando:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Luego usa el siguiente prompt:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capacitor-plus/core`, `@capacitor-plus/cli`, `@capacitor-plus/android`, and `@capacitor-plus/ios` packages in my project.

Si prefieres el Setup manual, instala los paquetes ejecutando estos comandos y sigue las instrucciones específicas de cada plataforma:

1. Instalar los paquetes core

   npm install @capacitor-plus/core @capacitor-plus/cli

2. Añadir paquetes de la plataforma

   npm install @capacitor-plus/android  # for Android
   npm install @capacitor-plus/ios      # for iOS

3. Inicializar Capacitor

   npm

   npx cap init

   pnpm

   pnpm cap init

   yarn

   yarn cap init

   bun

   bunx cap init

4. Añadir plataformas

   npm

   npx cap add android

   pnpm

   pnpm cap add android

   yarn

   yarn cap add android

   bun

   bunx cap add android

   npm

   npx cap add ios

   pnpm

   pnpm cap add ios

   yarn

   yarn cap add ios

   bun

   bunx cap add ios

Migración desde el Capacitor oficial

Si ya tienes un proyecto Capacitor existente, migrar a Capacitor+ es muy sencillo:

1. Elimina los paquetes oficiales

   npm uninstall @capacitor/core @capacitor/cli @capacitor/android @capacitor/ios

2. Instala los paquetes Capacitor+

   npm install @capacitor-plus/core @capacitor-plus/cli
   npm install @capacitor-plus/android  # if using Android
   npm install @capacitor-plus/ios      # if using iOS

3. Sincroniza tu proyecto

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

Nota

¡No se requieren cambios en code! Capacitor+ tiene la misma API que los Capacitor oficiales. Tus imports y code siguen siendo exactamente iguales.

Uso

Como Capacitor+ es compatible con API, tu code actual funciona sin cambios:

import { Capacitor } from '@capacitor/core';
import { registerPlugin } from '@capacitor/core';

// Check platform
const platform = Capacitor.getPlatform();
console.log('Running on:', platform);

// Check if native
if (Capacitor.isNativePlatform()) {
  console.log('Running on native platform');
}

// Register a custom plugin
const MyPlugin = registerPlugin('MyPlugin');

Con los plugins oficiales de Capacitor

Todos los plugins oficiales de Capacitor funcionan sin problemas:

import { Camera, CameraResultType } from '@capacitor/camera';
import { Geolocation } from '@capacitor/geolocation';
import { Storage } from '@capacitor/preferences';

// Camera
const photo = await Camera.getPhoto({
  quality: 90,
  resultType: CameraResultType.Uri
});

// Geolocation
const position = await Geolocation.getCurrentPosition();

// Storage
await Storage.set({ key: 'name', value: 'John' });

Con los plugins de Capgo

Los plugins de Capgo funcionan perfecto con Capacitor+:

import { CapacitorUpdater } from '@capgo/capacitor-updater';
import { ScreenOrientation } from '@capgo/capacitor-screen-orientation';
import { CapacitorFlash } from '@capgo/capacitor-flash';

// Live updates
await CapacitorUpdater.notifyAppReady();

// Screen orientation
await ScreenOrientation.lock({ orientation: 'portrait' });

// Flashlight
await CapacitorFlash.toggle();

Cómo funciona la sincronización

┌─────────────────────┐     ┌──────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  ionic-team/        │     │  CI/CD           │     │  Claude Code     │     │  npm publish    │
│  capacitor          │────▶│  Pipeline        │────▶│  Security Review │────▶│  @capacitor-plus│
│  (upstream)         │     │  (daily sync)    │     │  (AI analysis)   │     │  packages       │
└─────────────────────┘     └──────────────────┘     └──────────────────┘     └─────────────────┘

1. Daily Sync: Las acciones de GitHub obtienen los últimos cambios de ionic-team/capacitor
2. Creación de PR: Los cambios se proponen como pull requests al plus rama
3. Validación de CI: Se ejecuta la suite de tests (lint, unit tests, iOS build, Android build)
4. Revisión de seguridad: El análisis con IA busca vulnerabilidades y breaking changes
5. Auto-Merge: Solo si el CI pasa Y la revisión de seguridad aprueba
6. Auto-publicar: Nueva versión publicada en npm bajo @capacitor-plus/*

Detalles de la revisión de seguridad

Cada sincronización upstream se analiza para detectar:

Verificar	Lo que detecta
Seguridad	Inyección de comandos, XSS, path traversal, secretos hardcodeados
Cambios importantes	APIs eliminadas/renombradas, cambios de firma, cambios de configuración
Estabilidad	Desreferencias de null, excepciones no controladas, race conditions, memory leaks
Seguridad de datos	Pérdida de datos, violaciones de privacidad, almacenamiento inseguro
Integridad de Code	code ofuscado, llamadas de red sospechosas, backdoors

Precaución

Si se detectan problemas, el PR se marcará para revisión manual y NO se fusionará automáticamente. Así garantizamos releases estables y seguras.

Envío de tu PR

¿Tienes un PR atascado en el repo oficial de Capacitor? Logra que se fusione en Capacitor+:

1. Abrir un issue en la Repo Capacitor+ vinculando tu PR upstream

2. O envíalo directamente como un PR a plus rama

3. El equipo revisará, ejecutará el CI y hará el merge si pasa

Así tú y otros podréis beneficiaros de tu trabajo de inmediato sin esperar al ciclo de release oficial.

FAQ

¿Está listo para producción?

Sí. Capacitor+ se usa en apps de producción. Cada release pasa la misma suite de tests que Capacitor oficial, más un análisis de seguridad adicional.

¿Seguirán funcionando mis plugins oficiales?

Sí. Todos @capacitor/* los plugins funcionan con Capacitor+ sin configuración adicional.

¿Qué pasa si el upstream lanza un breaking change?

La revisión de seguridad con IA marca los breaking changes para revisión manual. Verás los cambios documentados antes de que se fusionen.

¿Cómo reporto problemas?

Reporta problemas en el repo de Capacitor+ GitHub. Para problemas que también afecten a Capacitor oficial, ayudaremos a coordinar con el upstream.

¿Puedo contribuir?

¡Por supuesto! Los PR son bienvenidos. Puedes enviar correcciones directamente o pedir que se fusionen PRs concretos de upstream.

Continúa desde Getting Started

Si estás usando Primeros pasos para planificar el trabajo con plugins nativos, conéctalo con Usando paquetes Capacitor+ (@capacitor-plus) para la capacidad nativa en el uso de paquetes Capacitor+ (@capacitor-plus), Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para el detalle de implementación en los Plugins de Capacitor por Capgo, Añadir o actualizar plugins para el detalle de implementación en Agregar o actualizar plugins, y Alternativas a plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas a plugins de Ionic Enterprise.