Saltar al contenido principal
Volver a plugins
@capacitor-plus/core
Tutorial
@capacitor-plus/core

Capacitor+ Core

Capacitor+ es una copia automática y sincronizada de Capacitor con PRs de la comunidad fusionados y lanzamientos rápidos

Guía

Tutoriales sobre Capacitor+ Core

Usando paquetes Capacitor+ (@capacitor-plus)

Capacitor+ es una copia automática y siempre sincronizada de Capacitor mantenida por Capgo. Proporciona una sustitución directa para los paquetes oficiales Capacitor con una ventaja clave: Las PR de la comunidad y las correcciones se fusionan 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.

Capacitor+ resuelve este problema mediante:

  1. Fusionar PR de Forks - Las PR valiosas que se encuentran atascadas 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 a npm bajo el ámbito @capacitor-plus scope
  4. Comunidad-Primero - 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 Tiempo de ejecución 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

Luego inicie su proyecto:

npx cap init
npx cap add android
npx cap add ios

Migrar desde Oficiales Capacitor

Para migrar un proyecto existente desde los oficiales 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: Un Acción GitHub obtiene 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 CI: Se ejecuta completa suite de pruebas (lint, pruebas unitarias, iOS build, Android build)
  4. Revisión de Claude Code: Análisis de seguridad integral impulsado por IA verifica:
    • Vulnerabilidades de seguridad (inyección, XSS, etc.)
    • Cambios que rompen API
    • Riesgos de crash 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

Todos los sincronizaciones de upstream se analizan para:

Verificar Descripción
Seguridad contexto: Página/área: Página de producto de empresa/precio. Rol: Etiqueta de interfaz de usuario. Visto en: página enterprise.astro. Clave de mensaje `enterprise_hero_security_label` (Etiqueta de seguridad de héroe de empresa).
Inyección de comandos, XSS, travesía de rutas, secretos de código fijo, etc. Cambios de ruptura
Eliminadas/renombradas APIs, firmas cambiadas, cambios en el formato de configuración Estabilidad
contexto: Página/área: Página de producto de empresa/precio. Rol: Etiqueta de interfaz de usuario. Visto en: página enterprise.astro. Clave de mensaje `enterprise_hero_stability_label` (Etiqueta de estabilidad de héroe de empresa). Escenarios de pérdida de datos, violaciones de privacidad, almacenamiento inseguro
Code Integridad code obfuscado, llamadas de red sospechosas, puertas traseras

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

¿Quieres que se fusionen tus PR?

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

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

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

Beneficios

  • contextPágina/área: página de marketing de soluciones de Capgo. Rol: etiqueta de interfaz de usuario. Visto en: página solutions/cordova-to-capacitor.astro. Clave de mensaje `solutions_cordova_to_capacitor_benefits_label` (Etiqueta de beneficios de Cordova a Capacitor).
  • PRs Bloqueados Ahora: Arreglos y características de la comunidad que están esperando upstream se fusionan
  • Actualizado: Recibe arreglos upstream tan pronto como pasan las pruebas de CI
  • Seguridad Primero: Cada cambio se revisa por vulnerabilidades y riesgos de estabilidad
  • Sustitución de Reemplazo en Línea: Same API as Capacitor, just a different package scope
  • Tu Voz Importa: Presenta tus propias PRs o solicita PRs específicas de upstream para que se fusionen

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! 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 plugins nativos, conecta 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.