Saltar al contenido

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 a MODULE.bazel, fijando el commit que quieras usar:

plaintext
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 autenticación OIDC 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:

plaintext
load("@rules_tuist//:android.bzl", "android_preview")
android_preview(name = "preview_android", app = ":android_app")

Para aplicaciones de Apple:

plaintext
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:

plaintext
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 Ejecutar una preview 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 instrucciones de la app complementaria de Tuist para macOS. Esto no cambia los requisitos de elegibilidad de la aplicación ni de firma de Bazel.

Flujos de trabajo relacionados#

Las integraciones existentes de Once tienen una guía de publicación de artefactos separada. Ambos flujos mantienen la publicación separada de la ejecución del grafo en caché.