Iniciar

Nueva Instalación de Proyecto

1. Instalar paquetes de núcleo

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

2. Agregar paquetes de plataforma

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

3. Iniciar Capacitor

   npm

   npx cap init

   pnpm

   pnpm cap init

   yarn

   yarn cap init

   bun

   bunx cap init

4. Agregar 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

Migrando desde Oficial Capacitor

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

1. Eliminar paquetes oficiales

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

2. Instalar paquetes de 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. Sincronizar tu proyecto

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

Nota

No code cambios necesarios! Capacitor+ tiene las mismas API que la versión oficial de Capacitor. Sus importaciones y code permanecen exactamente iguales.

Uso

Since Capacitor+ is API-compatible, your existing code works without changes:

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 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 Capgo Plugins

Los plugins de Capgo funcionan perfectamente 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. Sincronización diaria: GitHub Acciones recuperan los últimos cambios desde ionic-team/capacitor
2. Creación de PR.: Se proponen cambios como solicitudes de cambio al plus rama
3. Validación de CI.: Se ejecuta el conjunto de pruebas completo (lint, pruebas unitarias, compilación de iOS, compilación de Android)
4. Revisión de seguridad: Análisis impulsado por inteligencia artificial verifica vulnerabilidades y cambios de ruptura
5. Auto-Merge: Solo si CI pasa Y la revisión de seguridad aprueba
6. Auto-Publish: Nueva versión publicada en npm bajo @capacitor-plus/*

Detalles de la Revisión de Seguridad

Cada sincronización upstream se analiza para:

Revisar	Qué Cae en la Red
Seguridad	Inyección de comandos, XSS, recorrido de rutas, secretos codificados
Cambios importantes	APIs eliminadas/reasignadas, cambios en las firmas, cambios en la configuración
Estabilidad	Referencias a null, excepciones no manejadas, condiciones de carrera, fugas de memoria
Seguridad de datos	Escenarios de pérdida de datos, violaciones de privacidad, almacenamiento inseguro
Code Integridad	Integridad de code oculta, llamadas de red sospechosas, puertas traseras

Precaución

Si se detectan cualquier problema, el PR se marca para revisión manual y NO se fusionará automáticamente. Esto asegura que siempre obtenga versiones estables y seguras.

Enviar su PR

¿Tienes un PR atascado en el repositorio oficial Capacitor? Obténlo fusionado en Capacitor+:

1. Abrir una incidencia en el Capacitor+ repo vinculando a tu PR upstream

2. O enviar directamente como un PR a la plus rama

3. El equipo revisará, ejecutará CI y fusionará si pasa

De esta manera, tú y otros podrán beneficiarse de tu trabajo de inmediato sin tener que esperar al ciclo de lanzamiento upstream.

Preguntas frecuentes

¿Está listo para producción?

Sí. Capacitor+ se utiliza en aplicaciones de producción. Cada lanzamiento pasa el mismo conjunto de pruebas que el Capacitor oficial, más un análisis de seguridad adicional.

¿Funcionarán mis plugins oficiales?

Sí. Todos los plugins funcionan con __CAPGO_KEEP_0__+ de forma nativa. @capacitor/* plugins work with Capacitor+ out of the box.

Sección titulada “¿Qué pasa si se libera una actualización que rompe la compatibilidad?”

¿Cómo puedo informar problemas?

Sección titulada “¿Cómo puedo informar problemas?”

Denuncie problemas en el Capacitor + GitHub repositorio. Para problemas que también afectan a Capacitor oficial, ayudaremos a coordinar upstream.

¿Puedo contribuir?

¡Absolutamente! Las PRs son bienvenidas. Puede enviar correcciones directamente o solicitar que se fusionen PRs específicas de upstream.