Skip to main content

Veritran Docs

Builds

Un build es la generación de un binario de la app para probarla en un dispositivo móvil o para publicarla en tiendas.

Para acceder a la página Builds, ve a la página Applications , busca tu app en la lista, haz clic en el icono de tres puntos verticales a la derecha y, a continuación, haz clic en View builds.

Navega la página Builds

La página Builds se abre, y muestra el ambiente y la app seleccionados, así como un detalle de cadabuild lanzado para esa app, incluida la plataforma para la que se generó el binario, la versión, la fecha de creación y el usuario que lo creó, la duración de la generación, su estado actual y detalles. Puedes acotar la lista por plataforma, usuario o estado utilizando los filtros ubicados en la parte superior de la página.

builds.gif

La columna Status describe el estado del build. En la siguiente lista encontrarás más información sobre cada estado:

  • Succeeded: El build se generó correctamente.

  • Failed: No se pudo generar el build porque hubo un error durante el proceso de generación. El error puede deberse a una configuración incorrecta, por ejemplo, un ID de recursos estáticos inexistente. Si se produce un error en la generación, revisa los registros para encontrar el problema mediante la opción View logs y haz clic en Relaunch para volver a intentarlo.

  • Scheduled: El build está listo para generarse, pero el runner ha alcanzado su número máximo de builds en simultáneo. El build se generará una vez que el runner termine con una de las generaciones en curso.

  • Running: El build se está generando.

En la columna Details, puedes encontrar etiquetas que aparecerán si aplican al build. A continuación, encontrarás más información sobre cada etiqueta:

  • For Stores: indica que el build se generó para ser publicado en una tienda (App Store, Google Play Store o AppGalery).

  • XpressPlug: indica que el binario se generó usando XpressPlug.

  • Retain project: indica que el binario se configuró para registrar información específica sobre el proyecto para el que se generó, con fines de depuración.

Haz clic en la flecha situada a la izquierda de un build para ver una captura de la app cuando se generó ese build. Los detalles incluyen el nombre de la app, el producto y el ambiente al que está asociada, su ID de recursos estáticos, las configuraciones de la app y el producto, y los SDKs y detectores de manipulaciones configurados. También puedes posar el cursor sobre el chip de una plataforma para ver los detalles de la configuración de esa plataforma para esa generación de binario. Si la función Mobile Security está habilitada para una plataforma determinada, se muestra un icono de escudo en el chip de esa plataforma.

Desde esta página, también puedes lanzar un nuevo build seleccionando Launcho realizar acciones en un build específico mediante el menú de opciones situado a la derecha del build. Las acciones disponibles incluyen: revisar los registros del proceso de generación del binario, revisar una lista de artefactos o artefactos privados —estos son los archivos generados durante el lanzamiento del build— con sus tamaños para descargar cualquiera de ellos, instalar, archivar, cargar y comparar builds.

Si seleccionas la opción Install, se abre un modal con las opciones para escanear el código QR para probar la app o descargar el binario de la app (.ipa para iOS o .apk para Android). También puedes configurar un build para ser publicado en tienda, si el build tenía la opción For stores habilitada al generarse. Las opciones que se muestran dependen del estado del build.

Lanza un build

Para lanzar un nuevo build para una app, es decir, para generar uno o varios binarios nuevos de una app, sigue estos pasos:

Importante

El lanzamiento de un build para generar un binario de iOS integrado con XpressPlug requiere configuraciones adicionales a las que se describen a continuación. Dirígete a Genera un binario integrado con XpressPlug para aprender a hacerlo.

Launch_build.gif

  1. Acceda a la página Applications

  2. Busca la app en la lista y haz clic en el icono para lanzar el build, o accede a la página Builds y haz clic en Launch.

  3. Se abre un modal para que selecciones la configuración del build. Para ello, sigue estos pasos:

    1. Elige la plataforma o plataformas en las que se lanzará ese build (iOS, Android o Harmony). Puedes generar binarios para más de una plataforma en el mismo lanzamiento.

    2. Elige la versión de la o las plataformas en el menú desplegable. Puedes elegir entre una rama estable o un tag.

      Aviso

      Los binarios productivos solo deben crearse a partir de tags y no de ramas estables.

    3. En el campo Binary artifact name, escribe un nombre para el archivo que se generará (.ipa para iOS y .aab o .apk para Android y Harmony). Utiliza letras minúsculas, números, ., - o _. No utilices letras mayúsculas ni espacios. Para este ejemplo, escribe: goldbank-mobile-prod.

    4. Haz clic en la opciónFor stores si el build es una implementación y se publicará en una tienda. Para este ejemplo, haz clic en la opción.

    5. Haz clic en la opción Retain project para registrar información específica sobre el proyecto para el que se generó con fines de depuración.

      Nota

      Esta opción solo está disponible para los líderes de proyecto.

    6. Si deseas forzar una versión de rama específica para un SDK, habilita la opción Force SDKs versions. Complete con el nombre de la librería y la versión de la rama deseada para cualquiera de las plataformas, siguiendo la estructura livrería:versión,librería:versión. Utiliza snake_case para el nombre de la librería, seguido de dos puntos y el nombre de la versión. Utiliza comas para separar los nombres de las librerías y no utilices espacios. Para este ejemplo, escribe: blink_id:7.8-estable,firebase:hotfix/my_hotfix.

    7. Por último, haz clic en Launch para generar los binarios.

Carga un build

Para cargar los archivos binarios de apps integradas con XpressPlug, sigue estos pasos:

Importante

Esta opción solo está disponible si el proyecto se integró con XpressPlug.

  1. Accede a la página Builds.

  2. Haz clic en el icono para cargar builds a la izquierda del botón de lanzamiento o busca la app en el listado y haz clic en Upload build en el menú de opciones de la app.

  3. Se abre el modal Upload build para seleccionar el archivo y sus configuraciones. Para ello, sigue estos pasos:

    1. Elige la plataforma que corresponda al archivo binario (Android, iOS o Harmony).

    2. Elige una versión de la plataforma del menú desplegable. Puedes elegir entre un tag o una rama estable.

    3. En el campo Binary artifact name, escribe un nombre para el archivo que se generará cuando se lance el build (.ipa para iOS y .apk para Android y Harmony). Utiliza letras minúsculas, números, ., - o _. No utilices letras mayúsculas ni espacios.

    4. Haz clic en Upload file para cargar el archivo binario desde tu computadora.

    5. Haz clic en Save para finalizar el proceso. El build cargado mostrará la etiqueta XpressPlug en la columna de detalles para identificarlo fácilmente.

:

Generación del binario de una aplicación.