Favicon

You are here: Home > Distribución de Apps > CI/CD > Bitrise

Bitrise

Integra Applivery con Bitrise CI/CD para automatizar la compilación, las pruebas y el despliegue de Apps móviles.

10 min read

TL;DR

Integra Applivery con Bitrise para automatizar el despliegue de apps móviles usando el Applivery Step en tu flujo de trabajo.

bitrise

Bitrise es una plataforma CI/CD orientada a móviles, diseñada específicamente para el desarrollo de apps iOS y Android. Utiliza Workflows —secuencias de pasos configurables— para automatizar la compilación, las pruebas, la firma y el despliegue de Apps.

Applivery tiene un Applivery Step oficial en la biblioteca de steps de Bitrise. Al añadirlo a tu workflow, el binario compilado se sube automáticamente a Applivery tras cada Build exitosa, con los metadatos de CI completos (rama, commit, número de Build).

Requisitos previos

Antes de configurar la integración, asegúrate de tener:

  • Una cuenta en Bitrise.io con una App ya conectada a tu repositorio (GitHub, GitLab o Bitbucket).
  • Un App API Token de Applivery. Encuéntralo en Ajustes de la App → Token API en el panel de Applivery, o consulta Apps API Token.
1
Guardar el App Token como Secret de Bitrise

No pegues el token directamente en un campo de entrada del Step: quedaría visible en la configuración del workflow. Guárdalo como Secret para que esté enmascarado en los logs e inyectado como variable de entorno.

  1. Abre tu app en Bitrise y dirígete a la pestaña Secrets (navegación superior).
  2. Haz clic en Add new.
  3. Establece la clave como APPLIVERY_APP_TOKEN.
  4. Pega tu App API Token de Applivery como valor.
  5. Activa Protected para evitar que el valor quede expuesto en los logs de Build.
  6. Haz clic en Save.

Una vez guardado, puedes referenciarlo en cualquier parte de tu workflow como $APPLIVERY_APP_TOKEN.

2
Añadir el Applivery Step a tu workflow
  1. Abre tu app en Bitrise y dirígete a la pestaña Workflows.
  2. Selecciona el workflow donde quieres añadir el despliegue de Applivery (normalmente el workflow principal, por ejemplo primary o deploy).
  3. Haz clic en el botón + en el punto del workflow donde quieres añadir el Step: colócalo después de los pasos de compilación y firma (por ejemplo, después de Xcode Archive & Export for iOS o Android Build).
  4. En el cuadro de búsqueda de Steps, escribe Applivery.
  5. Selecciona el step Deploy to Applivery de los resultados y haz clic en Add.
3
Configurar el Applivery Step

Con el Step añadido a tu workflow, haz clic en él para abrir su panel de configuración. Rellena los siguientes campos:

Obligatorio

Campo Valor
App Token $APPLIVERY_APP_TOKEN (referencia al Secret creado en el Paso 1)

Opcional

Campo Descripción
Build name Etiqueta legible para la Build. Puedes usar variables de Bitrise como $BITRISE_BUILD_NUMBER o $GIT_CLONE_COMMIT_MESSAGE_SUBJECT.
Changelog Notas de la versión de esta Build. Usa $GIT_CLONE_COMMIT_MESSAGE_BODY para incluir el mensaje de commit automáticamente.
Tags Etiquetas separadas por comas para identificar la Build en Applivery. Por ejemplo: bitrise, staging.
Notify Collaborators Establece como true para enviar una notificación por email a los Colaboradores de la App tras la subida.
Notify Employees Establece como true para enviar una notificación por email a los empleados de la tienda.
Notify Message Mensaje personalizado para incluir en el email de notificación.
Build path Ruta del binario a subir. Si se deja vacío, el Step usa automáticamente la salida del paso de compilación anterior ($BITRISE_IPA_PATH para iOS o $BITRISE_APK_PATH para Android).
4
Ejecutar tu workflow

Lanza una Build manualmente para verificar la integración:

  1. En tu app de Bitrise, haz clic en Start/Schedule a Build.
  2. Selecciona el workflow que configuraste.
  3. Haz clic en Start Build.

Una vez completada la Build, el Applivery Step subirá el binario a tu app de Applivery. Abre el panel de Applivery para confirmar que la Build aparece con los metadatos correctos.

Variables de entorno de Bitrise

El Applivery Step captura automáticamente los metadatos de CI de Bitrise. También puedes referenciar estas variables explícitamente en los campos de entrada del Step:

Variable Descripción
$BITRISE_BUILD_NUMBER Número de Build secuencial asignado por Bitrise.
$BITRISE_BUILD_URL URL directa a la Build actual en el panel de Bitrise.
$BITRISE_GIT_BRANCH Rama de Git que desencadenó la Build.
$BITRISE_GIT_COMMIT SHA del commit de Git que desencadenó la Build.
$BITRISE_GIT_TAG Tag de Git, si la Build fue desencadenada por un push de tag.
$GIT_CLONE_COMMIT_MESSAGE_SUBJECT Primera línea del mensaje de commit.
$GIT_CLONE_COMMIT_MESSAGE_BODY Cuerpo completo del mensaje de commit.
$BITRISE_IPA_PATH Ruta al archivo .ipa exportado (Builds iOS).
$BITRISE_APK_PATH Ruta al archivo .apk generado (Builds Android).

Para la lista completa de variables de entorno de Bitrise, consulta la documentación del CLI de Bitrise.

Usar Fastlane con Bitrise

Si tu proyecto ya usa Fastlane, puedes combinar Bitrise con el plugin de Applivery para Fastlane en lugar de usar el Applivery Step dedicado. Añade un Step de Fastlane a tu workflow e invoca el lane que llama a la acción applivery:

Step: Fastlane
Lane: ios deploy

En esta configuración, pasa el token a través de un Secret de Bitrise referenciado como $APPLIVERY_APP_TOKEN y léelo en tu Fastfile como ENV["APPLIVERY_APP_TOKEN"].

Consulta la guía de integración con Fastlane para la configuración completa del Fastfile.

Bitrise es una plataforma CI/CD orientada a móviles para el desarrollo de apps iOS y Android que usa Workflows para automatizar la compilación, las pruebas, la firma y el despliegue de apps.

El Applivery Step en Bitrise sube automáticamente el binario compilado a Applivery tras cada Build exitosa, incluyendo metadatos de CI como rama y commit.

Necesitas una cuenta de Bitrise conectada a tu repositorio y un App API Token de Applivery, que encontrarás en los Ajustes de la App.

Guarda tu App API Token de Applivery como Secret en Bitrise, con la clave `APPLIVERY_APP_TOKEN`, y activa «Protected» para enmascararlo en los logs.

Añade el Applivery Step después de los pasos de compilación y firma, como tras «Xcode Archive & Export for iOS» o «Android Build».

En la configuración del Applivery Step, establece el campo «App Token» como `$APPLIVERY_APP_TOKEN` para referenciar el Secret de Bitrise.

Sí, puedes usar el plugin de Applivery para Fastlane con Bitrise añadiendo un Fastlane Step e invocando el lane que llama a la acción `applivery`.

Puedes usar variables como `$BITRISE_BUILD_NUMBER`, `$BITRISE_GIT_BRANCH`, `$GIT_CLONE_COMMIT_MESSAGE_SUBJECT`, `$BITRISE_IPA_PATH` y `$BITRISE_APK_PATH`.

Last updated: June 8, 2026