Saltar al contenido

Previsualizaciones de Xcode

Compila tu aplicación y luego usa tuist share para publicarla en tu proyecto de Tuist. Conecta primero tu proyecto siguiendo la guía de proyecto de Xcode existente o de proyecto generado.

Compilar y compartir#

Para un proyecto generado por Tuist:

bash
tuist generate App
tuist xcodebuild build -scheme App -workspace App.xcworkspace \
-configuration Debug -sdk iphonesimulator
tuist share App

Para un proyecto de Xcode existente:

bash
tuist xcodebuild build -scheme App -project App.xcodeproj \
-configuration Debug -sdk iphonesimulator
tuist share App --configuration Debug --platforms iOS

Sustituye los nombres del esquema, el proyecto y el espacio de trabajo por los tuyos. Para compartir una compilación de Release, usa -configuration Release al compilar y --configuration Release al compartir.

Dispositivos físicos#

Eres responsable de firmar las compilaciones para dispositivo con un perfil de aprovisionamiento que permita la instalación en el dispositivo del destinatario. Compila con un destino de dispositivo en lugar del SDK del simulador:

bash
tuist xcodebuild build -scheme App -project App.xcodeproj \
-configuration Debug -destination 'generic/platform=iOS'
tuist share App --configuration Debug --platforms iOS

También puedes compartir un IPA ya exportado:

bash
tuist share App.ipa

Los destinatarios pueden abrir un enlace de previsualización de IPA en su dispositivo móvil para instalar la aplicación. La autenticación y la visibilidad de las previsualizaciones del proyecto siguen aplicándose.

CI y números de compilación#

Usa tu autenticación de CI existente y haz que CFBundleVersion sea único para cada nueva compilación. Por ejemplo, usa ${{ github.run_number }} de GitHub Actions. Volver a subir el mismo binario y número de compilación mediante tuist share produce un error en lugar de crear un duplicado.

bash
tuist share App --track beta --release-notes "Fix sign-in"

Consulta Ejecutar una previsualización para ejecutar compilaciones publicadas, gestionar el acceso, los canales y las insignias del README.

Canales con tuist share#

Para flujos de trabajo que publican con tuist share, usa --track para seleccionar un canal:

bash
tuist share App --track beta
tuist share App --track nightly

Notas de la versión#

Usa canales para grupos de entornos y notas de la versión para el propósito de una compilación individual:

bash
tuist share App --track QA --release-notes "Fix sign-in and improve the checkout flow"

Reemplaza App por el nombre de tu app, la ruta del archivo de la aplicación o la distribución ejecutable y su opción --executable. Las notas de la versión son texto plano opcional, de hasta 10.000 caracteres. La primera línea no vacía aparece como un fragmento de una sola línea en las listas de previsualizaciones, de modo que los números de compilación y otra información identificativa son visibles de un vistazo. Las líneas largas se truncan; las notas completas aparecen en las páginas de detalle. Las búsquedas coinciden con los nombres visibles y las notas de la versión completas, incluidas las líneas que no se muestran en el fragmento. Se admiten notas multilínea, por ejemplo --release-notes "$(< release-notes.txt)". No cambian el nombre visible de la app ni su canal.

Compatibilidad#

Las notas de la versión no cambian a qué previsualización pertenece una compilación. Se conservan las primeras notas que recibe una previsualización: una subida posterior puede añadir notas a una previsualización que no tenga, pero no puede sobrescribir ni borrar las existentes. Las previsualizaciones subidas antes de que existieran las notas de la versión siguen siendo válidas sin ellas.

Los despliegues autoalojados necesitan una versión del servidor que admita notas de la versión y filtrado por canal, junto con un cliente actualizado. Los servidores antiguos ignoran las notas. Para los filtros de canal y búsqueda de los endpoints de listado, consulta la referencia de la API.

Comentarios en solicitudes de pull/merge#

Integración con Git forge necesaria

Para obtener comentarios automáticos en solicitudes de pull/merge, integra tu proyecto remoto con un Git forge: GitHub, Cursor Origin o Entire.

Una vez que tu proyecto Tuist esté conectado con tu plataforma Git, añade tuist share tras una compilación exitosa de la aplicación en CI. Tuist publicará un enlace de previsualización directamente en tus solicitudes de pull/merge, para que los revisores puedan probar sin compilar localmente:

Comentario de la app de GitHub con un enlace a Tuist Preview

Automatizaciones#

Usa --json para obtener salida JSON de tuist share:

bash
tuist share --json

Usa el resultado para automatizaciones personalizadas, como publicar un mensaje en Slack desde CI. La clave url contiene el enlace completo a la previsualización; qrCodeURL apunta a una imagen de código QR para abrir la previsualización en un dispositivo:

json
{
"id": 1234567890,
"url": "https://tuist.dev/preview/1234567890",
"qrCodeURL": "https://tuist.dev/preview/1234567890/qr-code.svg"
}

Los destinatarios pueden usar la app de Tuist para macOS o la app para iPhone con independencia de la integración con el sistema de compilación. La guía para iPhone también cubre las notificaciones de actualización dentro de la app con el SDK de Tuist.