# Bitrise

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

Source: https://docs.applivery.com/es/app-distribution/ci-cd/bitrise/  •  Last updated: 2026-06-08

**Answers:** ¿Qué es Bitrise? · ¿Cómo integro Applivery con Bitrise? · ¿Dónde añado el Applivery Step en Bitrise? · ¿Cómo guardo el token de Applivery de forma segura en Bitrise?

---

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

![bitrise](https://www.applivery.com/wp-content/uploads/2021/12/bitrise-1024x335.png "bitrise | Applivery")

[Bitrise](https://www.bitrise.io/) 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](https://www.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](https://docs.applivery.com/en/app-distribution/api/app-api-token/).

---

**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`.

**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**.

**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). |

**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](https://devcenter.bitrise.io/en/references/available-environment-variables.html).

---

## 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](https://docs.applivery.com/en/app-distribution/ci-cd/fastlane/) para la configuración completa del Fastfile.
