Saltar al contenido principal
@capacitor-plus/core Herramientas de Desarrollador Fuente abierta

Capacitor+ Núcleo plugin de Capacitor

Capacitor+ es una copia automática y sincronizada de Capacitor con PRs de la comunidad fusionados 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 Capacitor+ (@capacitor-plus) Paquetes

Capacitor+ es un fork automático y siempre sincronizado de Capacitor mantenido por Capgo.It proporciona una sustitución directa para los paquetes oficiales Capacitor con una ventaja clave: la comunidad puede fusionar PRs y correcciones 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 - correcciones de errores, mejoras y características - pueden esperar meses o incluso años para ser fusionadas. Algunas nunca llegan.

Capacitor+ solves this problem by:

  1. Fusionar PRs de Forks - Los PRs valiosos que se encuentran atascados en la cola de upstream se fusionan activamente
  2. Sync Continuo - Cada cambio desde Capacitor se extrae automáticamente, se prueba y se verifica
  3. Releases Rápidos - Cuando los cambios pasan por CI, se publican automáticamente en npm bajo el @capacitor-plus ámbito
  4. Community-First - Sus contribuciones importan y se priorizan
  5. Revisado por la Seguridad - Cada cambio se analiza por IA para vulnerabilidades de seguridad, cambios que rompen y riesgos de estabilidad

Paquetes Disponibles

Paquete Descripción
@capacitor-plus/core biblioteca de tiempo de ejecución central
@capacitor-plus/cli interfaz de línea de comandos
@capacitor-plus/android tiempo de ejecución de Android
@capacitor-plus/ios runtime de iOS

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

Entonces inicialice su proyecto:

npx cap init
npx cap add android
npx cap add ios

Migrar 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

Puesto que Capacitor+ es un reemplazo de bajo nivel con el mismo API, no se requieren cambios 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. Daily Sync: Una acción GitHub diaria recupera los cambios más recientes 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 CIEjecuta la suite de pruebas completa (lint, pruebas unitarias, compilación iOS, compilación Android)
  4. Revisión de Claude Code: Análisis de seguridad integral con inteligencia artificial busca:
    • Vulnerabilidades de seguridad (inyección, XSS, etc.)
    • Cambios que rompen API
    • Riesgos de bloqueo y problemas de estabilidad
    • Preocupaciones de integridad de datos y privacidad
    • Patrones maliciosos de code
  5. Auto-MergeSolo si CI pasa y Claude aprueba (sin problemas detectados)
  6. Auto-PublicarPublicar una nueva versión en npm bajo @capacitor-plus/*

Revisión de seguridad

Cada sincronización upstream se analiza para:

Verificar Descripción
Seguridad Inyección de comandos, XSS, travesía de rutas, secretos codificados, etc.
Cambios importantes Removed/renamed APIs, changed signatures, config format changes
Estabilidad Faltas de referencia, excepciones no gestionadas, condiciones de carrera, fugas de memoria
Seguridad de Datos Escenarios de pérdida de datos, violaciones de privacidad, almacenamiento inseguro
Code Integrity Código obfuscado code, llamadas de red sospechosas, puertas traseras

Si se detectan cualquier problema, el PR será marcado para revisión manual y NO será automáticamente fusionado.

¿Quieres que se acepte tu PR?

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

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

De esta manera, tú y otros podrán aprovechar tus contribuciones de inmediato, sin tener que esperar al ciclo de liberación upstream.

Beneficios

  • Obtener PRs bloqueados ahora: Arreglos y características de la comunidad que están esperando upstream se fusionan
  • Mantente actualizado: Obtenga correcciones de upstream tan pronto como pasen la CI
  • Seguridad Primero: Cada cambio se revisa para vulnerabilidades y riesgos de estabilidad
  • Releases Verificados:Sólo se publican los cambios que superan las pruebas de CI y la revisión de seguridad AI
  • Sustitución de ReemplazoIgual API que Capacitor, pero con un ámbito de paquete diferente
  • Tu Voz Importa: Envía tus propias PRs o solicita PRs upstream específicas para que se fusionen

Ejemplo: Usando Capacitor+ con Plugins

Todas las 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! 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 plugin nativo, conecta con Capacitor+ para los detalles de implementación en Capacitor+ Directorio de Plugins de Capgo para el flujo de trabajo del producto en Directorio de Plugins de Capgo Plugins de Capacitor por Capgo para los detalles de implementación en Plugins de Capacitor por Capgo Agregar o Actualizar Plugins para los detalles de implementación en la sección de Agregar o Actualizar Plugins, y Alternativas de Plugins de Ionic Enterprise para el flujo de trabajo del producto en Ionic Enterprise Plugin Alternatives.

FAQ

Capacitor+ Core plugin FAQ

¿Cómo instalo el plugin de núcleo Capacitor+ en una aplicación Capacitor?

Run "bun add @capacitor-plus/core" (or "npm install @capacitor-plus/core"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capacitor-plus/core" in your app code.

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

Yes. Capacitor+ Core is a Capacitor package, so it works with any web framework that runs inside Capacitor, including Ionic, React, Vue, Angular, Svelte and plain JavaScript.

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

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

¿Es @capacitor-plus/core de código abierto y gratuito?

Yes. La fuente code está pública en GitHub en https://github.com/Cap-go/capacitor-plus/ y el paquete es gratuito para instalar desde npm.

Puedo actualizar code que utiliza Capacitor+ Core sin una revisión de la Tienda de Aplicaciones?

Instalar o actualizar el complemento cambia el code nativo, por lo que necesita una nueva compilación de la tienda. Después de eso, los cambios de JavaScript, HTML y CSS que llaman al complemento pueden enviar con actualizaciones Capgo en vivo.

Envía cambios en el núcleo de Capacitor+ sin esperar a la revisión de la aplicación

Una vez que el plugin esté en tu tienda de construcción, Capgo actualizaciones en vivo envían cambios en JavaScript, HTML y CSS a los usuarios en minutos.

Comienza con Capgo