Saltar al contenido principal
@capacitor-plus/core Herramientas para desarrolladores Código abierto

Capacitor+ Core plugin Capacitor

Capacitor+ es un fork automatizado y siempre sincronizado de Capacitor, con PRs de la comunidad mergeados y lanzamientos rápidos

Instalar

bun add @capacitor-plus/core bunx cap sync
npm, pnpm o yarn
  • npm install @capacitor-plus/core
  • pnpm add @capacitor-plus/core
  • yarn add @capacitor-plus/core

Guía

Cómo usar Capacitor+ Core en Capacitor

Usando paquetes Capacitor+ (@capacitor-plus)

Capacitor+ es un fork automatizado y siempre sincronizado de Capacitor mantenido por Capgo. Ofrece un reemplazo directo para los paquetes oficiales de Capacitor con una ventaja clave: Los PRs y fixes de la comunidad se fusionan más rápido.

Por qué existe Capacitor+

El equipo de Ionic mantiene Capacitor con sus propias prioridades y calendario de lanzamientos. Esto significa que las contribuciones de la comunidad (correcciones de errores, mejoras y funciones) pueden esperar meses o incluso años para ser fusionadas. Algunas nunca llegan a integrarse.

Capacitor+ resuelve este problema mediante:

  1. Fusión de PRs desde Forks - Los PRs valiosos atascados en la cola upstream se fusionan activamente
  2. Sincronización continua - Cada cambio desde el upstream de Capacitor se obtiene, prueba y verifica automáticamente
  3. Lanzamientos rápidos - Cuando los cambios pasan CI, se publican automáticamente en npm bajo el @capacitor-plus alcance
  4. Comunidad primero - Tus contribuciones importan y se priorizan
  5. Revisión de seguridad - La IA analiza cada cambio en busca de vulnerabilidades de seguridad, breaking changes y riesgos de estabilidad

Paquetes disponibles

Paquete Descripción
@capacitor-plus/core Biblioteca principal del runtime
@capacitor-plus/cli Interfaz de línea de comandos
@capacitor-plus/android Runtime de Android
@capacitor-plus/ios Runtime de iOS

Instalación

Nuevo proyecto

Para un proyecto nuevo, simplemente usa 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 inicializa tu proyecto:

npx cap init
npx cap add android
npx cap add ios

Migración desde el Capacitor oficial

Para migrar un proyecto existente del Capacitor oficial 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

Como Capacitor+ es un reemplazo directo con la misma API, no se requieren cambios en code. Tus imports no cambian:

// 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. Daily Sync: Una acción de GitHub obtiene 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 CI: Se ejecuta la suite de pruebas completa (lint, pruebas unitarias, build de iOS, build de Android)
  4. Revisión de Claude Code: Análisis de seguridad exhaustivo impulsado por IA que verifica:
    • Vulnerabilidades de seguridad (inyección, XSS, etc.)
    • Cambios de API que rompen compatibilidad
    • Riesgos de crash y problemas de estabilidad
    • Integridad de datos y preocupaciones de privacidad
    • Patrones de code maliciosos
  5. Auto-Merge: Solo si la CI pasa Y Claude aprueba (sin problemas detectados)
  6. Auto-publicar: Se publica una nueva versión en npm bajo @capacitor-plus/*

Revisión de seguridad

Cada sincronización upstream se analiza para detectar:

Verificar Descripción
Seguridad Inyección de comandos, XSS, path traversal, secretos hardcodeados, etc.
Cambios importantes APIs eliminadas o renombradas, firmas modificadas, cambios en el formato de config
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

Si se detecta algún problema, el PR se marcará para revisión manual y NO se fusionará automáticamente.

¿Quieres que fusionen tu PR?

¿Tienes un PR estancado en el repo oficial de Capacitor? Así es como puedes llevarlo a Capacitor+:

  1. Abrir un issue en la Repo Capacitor+ vinculando tu PR upstream
  2. O envía el PR directamente al plus rama
  3. El equipo lo revisará, ejecutará el CI y hará merge si pasa

Así, tú y los demás podréis beneficiaros de tu trabajo de inmediato, sin esperar al ciclo de release upstream.

Beneficios

  • Desatasca PRs ahora: Se integran los fixes y las features de la comunidad que esperan upstream
  • Mantente al día: Recibe fixes upstream en cuanto pasen el CI
  • Seguridad ante todo: Cada cambio se revisa en busca de vulnerabilidades y riesgos de estabilidad
  • Releases verificados: Solo se publican los cambios que pasan las pruebas de CI Y la revisión de seguridad con IA
  • Reemplazo directo: El mismo API que Capacitor, solo con un scope de paquete distinto
  • Tu opinión cuenta: Envía tus propios PRs o pide que se mergeen PRs concretos de upstream

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' });

¡Eso es todo! Ya tienes una versión de Capacitor que se actualiza más rápido y con las mejoras de la comunidad integradas antes. Tus apps se beneficiarán de los bug fixes y las nuevas features sin esperar al ciclo de release oficial.

Continuar con Usando paquetes Capacitor+ (@capacitor-plus)

Si estás usando Usando paquetes Capacitor+ (@capacitor-plus) para planificar el trabajo con plugins nativos, conéctalo con Capacitor+ para el detalle de implementación en Capacitor+, 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.

FAQ

Preguntas frecuentes del plugin Capacitor+ Core

¿Cómo instalo el plugin Capacitor+ Core en una app Capacitor?

Ejecuta "bun add @capacitor-plus/core" (o "npm install @capacitor-plus/core"), luego ejecuta "bunx cap sync" para que los proyectos de iOS y Android detecten el code nativo. Impórtalo desde "@capacitor-plus/core" en el code de tu app.

¿Funciona @capacitor-plus/core con React, Vue y Angular?

Sí. Capacitor+ Core es un paquete Capacitor, así que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluidos Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor soporta @capacitor-plus/core?

Los plugins de Capgo siguen la versión mayor de Capacitor: usa la versión mayor del plugin que coincida con la versión mayor de tu Capacitor (por ejemplo, el plugin v8 con Capacitor 8). La tabla de compatibilidad del README de GitHub lista las versiones mantenidas.

¿@capacitor-plus/core es gratis y open source?

Sí. El código fuente de code es público en GitHub en https://github.com/Cap-go/capacitor-plus/ y el paquete se instala gratis desde npm. Los reportes de bugs y pull requests son bienvenidos.

¿Puedo actualizar code que usa Capacitor+ Core sin una revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

Lanza cambios de Capacitor+ Core sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo