Capacitor+ Core

Usando Capacitor+ (@capacitor-plus) Paquetes

Capacitor+ es un fork automático, siempre sincronizado de Capacitor mantenido por Capgo. Proporciona una reemplazo en lugar para los paquetes oficiales Capacitor con una ventaja clave: PRs y arreglos de la comunidad se fusionan más rápido.

¿Por qué Capacitor+ existe?

El equipo de Ionic mantiene Capacitor con sus propias prioridades y calendario de lanzamiento. Esto significa que las contribuciones de la comunidad - arreglos de errores, mejoras y características - pueden esperar meses o incluso años para ser fusionadas. Algunos nunca lo logran.

Capacitor+ resuelve este problema de la siguiente manera:

1. Fusionar PRs de Forks - Los PRs valiosos que se quedan en la cola de upstream se fusionan activamente
2. Sincronización Continua - Cada cambio de upstream Capacitor se extrae automáticamente, se prueba y se verifica
3. Lanzamientos Rápidos - Cuando los cambios pasan por CI, se publican automáticamente en npm bajo el @capacitor-plus scope
4. Comunidad-Primero - Sus contribuciones importan y se priorizan
5. Revisado por Seguridad - Cada cambio se analiza con IA para vulnerabilidades de seguridad, cambios que rompen y riesgos de estabilidad

Paquetes Disponibles

Instalación

Nuevo Proyecto

Para un nuevo proyecto, simplemente utilice los paquetes Capacitor+ en lugar de los oficiales:

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

Luego inicialice su proyecto:

npx cap init
npx cap add android
npx cap add ios

Migración desde Oficial Capacitor

Para migrar un proyecto existente desde el oficial Capacitor a Capacitor+:

# Remove official packages
npm uninstall @capacitor/core @capacitor/cli @capacitor/android @capacitor/ios

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

Dado que Capacitor+ es un reemplazo de bajo nivel con el mismo API, no se requieren cambios en code. Sus importaciones permanecen iguales:

// These imports work the same with Capacitor+
import { Capacitor } from '@capacitor/core';
import { registerPlugin } from '@capacitor/core';

Cómo Funciona

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

1. Sincronización Diaria: Una acción GitHub obtiene los últimos cambios desde ionic-team/capacitor
2. Creación de PR: Se proponen cambios como solicitudes de extracción a la 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 Claude Code: Análisis de seguridad integral impulsado por inteligencia artificial verifica:
   • Vulnerabilidades de seguridad (inyección, XSS, etc.)
   • Cambios que rompen API
   • Riesgos de colapso y problemas de estabilidad
   • Preocupaciones de integridad de datos y privacidad
   • Patrones maliciosos de code
5. Auto-Merge: Solo si CI pasa Y Claude aprueba (sin problemas detectados)
6. Publicación automática: Una nueva versión se publica en npm bajo @capacitor-plus/*

Revisión de seguridad

Cada sincronización upstream se analiza para:

Si se detectan cualquier problema, el PR se marcará para revisión manual y NO se fusionará automáticamente.

¿Quieres que se fusionen tus PR?

¿Tienes un PR atascado en el repositorio oficial de Capacitor? Aquí te mostramos cómo hacer que se integre en Capacitor+:

1. Abre una incidencia en el Capacitor+ repositorio vinculando a tu PR upstream
2. O envíe la PR directamente a la plus rama
3. El equipo la revisará, ejecutará CI y la fusionará si pasa

De esta manera, usted y otros pueden beneficiarse de su trabajo de inmediato, sin tener que esperar al ciclo de liberación upstream.

Beneficios

• Obtenga PRs bloqueados ahora: Se fusionan arreglos y características de la comunidad que están esperando upstream
• Esté al Día: Obtenga arreglos upstream tan pronto como pasen CI
• Seguridad Primero: Cada cambio se revisa por vulnerabilidades y riesgos de estabilidad
• Releases VerificadasSolo se publican cambios que pasan tanto las pruebas de CI como la revisión de seguridad de IA
• Sustitución de InserciónLo mismo que API que Capacitor, solo con un ámbito de paquete diferente
• Tu Voz ImportaPresenta tus propias PRs o solicita que se fusionen PRs upstream específicas

Ejemplo: Usando Capacitor+ con Plugins

Todos los plugins oficiales de Capacitor funcionan sin problemas con Capacitor+:

import { Capacitor } from '@capacitor/core';
import { Camera, CameraResultType } from '@capacitor/camera';
import { Geolocation } from '@capacitor/geolocation';

// Everything works exactly the same
const platform = Capacitor.getPlatform();

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

const position = await Geolocation.getCurrentPosition();

Los plugins de Capgo también funcionan perfectamente con Capacitor+:

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

// Use Capgo plugins with Capacitor+
await CapacitorUpdater.notifyAppReady();
await ScreenOrientation.lock({ orientation: 'portrait' });

¡Listo! Ahora tienes una versión actualizada más rápida de Capacitor con mejoras de la comunidad fusionadas más rápido. Tus aplicaciones se beneficiarán de correcciones de errores y características sin tener que esperar al ciclo de lanzamiento oficial.

Sigue adelante desde Usando Capacitor+ (@capacitor-plus) Paquetes

Si estás utilizando Usando Capacitor+ (@capacitor-plus) Paquetes para planificar el trabajo de plugin nativo, conectarlo con Capacitor+ para los detalles de implementación en Capacitor+, Capgo Directorio de Plugins para el flujo de trabajo del producto en Capgo Directorio de Plugins, Capacitor Plugins por Capgo para los detalles de implementación en Capacitor Plugins por Capgo, Agregar o Actualizar Plugins para los detalles 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.