Sigue adelante desde el flujo de trabajo de Native + Canal de actualizaciones OTA

A common Capgo setup uses a canal de producción canal de producción canal de producción canal. CI sube cada paquete OTA a dev, luego promueve a production cuando estés listo. Los equipos suelen agregar --fail-on-incompatible para evitar que CI envíe una actualización en vivo que necesite nuevos nativos code por error.

Esta página responde a la pregunta de seguimiento: ¿qué haces cuando tú intencionalmente necesitas un paquete incompatible con los paquetes nativos actuales del canal?

Si necesitas el contexto sobre por qué Capgo compara paquetes nativos, comienza con Compatibilidad Nativa. Para una rama de CI completa que elija OTA vs Capgo Build automáticamente, ve a Auto OTA o Nativa.

Estructura de canal recomendada

Esta guía supone que los dev y production canales ya existen. Crea primero si es necesario:

npx @capgo/cli@latest channel add production com.example.app
npx @capgo/cli@latest channel add dev com.example.app

Canal	¿Quién lo recibe	Subida típica
dev	Construcciones internas / QA	Cada empuje de CI de JS (y baselines nativas intencionales)
production	Usuarios del almacén	Solo promocionado o subido cuando está listo para su lanzamiento

--fail-on-incompatible es un buen valor por defecto en ambos canales para subidas OTA diarias. Compara los paquetes nativos en el paquete que estás subiendo contra el paquete actualmente en vivo en ese canalSi difieren, la subida sale con un código de error no cero y nada se envía.

OTA diario (mantén la bandera)

Cuando el cambio es solo JavaScript y los paquetes nativos coinciden con el canal:

npx @capgo/cli@latest bundle upload com.example.app \
  --channel production \
  --fail-on-incompatible \
  --auto-min-update-version

--fail-on-incompatible bloques el deslizamiento nativo accidental. --auto-min-update-version es necesario en cada carga una vez que el canal utiliza el metadata estrategia (recomendada a continuación). Si el canal no está en metadata todavía, puedes omitir --auto-min-update-version hasta que cambies.

Puerta de enlace CI opcional antes de la carga:

npx @capgo/cli@latest bundle releaseType com.example.app --channel production
# → OTA      safe to upload with --fail-on-incompatible
# → native   stop; ship a native binary first (see below)

bump nativo intencional (elimina la bandera una vez)

Tú contexto: fragmento de texto HTML de una cadena de Capgo UI más larga (clave de página `you_definition`). Página/área: sitio web de marketing de Capgo. Rol: párrafo de marketing o legal largo. Visto en: página de advertencia.astro, página de devolución.astro. Clave de mensaje `you_definition` (Tú Definición). subir un paquete que necesita una nueva code nativa mientras se mantiene --fail-on-incompatibleque esa bandera existe para bloquear exactamente ese caso. Cuando un plugin, Capacitor versión o otra dependencia nativa se cambia a propósito:

1. Enviar el correspondiente binario nativo (Tienda de aplicaciones / Tienda de aplicaciones de Google, o Capgo Compilación).
2. Subir el paquete de JS correspondiente sin --fail-on-incompatible.
3. Preferir --auto-min-update-version con el canal en la metadata estrategia para que los dispositivos que aún están en la antigua binaria no reciban el nuevo paquete hasta que instalen la nueva aplicación.
4. Después de ese subida de línea base, coloque --fail-on-incompatible vuelva a la CI OTA normal (y mantenga --auto-min-update-version mientras el canal sigue en metadata).

1. Una vez por canal: habilitar la limitación de metadatos

   npx @capgo/cli@latest channel set production com.example.app --disable-auto-update metadata

   Repita para dev si ese canal también recibe baselines nativas intencionales. Después de este cambio, cada carga en el canal debe incluir --auto-min-update-version o --min-update-version.

2. o

   enviar el binario nativo

3. Construya y envíe la aplicación iOS/Android que incluya los nuevos plugins o cambios nativos. Hasta que los usuarios instalen ese binario, no pueden ejecutar de manera segura un paquete que dependa de esas paquetes nativos. --fail-on-incompatible)

   npx @capgo/cli@latest bundle upload com.example.app \
     --channel production \
     --auto-min-update-version

   Este registra los nuevos paquetes nativos en el canal. Más tarde bundle releaseType / --fail-on-incompatible comprueba ese punto de partida.

4. Reanuda subidas OTA protegidas

   Las liberaciones posteriores de solo JS utilizan ambos flags de nuevo:

   npx @capgo/cli@latest bundle upload com.example.app \
     --channel production \
     --fail-on-incompatible \
     --auto-min-update-version

Consejo

Trata la subida de native-baseline como un trabajo de CI dedicado (o un paso de liberación manual), no como una excepción que esparces en el trabajo de OTA por defecto. El trabajo por defecto debe mantener siempre Este registro de paquetes nativos en el canal se utiliza como punto de partida para futuras comprobaciones. --fail-on-incompatible, y en un metadata debe mantenerse también --auto-min-update-version.

Preguntas frecuentes

¿Puedo mantener --fail-on-incompatible y empujar aún así un paquete incompatibilidad nativa?

, --auto-min-update-version ,

,

,

¿Subo a dev primero, luego production?

Sí, si se ajusta a tu proceso. Ejecuta las mismas reglas por canal: la verificación de compatibilidad es contra lo que está vivo en el canal objetivo. Promueve o re-sube a production solo después dev mira bien, y utiliza una carga nativa de base (sin --fail-on-incompatible) en cada canal que necesita los nuevos paquetes nativos registrados.

¿Qué pasa si subo el nuevo paquete nativo con la bandera todavía activa?

La CI falla y Capgo no envía esa carga. Eso es el resultado esperado. O el cambio fue accidental (corrige los paquetes nativos y vuelve a intentarlo como OTA), o fue intencional (usa el camino nativo anterior).

¿Cuál bandera va en qué trabajo?

Ruta	Cuando	Subir banderas
OTA	Solo JS; paquetes nativos coinciden con el canal	--fail-on-incompatible + --auto-min-update-version Requerido si el canal está en metadata)
Base nativa	Nueva binaria nativa + paquete de JS coincidente	No --fail-on-incompatible; mantener --auto-min-update-version

Relacionado

Compatibilidad nativa

¿Cómo Capgo detecta la deriva de paquetes nativos y qué significa incompatible para dispositivos.

Auto OTA o Nativa

Hilo bundle releaseType en GitHub Acciones o GitLab para que CI elija el camino correcto.

Objetivo de versión

contexto: Página/área: Página de marketing de soluciones de Capgo. Rol: Título de sección o página. Visto en: página de soluciones/versión-objetivo.astro. Clave de mensaje `solutions_version_targeting_title` (Título de soluciones de versión objetivo). | Página/área: Página de marketing de soluciones de Capgo. Rol: Etiqueta de interfaz de usuario corta o elemento de navegación. Visto en: página de soluciones/versión-objetivo.astro. Clave de mensaje `solutions_version_targeting` (Soluciones de versión objetivo).

CLI: bundle

__CAPGO_KEEP_0__: paquete

Referencia para la carga, compatibilidad, releaseType y banderas relacionadas.

Si estás utilizando Native + OTA Channel Workflow para mantener actualizaciones en vivo seguras a través de lanzamientos nativos, conecta con Compatibilidad nativa para las reglas de comparación de paquetes, Auto OTA o Nativo para ramificación de CI, Objetivo de versión contexto: Página/área: Página de marketing de soluciones de Capgo. Rol: Título de sección o página. Visto en: página de soluciones/objetivo-de-versión.astro. Clave de mensaje `solutions_version_targeting_title` (Título de versionamiento de soluciones). | Página/área: Página de marketing de soluciones de Capgo. Rol: Etiqueta de IU corta o elemento de navegación. Visto en: página de soluciones/objetivo-de-versión.astro. Clave de mensaje `solutions_version_targeting` (Versionamiento de soluciones). Capgo CLI bundle reference __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ referencia del paquete de conjunto