@Capacitor+ Core

Usando Capacitor+ (@capacitor-plus) Paquetes

Capacitor+ es un fork automático y siempre sincronizado de Capacitor mantenido por Capgo. Ofrece una sustitución de reemplazo para los paquetes oficiales de Capacitor con una ventaja clave: las PRs y correcciones de la comunidad se integran más rápido.

¿Por qué Capacitor+ existe

La equipe de Ionic mantiene Capacitor con sus propias prioridades y calendario de lanzamiento. Esto significa que las contribuciones de la comunidad - correcciones de errores, mejoras y características - pueden esperar meses o incluso años para ser fusionadas. Algunas nunca llegan a hacerlo.

Capacitor+ resuelve este problema de la siguiente manera:

1. Fusionar PRs de Forks - Los PRs valiosos que se encuentran atascados 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. Primero la Comunidad - Sus contribuciones importan y se priorizan
5. Revisado de 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 inicia tu proyecto:

npx cap init
npx cap add android
npx cap add ios

Migrating from Official Capacitor

To migrate an existing project from official Capacitor to 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

Since Capacitor+ is a drop-in replacement with the same API, no code changes are required. Your imports remain the same:

// 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: A GitHub Action fetches the latest changes from ionic-team/capacitor
2. Creación de PR: Los cambios se proponen como solicitudes de cambio 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 que verifica:
   • Vulnerabilidades de seguridad (inyección, XSS, etc.)
   • Cambios que rompen API
   • Riesgos de caídas y problemas de estabilidad
   • Preocupaciones de integridad y privacidad de datos
   • Patrones maliciosos de code
5. Auto-Merge: Solo si CI pasa y Claude aprueba (sin problemas detectados)
6. Auto-Publish: Una nueva versión se publica en npm bajo @capacitor-plus/*

Revisión de Seguridad

Cada sincronización upstream se analiza por:

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

¿Quiere que se fusionen sus PR?

¿Tiene un PR atascado en el repositorio oficial Capacitor? Aquí está cómo hacer que se integre en Capacitor+:

1. Abrir un problema en el Capacitor+ repo vinculando a su PR upstream
2. O enviar el PR directamente al plus rama
3. El equipo lo revisará, ejecutará CI y lo fusionará si pasa

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

Ventajas

• BeneficiosPRs Bloqueados Ahora
• Fijaciones de la Comunidad AhoraMantente Actualizado
• Fijaciones de la Comunidad AhoraSeguridad Primero
• Releases VerificadosSustitución de Inserción
• Lo mismo que __CAPGO_KEEP_1__, pero con un ámbito de paquete diferente: Same API as Capacitor, just a different package scope
• Tu voz importa: Envía tus propias solicitudes de cambios o solicita que se integren solicitudes de cambios específicas de upstream

Example: Usando Capacitor+ con Plugins

Todos los plugins oficiales 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 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' });

¡Eso es todo! Ahora tienes una versión actualizada más rápida de Capacitor con mejoras de la comunidad integradas 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 plugins nativos, conecta con Capacitor+ para los detalles de implementación en Capacitor+: Directorio de Plugins Capgo para el flujo de trabajo del producto en Directorio de Plugins Capgo Plugins de Capgo en Capacitor para el detalle de implementación en Plugins de Capgo en Capacitor Agregar o Actualizar Plugins para el detalle de implementación en Agregar o Actualizar Plugins, y Alternativas de Plugins de Empresa Ionic para el flujo de trabajo del producto en Alternativas de Plugins de Empresa Ionic.