Lista de verificación de configuración única

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

Has terminado de la configuración de inicio. 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: público encendido, dispositivo auto-desactivado, bloquear actualizaciones bajo nativo encendido, guardia de actualización automática encendida major.
Canales de prueba (development / staging): público desactivado, dispositivo auto-activado para QA.
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 debe ser válido value 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. Deploy to production only after testing, from the API or the dashboard.

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 una). 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. Verifique cada nombre en el Prueba de SemVer antes de subir.

Nombre = semver desde CI, por ejemplo 1.8.0, 1.8.0-beta.1o 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 de fragmento de HTML de una cadena de UI de Capgo 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. Preserva términos de producto y marca de Capgo exactamente. Clave de mensaje `alternatives_cta_questions` (Preguntas de CTAs de alternativas). | texto de fragmento de HTML de una cadena de UI de Capgo 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. Preserva términos de producto y marca de Capgo exactamente. Clave de mensaje `appflow_cta_questions` (Preguntas de CTAs de Appflow). | texto de fragmento de HTML de una cadena de UI de Capgo 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. Preserva términos de producto y marca de Capgo exactamente. Clave de mensaje `capwesome_cta_questions` (Preguntas de CTAs de Capwesome). | texto de fragmento de HTML de una cadena de UI de Capgo más larga (clave de padre `consulting_faq_subtitle`). Página/área: página de servicios de consultoría. Rol: subtítulo o encabezado de sección. Visto en: página consulting.astro. Preserva términos de producto y marca de Capgo exactamente. Clave de mensaje `consulting_faq_subtitle` (Subtítulo de preguntas de FAQ 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 Or).

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

, no en el nombre del paquete. __CAPGO_KEEP_0__ y __CAPGO_KEEP_1__.

__CAPGO_KEEP_2__

--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 automáticamente siempre. No pasas una bandera de checksum.

Predeterminado: `--delta` (manifiesto + copia de seguridad en formato 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 guarda el archivo zip completo como copia de seguridad. Es bueno cuando el costo de almacenamiento no es tu principal preocupación.

Ahorrando 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

Usa --delta-only cuando quieras reducir el almacenamiento de __CAPGO_KEEP_0__ reduce Capgo storageUsa cuando quieras reducir el almacenamiento de __CAPGO_KEEP_0__

Compromiso: sin el respaldo en 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 de plugin adicional en el dispositivo. El actualizador lee el manifiesto y descarga solo los archivos modificados.

Flujo diario

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`)
Canales 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	Comienza con 1-2 canales
Dispositivo configurado en producción por sí mismo	Apagado para producción, encendido para canales de prueba
Saltar `--delta`	Agregar `--delta` a subidas; usa `--delta-only` solo cuando necesites ahorrar espacio de almacenamiento
Nombres de paquetes no semversión	Sigue la versión semántica y valida en el SemVer tester
Cambiar el esquema de versionado con el tiempo	Mantener semver; usar etiquetas de lanzamiento previo para builds adicionales (`1.8.0-20260629.1`)
Metadata / habilitado sin razón	Dejarlo fuera por defecto

Aprende más

Canales Defaults, precedencia y enrutamiento.

Actualizaciones delta ¿Por qué y cómo usar --delta.

CI/CD Automatizar subida y despliegue.

Bundles Checksum, dependencias y metadatos.

Lista de verificación de configuración única