# Previews de Once {#once-previews}

[Once](https://buildonce.dev/docs/guide/infrastructure/tuist#publish-application-previews) puede publicar artefactos de aplicación en Tuist para que tus compañeros puedan probar una compilación sin tener que recompilarla localmente. Esto requiere Once 0.74.0+ y un servidor de Tuist con el receptor de artefactos. Once 0.73.x utiliza en su lugar el adaptador heredado de carga única.

## Configurar el destino

Completa <.localized_link href="/guides/get-started/once-project">Primeros pasos con Once</.localized_link> y luego añade la vinculación de artefactos en el `once.toml` del espacio de trabajo. Reutiliza el proveedor si ya está configurado para la caché:

```toml
[infrastructures.tuist]
kind = "tuist"
account = "acme"
project = "app"

[infrastructure.artifacts]
name = "tuist"
```

```bash
once auth login --provider tuist
once artifact publish MyApplication --track review
```

El receptor conserva el conjunto completo, los manifiestos de miembros y las cargas útiles, incluidas las interfaces desconocidas. Las interfaces nativas compatibles se proyectan de forma asíncrona en las previews utilizando la visibilidad, el acceso y la distribución predeterminados del proyecto. El contenido genérico de los artefactos permanece privado, incluso en proyectos públicos. Un recibo confirma el almacenamiento del artefacto, no la finalización del procesamiento de la preview; su URL abre la lista de previews del proyecto.

## Aplicaciones elegibles

La proyección de Apple acepta metadatos `dev.once.apple-install.v2` para aplicaciones de macOS y del simulador firmadas ad-hoc exportadas en macOS. Las aplicaciones para dispositivos físicos no son elegibles. La proyección de Android acepta metadatos `dev.once.android-install.v1` con una firma verificada. Once aprueba la publicación automática solo para APKs firmados para depuración y sin instrumentación. Las interfaces desconocidas siguen siendo descargables como artefactos sin crear previews. Los enlaces de instalación de Android conservan un nombre de archivo `.apk` aunque las cargas útiles se almacenen bajo resúmenes de contenido.

## Activar la publicación después de las compilaciones

```toml
[infrastructure]
publish_on_build = ["MyApplication"]
```

```bash
once artifact publish MyApplication --allow-on-build
once build MyApplication
```

Todas las compilaciones solicitadas deben completarse con éxito. La publicación automática también requiere la aprobación del productor de todo el cierre y la autorización local para esta máquina, espacio de trabajo, endpoint exacto, destino y destino estable del proyecto de Tuist. Sin política o autorización, no se realizan solicitudes de red para la publicación de artefactos. Las compilaciones ordinarias de Once permanecen libres de efectos secundarios implícitos de publicación.

Volver a ejecutar la misma publicación retenida verifica el recibo remoto y evita otra subida. Esto difiere del comportamiento de compilación duplicada de `tuist share`.

## Retención

Las publicaciones de artefactos caducan después de 30 días en Tuist alojado. Las instancias autoalojadas utilizan `TUIST_APP_PREVIEW_RETENTION_DAYS`; dejarlo sin configurar desactiva la caducidad para esta familia. Los registros caducados permanecen como tumbas y no pueden reactivarse volviendo a ejecutar la misma intención. Los flujos de trabajo existentes de firma, visibilidad y distribución de `tuist share` permanecen sin cambios.

Consulta <.localized_link href="/guides/features/previews#run-a-preview">Ejecutar una preview</.localized_link> para ejecutar compilaciones publicadas, acceder, gestionar tracks y usar insignias de README.

## Previews de Apple

Para las previews elegibles del simulador de Apple y de macOS, consulta las <.localized_link href="/guides/features/previews/run/macos">instrucciones de la aplicación complementaria de Tuist para macOS</.localized_link>. Las aplicaciones para dispositivos físicos siguen sin ser elegibles para la publicación con Once.
