# Previews de Bazel

Publica APKs de Android, aplicaciones para el simulador de Apple y macOS, y herramientas de línea de comandos desde tus targets de Bazel existentes. Añade un target de preview por cada salida que quieras compartir; tus compilaciones habituales permanecen sin cambios.

## Configuración

Añade [`rules_tuist` del repositorio de Tuist](https://github.com/tuist/tuist/tree/main/bazel) a `MODULE.bazel`, fijando el commit que quieras usar:

```starlark
bazel_dep(name = "rules_tuist")

git_override(
    module_name = "rules_tuist",
    remote = "https://github.com/tuist/tuist.git",
    commit = "FULL_COMMIT_SHA",
    strip_prefix = "bazel",
)
```

Mantén tus targets de aplicación existentes, los SDK nativos y la configuración de firma. Bazel proporciona las herramientas de publicación.

Inicia sesión directamente desde Bazel:

```bash
bazel run @rules_tuist//:login
```

Esto comparte las credenciales con la CLI de Tuist y el plugin de Gradle; un inicio de sesión existente también funciona. En CI, usa `TUIST_TOKEN` o ejecuta el target de login con la <.localized_link href="/guides/integrations/continuous-integration">autenticación OIDC</.localized_link> de Tuist. Nunca incluyas credenciales en archivos BUILD ni en atributos de reglas. Pasa `-- --url https://tuist.example.com` para iniciar sesión en una instancia autoalojada.

Carga solo el adaptador que necesites en tu `BUILD.bazel`:

```starlark
load("@rules_tuist//:android.bzl", "android_preview")

android_preview(name = "preview_android", app = ":android_app")
```

Para aplicaciones de Apple:

```starlark
load("@rules_tuist//:apple.bzl", "apple_preview")

apple_preview(name = "preview_ios", app = ":ios_app")
apple_preview(name = "preview_macos", app = ":macos_app")
```

Para targets ejecutables como `cc_binary`:

```starlark
load("@rules_tuist//:executable.bzl", "executable_preview")

executable_preview(name = "preview_cli", binary = ":my_tool")
```

La preview ejecutable incluye los archivos de runtime declarados por el target. Declara las bibliotecas y recursos que tu herramienta necesita en su target de Bazel y usa rutas que funcionen fuera de tu directorio de build.

## Compilar y publicar

```bash
bazel run //:preview_android -- \
  --publish --project acme/app --track review
bazel run //:preview_ios --platforms=//platforms:ios_simulator -- \
  --publish --project acme/app --track review
bazel run //:preview_macos -- --publish --project acme/app --track review
bazel run //:preview_cli -- --publish --project acme/app --track review
```

Sustituye las etiquetas de aplicación y plataforma del simulador por las tuyas. Pasa `--url` para un origen de Tuist autoalojado y `--revision` para asociar un commit de Git.

Pasa `--publish --project account/project` para compartir una compilación exitosa. Sin `--publish`, o con `--no-publish`, no se sube nada y no se requiere inicio de sesión. Un `bazel build` ordinario nunca publica, incluso en aciertos de caché. `tuist bazel setup` habilita la caché y los insights, no la publicación.

## Salidas admitidas

- **Android:** APKs de aplicación firmadas, incluidas las builds de depuración. Instala las build-tools y las herramientas de línea de comandos del Android SDK, y configura `ANDROID_HOME` o `ANDROID_SDK_ROOT`. Los APK de test y los Android App Bundles no son compatibles.
- **Apple:** aplicaciones para el simulador y macOS firmadas ad-hoc, compiladas y verificadas en macOS. Las builds para dispositivos físicos, frameworks, extensiones y tests no son compatibles. Usa la salida de archive en lugar de los tree archives experimentales.
- **Herramientas de línea de comandos:** ejecutables para macOS o Linux en arm64 o x86_64, incluidos binarios universales de macOS. Los scripts requieren una shebang y un intérprete en el sistema del destinatario. Declara las dependencias de runtime en tu target; Tuist no instala bibliotecas faltantes ni runtimes de lenguaje.

## Repetición de caché, fallos y retención

Repetir la misma publicación reutiliza la preview existente sin volver a subirla, incluso cuando Bazel restaura la build desde la caché. Cambiar la salida, el track o la revisión crea una nueva publicación. Un fallo de subida hace fallar el comando; puedes volver a ejecutarlo para comprobar si la publicación se completó antes de intentarlo de nuevo.

El comando enlaza con las previews de tu proyecto, donde el procesamiento puede tardar un momento. Las previews usan la visibilidad predeterminada del proyecto.

Las publicaciones de artefactos caducan a los 30 días en Tuist alojado. Las instancias autoalojadas usan `TUIST_APP_PREVIEW_RETENTION_DAYS`; dejarlo sin configurar desactiva la caducidad para esta familia. Los registros de publicación caducados no pueden reactivarse repitiendo la misma intención.

Consulta <.localized_link href="/guides/features/previews#run-a-preview">Ejecutar una preview</.localized_link> para ejecutar builds publicadas, gestionar el acceso, los tracks y las insignias de README.

## Previews de Apple

Para previews del simulador de Apple y macOS, consulta las <.localized_link href="/guides/features/previews/run/macos">instrucciones de la app complementaria de Tuist para macOS</.localized_link>. Esto no cambia los requisitos de elegibilidad de la aplicación ni de firma de Bazel.

## Flujos de trabajo relacionados {#publish-from-once}

Las integraciones existentes de Once tienen una <.localized_link href="/guides/features/previews/once">guía de publicación de artefactos</.localized_link> separada. Ambos flujos mantienen la publicación separada de la ejecución del grafo en caché.
