Inicio rápido

Instalación de Proyecto Nuevo

Puede utilizar nuestra configuración asistida por IA para instalar Capacitor+. Agregue las Capgo habilidades a su herramienta de IA utilizando el siguiente comando:

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

Luego utilice la siguiente solicitud:

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 prefiere la configuración manual, instale los paquetes ejecutando los siguientes comandos y siguiendo las instrucciones específicas de la plataforma a continuación:

1. Instale paquetes básicos

   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 Capacitor existente, migrar a Capacitor+ es sencillo:

1. Eliminar paquetes oficiales

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

2. Instalar Capacitor+ paquetes

   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 se requieren cambios en code! Capacitor+ tiene el mismo API que la versión oficial de Capacitor. Sus importaciones y code permanecen exactamente iguales.

Uso

Dado que Capacitor+ es API-compatible, su code existente 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 Plugins Oficiales Capacitor

Todos los plugins oficiales 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 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. Sync Diario: GitHub Acciones sincronizan cambios más recientes desde ionic-team/capacitor
2. Creación de PR: Se proponen cambios como solicitudes de extracción 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 de inteligencia artificial verifica vulnerabilidades y cambios que rompen la compatibilidad
5. Auto-Merge: Solo si CI pasa y la revisión de seguridad aprueba
6. Publicación Automática: Nueva versión publicada en npm bajo @capacitor-plus/*

Detalles de Revisión de Seguridad

Se analiza cada sincronización upstream para:

Verificar	¿Qué Captura?
Seguridad	Inyección de comandos, XSS, travesía de rutas, secretos codificados
Cambios de ruptura	Eliminados/renombrados APIs, cambios en firmas, cambios en la configuración
Estabilidad	Referencias nulas, 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

Cuidado

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

Enviar su PR

Tiene un PR atascado en el repositorio oficial de Capacitor? ¡Obtenga que se fusiona en Capacitor+:

1. Abrir una incidencia en el Capacitor+ repositorio Enlace 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 todavía?

Sí. Todos @capacitor/* los plugins funcionan con Capacitor+ de forma predeterminada.

¿Qué pasa si se libera un cambio de ruptura en la fuente?

La revisión de seguridad por inteligencia artificial marca los cambios de ruptura para una revisión manual. Verá los cambios documentados antes de que se fusionen.

¿Cómo puedo informar problemas?

Registre problemas en el Capacitor+ GitHub repo. Para problemas que también afectan a los Capacitor oficiales, ayudaremos a coordinar la fuente.

¿Puedo contribuir?

¡Absolutamente! Se aceptan PRs. Puede enviar correcciones directamente o solicitar que se fusionen PRs específicas de upstream.

Sigue adelante desde Getting Started

Si estás utilizando Getting Started para planificar el trabajo de plugin nativo, conectalo con Usando Capacitor+ (@capacitor-plus) Paquetes para la capacidad nativa en Usando Capacitor+ (@capacitor-plus) Paquetes, Capgo Directorio de Plugin para el flujo de trabajo del producto en Capgo Directorio de Plugin, Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, Agregar o Actualizar Plugins para el detalle de implementación en Agregar o Actualizar Plugins, y Alternativas de Plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas de Plugins de Ionic Enterprise.