Guía de inicio de sesión de CLI

Vista rápida

La Capgo CLI proporciona una onboarding interactiva que configura actualizaciones en vivo para tu aplicación Capacitor. Tendrás:

1. ✅ Registra tu aplicación en Capgo
2. 🔌 Instale y configure el plugin de actualización
3. 🚀 Despliegue su primera actualización en vivo
4. 📱 Pruebe la actualización en su dispositivo

Tiempo estimado: 10-20 minutos (varía según su velocidad de conexión a Internet y tiempo de compilación)

Consejo

El proceso de incorporación se puede reanudar completamente - salir en cualquier momento y continuar más tarde desde donde lo dejó.

Iniciando el proceso de incorporación

Ejecute la orden de inicio de sesión con su clave API:

npx @capgo/cli@latest init [APIKEY]

Verá el mensaje de bienvenida:

Capgo onboarding 🛫

¿Qué sucede durante la incorporación?

El CLI le guiará a través de 13 pasos interactivos:

Fase de configuración (Pasos 1-6):

• Verifique su entorno de desarrollo (Xcode/Android Studio)
• Agregue su aplicación a Capgo y cree un canal de producción
• Instale el @capgo/capacitor-updater plugin
• Inyecte el code requerido en su aplicación
• Opcionalmente, habilite la cifrado de extremo a extremo
• Elija una plataforma para realizar pruebas (iOS o Android)

Fase de pruebas (Pasos 7-12):

• Construya su aplicación y ejecútela en un dispositivo/simulador
• Haga un cambio visible code (automático o manual)
• Suba el paquete actualizado a Capgo
• Vea la actualización en vivo aparecer en su dispositivo en tiempo real

Compleción (Paso 13):

• Su aplicación está lista para actualizaciones en vivo!

El Proceso de Incorporación de 13 Pasos

Paso 1: Verifique los requisitos previos

El CLI verifica su entorno de desarrollo para asegurarse de que tenga las herramientas necesarias instaladas.

¿Qué se verifica:

• Xcode (solo macOS) - para el desarrollo de iOS
• Android SDK - para el desarrollo de Android

Posibles resultados:

✅ Se encontraron ambos entornos:

✅ Xcode detected - iOS development ready
✅ Android SDK detected - Android development ready

⚠️ No se encontró ningún entorno:

⚠️ Xcode not found
⚠️ Android SDK not found
❌ No development environment detected

📱 To develop mobile apps with Capacitor, you need:
   • For iOS: Xcode (macOS only) - https://developer.apple.com/xcode/
   • For Android: Android Studio - https://developer.android.com/studio

¿Qué preguntas podrías ser formulada:

Precaución

Si no se detecta un entorno de desarrollo, se te preguntará si deseas continuar. Se recomienda instalar al menos una plataforma antes de proceder.

Paso 2: Agregar tu aplicación

El CLI te registrará en Capgo y agregará tu aplicación a tu cuenta.

(spinner) Running: npm @capgo/cli@latest login ***
Login Done ✅

❓ Add {appId} in Capgo?

Si tu ID de aplicación ya está tomado:

El CLI sugerirá alternativas:

❌ App ID "com.example.app" is already taken
💡 Here are some suggestions:
   1. com.example.app2
   2. com.example.app3
   3. com.example.app.new
   4. com.example.app.app

❓ What would you like to do?

Puedes elegir una sugerencia o ingresar un ID de aplicación personalizado.

Nota

Los IDs de la aplicación deben seguir la notación de dominio inverso (por ejemplo, com.example.myapp)

Paso 3: Crear canal de producción

Los canales te permiten gestionar diferentes flujos de actualizaciones para tu aplicación.

❓ Create default channel production for {appId} in Capgo?

Consejo

No te preocupes! Esto es solo para pruebas locales durante la onboarding. Crear un ‘canal de producción’ no significa que tus actualizaciones se publiquen inmediatamente a los clientes. Tienes control total sobre cuándo se despliegan las actualizaciones. Selecciona Sí a menos que tengas requisitos específicos de canal.

Si seleccionas Sí:

(spinner) Running: npm @capgo/cli@latest channel add production {appId} --default
Channel add Done ✅  (or "Channel already added ✅")

Se creará un canal de producción y se establecerá como predeterminado. Esta es la opción recomendada para la mayoría de los usuarios.

Si seleccionas No:

If you change your mind, run it for yourself with: "npm @capgo/cli@latest channel add production {appId} --default"

Necesitarás crear y configurar los canales manualmente más tarde. Alternativamente, puedes:

• Establecer el canal en tu capacitor.config.ts archivo
• Usar el método de JavaScript para establecer dinámicamente el canal setChannel() Configurar los canales más tarde desde la consola web __CAPGO_KEEP_0__
• Configure channels later from the Capgo web console

Step 4: Instale el Plugin de Actualización

El CLI instalará el @capgo/capacitor-updater plugin compatible con tu versión de Capacitor.

❓ Automatic Install "@capgo/capacitor-updater" dependency in {appId}?

Compatibilidad de versión:

• Capacitor 5Instala la versión v5 @capgo/capacitor-updater __CAPGO_KEEP_0__ 6
• Capacitor 6__CAPGO_KEEP_0__ 5 @capgo/capacitor-updater __CAPGO_KEEP_0__ 6
• Capacitor 7: Instala @capgo/capacitor-updater v7
• Capacitor 8+: Instala la última versión

Advertencia

Capgo solo admite Capacitor v5 y superior. Si está utilizando una versión anterior, necesitará actualizar primero.

Opción de actualizaciones instantáneas:

Después de la instalación, se le preguntará:

❓ Do you want to set instant updates in {appId}?
   Read more: https://capgo.app/docs/live-updates/update-behavior/#applying-updates-immediately

Consejo

¿Qué son las actualizaciones instantáneas? Con las actualizaciones instantáneas habilitadas, su aplicación aplica actualizaciones de inmediato cuando se pone en segundo plano y se vuelve a abrir. Esto funciona sin problemas porque Capgo puede distribuir actualizaciones en todo el mundo en menos de 300ms. Sin él (modo estándar), las actualizaciones se descargan en segundo plano y se aplican en la próxima reiniciación de la aplicación. Las actualizaciones instantáneas son ideales para una iteración más rápida durante el desarrollo y correcciones críticas de errores en producción.

Si selecciona Sí:

• Las actualizaciones se configurarán para aplicarse de inmediato cuando la aplicación esté en segundo plano y se vuelva a abrir
• autoUpdate: 'always' y autoSplashscreen: true contexto: Página/área: Sitio web de marketing de Capgo. Rol: Etiqueta de IU corta o elemento de navegación. Visto en: página trust.astro. Clave de mensaje `y` (Y).
• se agregarán a su configuración capacitor.config.ts Su
• se actualizará automáticamente Actualizaciones delta

contexto: Página/área: Página de precios de producto de empresa. Rol: Etiqueta de IU corta o elemento de navegación. Visto en: página enterprise.astro. Clave de mensaje `enterprise_delta_updates` (Actualizaciones delta de empresa).

• Las actualizaciones utilizarán el comportamiento estándar (descargar en segundo plano, aplicar en el próximo reinicio)
• Siempre puede habilitar las actualizaciones instantáneas más adelante modificando su capacitor.config.ts

Paso 5: Agregar Integración Code

El CLI inyectará automáticamente los code necesarios en su archivo de aplicación principal.

❓ Automatic Add "CapacitorUpdater.notifyAppReady()" code and import in {appId}?

¿Qué se agrega:

import { CapacitorUpdater } from '@capgo/capacitor-updater'

CapacitorUpdater.notifyAppReady()

Detección de tipo de proyecto:

• Nuxt.js: Crea plugins/capacitorUpdater.client.ts
• Otros frameworks: Agrega a tu archivo de entrada principal

Consejo

Si falla la inyección automática, puedes agregar manualmente el code a tu archivo de aplicación principal:

Para Nuxt.js: Crear plugins/capacitorUpdater.client.ts:

import { CapacitorUpdater } from '@capgo/capacitor-updater'

export default defineNuxtPlugin(() => {
  CapacitorUpdater.notifyAppReady()
})

Para otros frameworks: Agrega a tu archivo de entrada principal (por ejemplo, main.ts, index.js, App.tsx):

import { CapacitorUpdater } from '@capgo/capacitor-updater'

CapacitorUpdater.notifyAppReady()

Coloca este code después de tus importaciones y antes de la inicialización de tu aplicación. Para obtener más detalles, consulta la Guía para agregar una aplicación.

Paso 6: Configuración de cifrado (opcional)

El cifrado de extremo a extremo agrega una capa de seguridad adicional para tus actualizaciones.

🔐 End-to-end encryption
   ✅ Use this for: Banking, healthcare, or apps with legal encryption requirements
   ⚠️  Note: Makes debugging harder - skip if you don't need it

❓ Enable end-to-end encryption for {appId} updates?

Nota

El cifrado solo está disponible para Capacitor v6 y versiones posteriores.

Si habilitas el cifrado, el CLI:

1. Genera claves de cifrado
2. Ofrece sincronizar la configuración de tu Capacitor

Paso 7: Seleccionar plataforma

Elige qué plataforma probar durante el proceso de incorporación.

📱 Platform selection for onboarding
   This is just for testing during onboarding - your app will work on all platforms

❓ Which platform do you want to test with during this onboarding?
   Options:
   - iOS
   - Android

Consejo

Solo afecta el proceso de incorporación. Tu aplicación final apoyará todas las plataformas.

Paso 8: Construir tu proyecto

El CLI construirá tu aplicación y sincronizará con Capacitor.

❓ Automatic build {appId} with "npm run build"?

¿Qué sucede:

1. Detecta el tipo de proyecto
2. Ejecuta tu script de compilación
3. Ejecuta npx cap sync {platform}

Si falta el script de compilación:

Se te preguntará si deseas saltarte la compilación o agregar un script de compilación a tu package.json.

Paso 9: Ejecutar en dispositivo

Prueba la versión inicial de tu aplicación en un dispositivo o simulador.

❓ Run {appId} on {PLATFORM} device now to test the initial version?

Si seleccionas Sí:

(spinner) Running: npx cap run {platform}
(device picker appears)
App started ✅
📱 Your app should now be running on your {platform} device with Capgo integrated
🔄 This is your baseline version - we'll create an update next

Paso 10: Hacer un cambio de prueba

Es hora de probar el sistema de actualizaciones de Capgo haciendo un cambio visible.

🎯 Now let's test Capgo by making a visible change and deploying an update!

❓ How would you like to test the update?
   Options:
   - Auto: Let Capgo CLI make a visible change for you
   - Manual: I'll make changes myself

Modo automático: El CLI modificará automáticamente tus archivos para agregar una bandera de prueba visible o cambiar.

Modo manual: Tú haces tus propios cambios (por ejemplo, cambia el texto, los colores o agrega elementos).

Gestión de versiones:

❓ How do you want to handle the version for this update?
   Options:
   - Auto: Bump patch version ({currentVersion} → {nextVersion})
   - Manual: I'll provide the version number

Construir con cambios:

❓ Build {appId} with changes before uploading?

Consejo

Si necesita compilar manualmente en otra terminal, seleccione “No” y compile usted mismo, luego continúe.

Paso 11: Subir paquete

Suba su paquete de aplicación actualizado a Capgo.

❓ Upload the updated {appId} bundle (v{version}) to Capgo?

El CLI ejecuta:

npx @capgo/cli@latest bundle upload

Consejo

Actualizaciones delta con actualizaciones instantáneas: If you enabled instant updates in Step 4, the CLI will automatically ask if you want to enable delta updates. Delta updates envían solo los archivos que cambiaron entre versiones en lugar de todo el paquete. Dado que normalmente solo cambian unos pocos archivos entre actualizaciones, esto hace que las descargas sean mucho más rápidas. Seleccione Sí para obtener la mejor experiencia con actualizaciones instantáneas.

Prompt de actualizaciones delta (si se habilita un modo de aplicación instantánea):

💡 Instant updates are enabled in your config
   Delta updates send only changed files instead of the full bundle

❓ Enable delta updates for this upload? (Recommended with instant updates)

Advertencia

Para repositorios monolíticos, es posible que deba proporcionar rutas adicionales a tus package.json y node_modules.

Éxito:

✅ Update v{version} uploaded successfully!
🎉 Your updated bundle is now available on Capgo

Paso 12: Prueba de actualización en dispositivo

¡Es hora de ver la actualización en acción!

🧪 Time to test the Capgo update system!
📱 Go to your device where the app is running

Para actualizaciones instantáneas:

🔄 IMPORTANT: Background your app (swipe up/press home button) and then reopen it
⏱️  The update should be downloaded and applied automatically

Para actualizaciones estándar:

📱 With standard updates, you will need to:
   1. Background the app (swipe up/press home button) to start download
   2. Wait a few seconds for download to complete
   3. Background and foreground again to see the update

Monitorear registros:

❓ Monitor Capgo logs to verify the update worked?

Si seleccionas Sí, verás registros en vivo de tu dispositivo que muestran el proceso de actualización.

Paso 13: Finalización

Welcome onboard ✈️!

¡Felicidades! Has configurado con éxito las actualizaciones en vivo de Capgo para tu aplicación.

Lo que has logrado

Después de completar la configuración de inicio, tienes:

✅ Aplicación Registrada

Tu aplicación está registrada en Capgo con un canal de producción

✅ Plugin Instalado

El plugin de actualizaciones de Capacitor está instalado y configurado

✅ Code Integrado

La integración code se agrega a tu aplicación

✅ Actualizado Probado

Has desplegado con éxito y recibido una actualización en vivo

Flujo de trabajo diario

Para actualizaciones posteriores, utilice:

npm run build
npx @capgo/cli@latest bundle upload --channel=production

Para más opciones de despliegue, consulte Desplegar una actualización en vivo.

Reanudando la onboarding

Si sale del proceso de incorporación, puede reanudarlo en cualquier momento:

npx @capgo/cli@latest init [APIKEY]

Vea:

You have already got to the step {stepNumber}/13 in the previous session
❓ Would you like to continue from where you left off?

Consejo

El progreso se guarda localmente, por lo que puede salir y reanudar el proceso de incorporación con seguridad.

Solución de problemas

No hay entorno de desarrollo

Problema: Ni Xcode ni Android SDK se detectó.

Solución:

• Para iOS: Instale Xcode (solo para macOS)
• Para Android: Instale Android Studio

Ya se ha tomado el ID de la aplicación

Problema: Su ID de aplicación ya está registrada.

Solución: Elige una de las alternativas sugeridas o ingresa un ID de aplicación personalizado en notación de dominio inverso.

Falta de Script de Construcción

Problema: No se encontró ningún script de construcción en package.json.

Solución: Agrega un script de construcción a tu package.json:

{
  "scripts": {
    "build": "your-build-command"
  }
}

Falló la Inyección Automática

Problema: CLI no puede inyectar automáticamente la integración code.

Solución: Agregar code manualmente a tu archivo principal:

import { CapacitorUpdater } from '@capgo/capacitor-updater'

CapacitorUpdater.notifyAppReady()

Capacitor Versión Demasiado Antigua

Problema: Tu versión de Capacitor es inferior a v5.

Solución: Actualizar Capacitor a v5 o superior:

• Actualizando a Capacitor 5
• Actualizando a Capacitor 6
• Actualizando a Capacitor 7

Pasos siguientes

Ahora que has completado la configuración de inicio, explora estos temas:

Lista de verificación de configuración única

Configura canales, CI y subida de delta una vez para estabilidad a largo plazo

Despliega actualizaciones

Aprende a desplegar actualizaciones desde la consola de Capgo

Tipos de actualizaciones

Referencia de todos los tipos de actualizaciones OTA: aplicar tiempo, condiciones de retraso, bloqueo de versión y entrega

Integración CI/CD

Automatice sus despliegues de actualizaciones con CI/CD

Canales

Gestione múltiples flujos de actualizaciones con canales

Encriptación

Proteja sus actualizaciones con encriptación de extremo a extremo

Comportamiento de Actualización

Personalice cuándo y cómo se aplican las actualizaciones (directo, delta, etc.)

Obtener Ayuda

Verifique el

• Verifique el Guía de solución de problemas
• Únete a la Comunidad de Discord
• Revisa el FAQ
• Contacto Soporte

Sigue adelante desde la Guía de Onboarding de CLI

Si estás utilizando la Guía de Onboarding de CLI para planificar el panel de control y las operaciones de API, conecta con API Resumen para el detalle de implementación en API Resumen, Introducción para el detalle de implementación en Introducción, API Claves para el detalle de implementación en API Claves, Dispositivos para el detalle de implementación en Dispositivos, y Paquetes para el detalle de implementación en Paquetes.