Proyecto de Xcode generado
Los esquemas generados automáticamente incluyen la acción posterior tuist inspect build.
Si no quieres realizar el seguimiento de los análisis de compilaciones en los esquemas generados, desactívalo mediante buildInsightsDisabled.
Si utilizas proyectos generados con esquemas personalizados, debes añadir la acción posterior tú mismo. Para Mise:
let project = Project(
name: "MyProject",
targets: [
// Your targets
],
schemes: [
.scheme(
name: "MyApp",
shared: true,
buildAction: .buildAction(
targets: ["MyApp"],
postActions: [
.executionAction(
title: "Inspect Build",
scriptText: """
$HOME/.local/bin/mise x -C $SRCROOT -- tuist inspect build
""",
target: "MyApp"
)
],
runPostActionsOnFailure: true
),
runAction: .runAction(configuration: "Debug")
)
]
)
Si no utilizas Mise, debes asegurarte de que tuist esté disponible en el entorno del esquema, ya que las acciones posteriores de Xcode no heredan el PATH de tu shell. Para instalaciones de Homebrew:
buildAction: .buildAction(
targets: ["MyApp"],
postActions: [
.executionAction(
title: "Inspect Build",
scriptText: """
export PATH="/opt/homebrew/bin:/usr/local/bin:$PATH"
tuist inspect build
""",
target: "MyApp"
)
],
runPostActionsOnFailure: true
)
Análisis de compilaciones en CI#
Para rastrear los análisis de compilaciones en CI, asegúrate de que la CI esté autenticada.
Para una CI impulsada por Xcodebuild necesitas:
- Usa
tuist xcodebuildal invocar acciones dexcodebuild. - Añade
-resultBundlePatha tu comando dexcodebuild.
Sin -resultBundlePath, no se generan los registros de actividad ni los paquetes de resultados necesarios y tuist inspect build no puede analizar la compilación.
Informes sin credenciales en una red privada#
Un despliegue autoalojado puede permitir a los desarrolladores publicar informes completados sin iniciar sesión. Un operador debe configurar TUIST_NETWORK_TRUSTED_INSIGHTS_ACCESS=true en la instancia y reiniciarla como se describe en la guía de autoalojamiento. Esto se aplica a todos los proyectos compatibles; no existe una configuración en el panel de control. Configura la URL autoalojada y el proyecto en el entorno que usa tu esquema de posacción o terminal. La CLI descubre automáticamente la política de la instancia cuando faltan las credenciales:
export TUIST_URL="https://tuist.internal.example"
tuist inspect build
# To publish local test results:
tuist inspect test
Cuando realmente faltan las credenciales, los registros de actividad y los paquetes XCResult se analizan localmente y se envían como informes estructurados. No se sube ningún archivo sin procesar, adjunto, cobertura/historial, procesador remoto, referencia de fragmento ni evidencia de ejecución selectiva. Los informes siguen siendo visibles, pero no pueden actualizar el estado autenticado de los casos de prueba ni activar automatizaciones de cuarentena o fallo. El panel de control y otros comandos con privilegios aún requieren inicio de sesión. Mantén deshabilitada la integración de caché, a menos que la instancia habilite por separado el acceso de confianza a la caché por red o se aprovisionen credenciales.
Las credenciales presentes permanecen autenticadas. Las credenciales no válidas, dañadas, vacías o con actualización rechazada fallan de forma segura y permanecen en disco, de modo que los comandos posteriores no quedan sin firmar silenciosamente. Vuelve a iniciar sesión o cierra sesión explícitamente como acción de recuperación deliberada. Actualiza cada réplica del servidor a una versión compatible con el descubrimiento antes de actualizar los clientes sin credenciales y configura la URL final del servidor sin redirecciones. Los servidores antiguos sin descubrimiento, las instancias deshabilitadas y los fallos de descubrimiento aún requieren autenticación. No es necesaria ninguna opción opt-in del lado del cliente. Establece TUIST_ACTOR_ID="" de forma independiente para omitir la reclamación de actor configurada; la identidad verificada de la credencial no se ve afectada.
Métricas de la máquina#
Los análisis de compilaciones pueden incluir métricas de rendimiento a nivel de máquina (CPU, memoria, red y uso de disco) capturadas durante la compilación. Para habilitarlo, configura un demonio ligero en segundo plano que muestree continuamente las métricas del sistema:
tuist setup insights
Esto ejecuta un demonio local que muestrea las métricas en segundo plano. Los datos son recogidos automáticamente por tuist inspect build y se suben junto con el informe de compilación.
Las métricas de disco incluyen la actividad de lectura/escritura y, con una CLI y un servidor compatibles, el espacio total y disponible en el volumen de datos del sistema macOS (/System/Volumes/Data). El espacio disponible excluye el espacio purgable. El gráfico de espacio en disco muestra el espacio utilizado (total menos disponible) junto con la capacidad total durante la compilación, no solo en el momento de la subida. No mide volúmenes externos separados utilizados para un checkout o DerivedData.
Después de actualizar la CLI, reinicia un muestreador existente con tuist teardown insights seguido de tuist setup insights. El muestreo debe estar ejecutándose durante la compilación; los informes antiguos y las mediciones fallidas no tienen valores de espacio en disco y no se muestran como cero. Las muestras de espacio en disco siguen la retención existente de 90 días para las métricas de la máquina.
Ejecuta tuist setup insights en tus máquinas de CI antes de compilar para capturar también las métricas de la máquina allí.
Para dejar de recopilar métricas de la máquina, ejecuta:
tuist teardown insights
Esto descarga el LaunchAgent del demonio, elimina su plist y borra las métricas muestreadas y los registros del demonio de ~/.local/state, por lo que no queda nada ejecutándose en segundo plano.
Reclamación de actor del informe#
Las solicitudes de creación de informes incluyen la cabecera opcional x-tuist-actor-id solo cuando estableces explícitamente TUIST_ACTOR_ID con una etiqueta del ámbito de la organización, por ejemplo TUIST_ACTOR_ID=employee-123 tuist inspect build. Por defecto no se envía ninguna etiqueta y Tuist no detecta los nombres de usuario del sistema operativo. Un valor vacío en TUIST_ACTOR_ID omite el identificador informado, pero no elimina la identidad verificada basada en credenciales. Los identificadores deben tener entre 1 y 128 bytes de caracteres ASCII imprimibles que no sean espacios; las anulaciones no válidas se omiten sin recurrir a valores predeterminados. Si un proxy personalizado rechaza cabeceras desconocidas, opta por no participar usando la anulación de entorno vacía.
Las credenciales individuales verificadas tienen prioridad; los identificadores informados por el cliente se muestran como No verificado y nunca otorgan permisos ni se vinculan automáticamente a usuarios. Los identificadores son visibles para cualquiera que pueda ver los informes del proyecto, incluidos los espectadores públicos cuando el proyecto es público, y se incluyen en las exportaciones de datos, así que no incluyas secretos. Esto se aplica a los informes de compilación, pruebas y eventos de comandos. Los servidores antiguos ignoran la cabecera opcional y los servidores nuevos aceptan clientes antiguos sin ella. Los nuevos informes con token compartido que no tienen identificador muestran Desconocido, en lugar de la organización que los publica; los informes históricos conservan su atribución anterior. Los listados de compilaciones y pruebas distinguen a los usuarios verificados de los identificadores informados no verificados. La autenticación sigue siendo necesaria a menos que la instancia autoalojada habilite explícitamente los informes sin credenciales y el cliente detecte esa política.
Acciones posteriores del esquema#
Las reclamaciones de actor están desactivadas por defecto. Para configurar una para una acción posterior de un esquema, establece TUIST_ACTOR_ID en ese script en lugar de depender de las variables de entorno del shell. Xcode lanzado desde el Dock no hereda las variables de ~/.zshrc. Para suprimir explícitamente una reclamación configurada con Homebrew, usa:
export PATH="/opt/homebrew/bin:/usr/local/bin:$PATH"
export TUIST_ACTOR_ID=""
tuist inspect build
Con Mise, anula el valor después de que Mise cargue su entorno:
$HOME/.local/bin/mise x -C "$SRCROOT" -- env TUIST_ACTOR_ID="" tuist inspect build
Usa una etiqueta explícita en lugar del valor vacío para participar.
Metadatos personalizados#
Puedes adjuntar metadatos a las compilaciones mediante variables de entorno para mejorar el filtrado.
Variables de entorno#
| Variable | Formato | Descripción |
|---|---|---|
TUIST_BUILD_TAGS |
Separado por comas | Varias etiquetas en una sola variable. |
TUIST_BUILD_VALUE_* |
Valor único | Par clave-valor donde el sufijo es la clave. |
Ejemplos#
Establece estos valores en tu CI o en tu shell antes de invocar tu compilación:
export TUIST_BUILD_TAGS="nightly,ios-team,release-candidate"
export TUIST_BUILD_VALUE_TICKET="PROJ-1234"
export TUIST_BUILD_VALUE_PR_URL="https://github.com/myorg/myrepo/pull/123"