Saltar al contenido principal
Capgo logo
Volver a plugins
@capacitor-plus/core
Tutoriales
por github.com/Cap-go

Capacitor+ Core

Capacitor+ es una bifurcación automática, siempre sincronizada de Capacitor con PRs de la comunidad fusionados y lanzamientos rápidos

Descargas/semana

687

GitHub Estrellas

17

Guía

Tutorial sobre Capacitor+ Core

Usando Capacitor+ (@capacitor-plus) Paquetes

Capacitor+ es un fork automático, siempre sincronizado de Capacitor mantenido por CapgoProporciona una sustitución directa de los paquetes oficiales Capacitor con una ventaja clave: Las PR 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 - 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. Fusión de PR de Forks - Las PR valiosas 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 @capacitor-plus ámbito
  4. Comunidad-Primero - Sus contribuciones importan y se priorizan
  5. Revisado por la Seguridad - Cada cambio se analiza con 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

Migración desde Oficiales Capacitor

Para migrar un proyecto existente desde 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: Una Acción GitHub recupera los últimos cambios desde ionic-team/capacitor
  2. : Los cambios se proponen como solicitudes de extracción aCreación de PR 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 para:
    • Vulnerabilidades de seguridad (inyección, XSS, etc.)
    • Cambios que rompen API
    • Riesgos de errores 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. 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:

Verificar Descripción
Seguridad Inyección de comandos, XSS, travesía de rutas, secretos codificados, etc.
Cambios Interrumpidos APIs eliminadas/renombradas, firmas de cambios, cambios en el formato de configuración
Estabilidad Referencias a null, excepciones no manejadas, condiciones de carrera, fugas de memoria
Seguridad de Datos Escenarios de pérdida de datos, violaciones de privacidad, almacenamiento inseguro
Code Integridad Integridad code oculta, llamadas de red sospechosas, puertas traseras

Si se detectan cualquier problema, el PR se marca 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. Abrir un problema en el Capacitor+ repositorio vinculando a tu PR upstream
  2. O enviar el PR directamente Hasta la 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 lanzamiento upstream.

Beneficios

  • Obtén PRs Bloqueados Ahora: Se fusionan arreglos y características de la comunidad que están esperando upstream
  • Está al Día: Recibe arreglos upstream tan pronto como pasan CI
  • Seguridad Primero: Cada cambio se revisa por vulnerabilidades y riesgos de estabilidad
  • Releases Verificadas: Solo se publican los cambios que pasan tanto las pruebas de CI como la revisión de seguridad de IA
  • Reemplazo en Lugar: Same API as Capacitor, just a different package scope
  • Tu Voz Importa: Presenta 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' });

¡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 plugin nativo, conecte 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.