Lista de verificación de configuración única

Copia un prompt de configuración con los pasos de instalación y la guía de markdown completa para este complemento.

Has terminado de configuración. Ahora configura Capgo una vez. Después de eso, el trabajo diario es solo subir → probar → desplegar.

Regla: los canales son rutas de lanzamiento (development, production), no tickets, características o nombres de desarrolladores.

Lista de verificación de configuración única

Crear canales: elija el conjunto más pequeño que se adapte (consulte a continuación).
Establecer el canal de carga predeterminado en configuración de la aplicación:
- Solo aplicación → production
- Equipo → development
Canales de producción: encendido público, autoconfiguración del dispositivo apagado, bloquear actualizaciones bajo encendido nativo, guardia de actualización automática encendida major.
Canal de prueba (development / staging) encendido público, dispositivo autoconfigurado para pruebas.
Subir desde CI con --delta (checksum y dependencias nativas son automáticas):
Ventana de terminal
```
npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --comment "commit ${GIT_SHA:0:7} run ${CI_RUN_ID}" \
  --delta
```
El --bundle valor debe ser válido Versión semánticaVerificarla en el Prueba de SemVer antes de subir.
Desplegar a producción después de probar, desde el o __CAPGO_KEEP_0__. or CLI.
invitar una vez, menos permisos 2FA para la organización, una __CAPGO_KEEP_0__ clave en CI. for the org, one API key in CI.

Deje la cifrado, min_update_version, metadatos y vista previa apagado a menos que tenga una razón clara.

Elige su tamaño

Sencillo: 1 aplicación, 1 canal: production

Equipo: development + productioncontexto: Página/área: Sitio web de marketing de Capgo. Rol: Etiqueta de IU corta o elemento de navegación. Visto en: página sla.astro. Clave de mensaje `team_plan` (Plan de equipo).

. Subir a dev, desplegar a prod.Versiones nativas production-9.0 + test-9.0. Mantenga a los usuarios del almacén en el canal principal de producción.

Muchas aplicaciones: mismo modelo simple por aplicación (usualmente uno production cada uno). No cree canales adicionales solo porque la organización es grande.

Tren de lanzamiento (opcional): staging → rc → production. Mismo modelo en cada aplicación que lo necesite.

Nombre del paquete vs comentario

Los nombres de paquete son obligatorios para seguir la versión semántica. Capgo utiliza semver para comprobaciones de compatibilidad, reglas de actualización automática de canal y retrocesos. Valida cada nombre en el Prueba de SemVer antes de subir.

Nombre = semver desde CI, por ejemplo 1.8.0, 1.8.0-beta.1, o 1.8.0-20260629.42
Comentario = texto libre para humanos → commit abc1234 run 28059070270

Use semver pre-release etiquetas (la parte después de -cuando envíes muchos builds bajo el mismo MAJOR.MINOR.PATCH. Por ejemplo, mantén 1.8.0 y agrega la fecha o contador de construcción en el pre-release: 1.8.0-20260629.1, 1.8.0-beta.2. No inventes formatos personalizados como fix-login-bug o 2.5.2026062306contexto: texto fragmento de HTML de una cadena de Capgo UI más larga (clave de padre `alternatives_cta_questions`). Página/área: página de comparación de alternativas de actualización en vivo de Capacitor. Rol: párrafo de marketing o legal largo. Visto en: página alternatives.astro. Preservar términos de producto y marca de Capgo y términos de desarrollador exactamente. Clave de mensaje `alternatives_cta_questions` (Preguntas de CTAs de Alternativas). | Texto fragmento de HTML de una cadena de Capgo UI más larga (clave de padre `appflow_cta_questions`). Página/área: copia de marketing de comparación/migración de Appflow. Rol: párrafo de marketing o legal largo. Visto en: página ionic-appflow.astro. Preservar términos de producto y marca de Capgo y términos de desarrollador exactamente. Clave de mensaje `appflow_cta_questions` (Preguntas de CTAs de Appflow). | Texto fragmento de HTML de una cadena de Capgo UI más larga (clave de padre `capwesome_cta_questions`). Página/área: página de comparación de Capawesome. Rol: párrafo de marketing o legal largo. Visto en: página capwesome.astro. Preservar términos de producto y marca de Capgo y términos de desarrollador exactamente. Clave de mensaje `capwesome_cta_questions` (Preguntas de CTAs de Capwesome). | Texto fragmento de HTML de una cadena de Capgo UI más larga (clave de padre `consulting_faq_subtitle`). Página/área: página de servicios de consultoría. Rol: subtítulo de sección o etiqueta. Visto en: página consulting.astro. Preservar términos de producto y marca de Capgo y términos de desarrollador exactamente. Clave de mensaje `consulting_faq_subtitle` (Subtítulo de Preguntas Frecuentes de Consultoría). | Página/área: copia de marketing de comparación/migración de Appflow. Rol: etiqueta de UI corta o elemento de navegación. Visto en: página ionic-appflow.astro, página ionic-enterprise-plugins.astro, página soluciones/ionic-enterprise-plugins.astro. Clave de mensaje `appflow_plugins_or` (Appflow Plugins O)

. No son válidos semver y las subidas fallarán o comportarse de manera impredecible. --commentColoque las notas de lanzamiento en

, no en el nombre del paquete. versión de destino y actualización.

subir delta

--delta sube un manifiesto de manera que los dispositivos descarguen solo los archivos modificados en lugar de la versión completa del paquete cada vez. El checksum se calcula siempre automáticamente. No pasas una bandera de checksum.

Predeterminado: `--delta` (manifiesto + copia de seguridad zip)

npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --delta

Esta es la configuración recomendada por defecto para la mayoría de las aplicaciones. Capgo almacena el manifiesto y mantiene el archivo zip completo como copia de seguridad. Es bueno cuando el costo de almacenamiento no es tu principal preocupación.

Ahorro de almacenamiento: `--delta-only`

npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --comment "commit ${GIT_SHA:0:7} run ${CI_RUN_ID}" \
  --delta-only

Utiliza --delta-only cuando deseas reducir el almacenamiento de __CAPGO_KEEP_0__ reduce Capgo storagey

Compromiso: sin el respaldo en formato zip en el servidor, dependes completamente del camino del manifiesto. Saltar --delta-only a menos que realmente necesites las ahorras de almacenamiento.

No se requiere ninguna configuración adicional del plugin en el dispositivo. El actualizador lee el manifiesto y descarga solo los archivos modificados.

Rutina diaria

Upload to development (--delta)
  → test
  → deploy to production
  → don't touch channel settings again

Errores comunes

Error	Solución
Esperar actualizaciones OTA antes de una nueva versión de tienda	Reconstruir y enviar la aplicación nativa después de agregar el plugin
Subir un paquete pero no desplegarlo en un canal	Asignar el paquete a un canal (por ejemplo `production`)
Canal por característica, ticket o desarrollador	Usar solo vías de liberación permanentes
Nombres de canales de CI dinámicos	Nombres fijos: `development`, `production`
Demasiados canales para una aplicación simple	Comience con 1-2 canales
Dispositivo autoconfigurado en producción	Apagado para producción, encendido para canales de prueba
Saltar `--delta`	Agregar `--delta` a subidas; utilice `--delta-only` solamente cuando necesite ahorrar espacio de almacenamiento
Nombres de paquetes no semversión	Siga la versión semántica y valide en el SemVer tester
Cambiar el esquema de versionado con el tiempo	Mantener semver; usar etiquetas de lanzamiento previo para construcciones adicionales (`1.8.0-20260629.1`)
Habilitar metadatos / vista previa sin razón	Dejarlo fuera por defecto

Saber más

Precedencia, valores por defecto y enrutamiento. Actualizaciones delta

¿Por qué y cómo usar --delta. CI/CD

Canal Automatice la subida y despliegue.

Paquetes Checksum, dependencias y metadatos.

Lista de verificación de configuración única