콘텐츠로 이동

생성된 Xcode 프로젝트

Note

자동 생성된 스킴에는 tuist inspect build 포스트 액션이 자동으로 포함됩니다.

생성된 스킴에서 빌드 인사이트를 추적하지 않으려면 buildInsightsDisabled을 사용하여 비활성화하세요.

사용자 정의 스킴이 포함된 생성된 프로젝트를 사용하는 경우, 포스트 액션을 직접 추가해야 합니다. Mise의 경우:

swift
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")
)
]
)

Mise를 사용하지 않는 경우, Xcode 포스트 액션이 셸의 PATH을 상속받지 않기 때문에 스킴 환경에서 tuist를 사용할 수 있도록 해야 합니다. Homebrew 설치의 경우:

swift
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
)

CI에서 빌드 인사이트#

CI에서 빌드 인사이트를 추적하려면 CI가 인증되었는지 확인하세요.

Xcodebuild 기반 CI에서는 다음이 필요합니다:

  • xcodebuild 액션을 호출할 때 tuist xcodebuild을 사용하세요.
  • xcodebuild 명령에 -resultBundlePath을 추가하세요.

-resultBundlePath이 없으면 필요한 활동 로그와 결과 번들이 생성되지 않으며 tuist inspect build이 빌드를 분석할 수 없습니다.

개인 네트워크에서 자격 증명 없이 리포트 전송하기#

셀프 호스팅 배포는 개발자가 로그인하지 않고도 완료된 리포트를 게시할 수 있도록 허용합니다. 운영자는 인스턴스에 TUIST_NETWORK_TRUSTED_INSIGHTS_ACCESS=true를 구성하고 셀프 호스팅 가이드에 설명된 대로 인스턴스를 재시작해야 합니다. 이는 지원되는 모든 프로젝트에 적용되며 대시보드 설정은 없습니다. 스키마의 사후 작업이나 터미널에서 사용하는 환경에 셀프 호스팅 URL과 프로젝트를 구성하세요. CLI는 자격 증명이 없을 때 인스턴스 정책을 자동으로 검색합니다.

bash
export TUIST_URL="https://tuist.internal.example"
tuist inspect build
# To publish local test results:
tuist inspect test

자격 증명이 실제로 없는 경우, 활동 로그와 XCResult 번들이 로컬에서 파싱되어 구조화된 리포트로 전송됩니다. 원본 아카이브, 첨부 파일, 커버리지/히스토리 업로드, 원격 프로세서, 샤드 참조 또는 선택적 실행 증거는 제출되지 않습니다. 리포트는 계속 표시되지만 인증된 테스트 케이스 상태를 업데이트하거나 격리/실패 자동화를 트리거할 수는 없습니다. 대시보드 및 기타 권한이 필요한 명령어는 여전히 로그인이 필요합니다. 인스턴스에서 별도로 네트워크 신뢰 캐시 접근을 활성화하거나 자격 증명이 제공되지 않는 한 캐시 통합은 비활성화 상태로 유지하세요.

현재 자격 증명은 인증된 상태로 유지됩니다. 유효하지 않거나 손상되었거나 비어 있거나 갱신이 거부된 자격 증명은 차단되고 디스크에 남아 있으므로 이후 명령어가 자동으로 비인증 상태가 되지 않습니다. 의도적인 복구 조치로 다시 로그인하거나 명시적으로 로그아웃하세요. 자격 증명 없는 클라이언트를 업그레이드하기 전에 모든 서버 복제본을 검색 기능이 있는 버전으로 업그레이드하고 리디렉션 없이 최종 서버 URL을 구성하세요. 검색 기능이 없는 이전 서버, 비활성화된 인스턴스 및 검색 실패 시에는 여전히 인증이 필요합니다. 클라이언트 측 옵트인은 필요하지 않습니다. 구성된 액터 클레임을 생략하려면 TUIST_ACTOR_ID=""를 독립적으로 설정하세요. 검증된 자격 증명 신원에는 영향을 주지 않습니다.

머신 메트릭#

빌드 인사이트에는 빌드 중에 캡처된 머신 수준의 성능 메트릭(CPU, 메모리, 네트워크 및 디스크 사용량)이 포함될 수 있습니다. 이를 활성화하려면 시스템 메트릭을 지속적으로 샘플링하는 경량 백그라운드 데몬을 설정하세요:

bash
tuist setup insights

이 명령은 백그라운드에서 메트릭을 샘플링하는 로컬 데몬을 실행합니다. 데이터는 tuist inspect build에 의해 자동으로 수집되어 빌드 리포트와 함께 업로드됩니다.

디스크 메트릭에는 읽기/쓰기 활동과 호환되는 CLI 및 서버가 있는 경우 macOS 시스템 데이터 볼륨(/System/Volumes/Data)의 총 공간과 사용 가능 공간이 포함됩니다. 사용 가능 공간에는 정리 가능한 공간이 제외됩니다. 디스크 공간 차트는 업로드 시점뿐만 아니라 빌드 전체 기간 동안의 총 용량과 함께 사용된 공간(총 공간에서 사용 가능 공간을 뺀 값)을 표시합니다. 체크아웃이나 DerivedData에 사용되는 별도의 외부 볼륨은 측정하지 않습니다.

CLI를 업그레이드한 후 tuist teardown insights를 실행하고 이어 tuist setup insights를 실행하여 기존 샘플러를 다시 시작하세요. 샘플링은 빌드 중에 실행되어야 합니다. 이전 리포트와 실패한 측정값에는 디스크 공간 값이 없으며 0으로 표시되지 않습니다. 디스크 공간 샘플은 기존 90일 머신 메트릭 보존 정책을 따릅니다.

CI

CI 머신에서도 머신 메트릭을 캡처하려면 빌드 전에 tuist setup insights를 실행하세요.

머신 메트릭 수집을 중지하려면 다음을 실행하세요:

bash
tuist teardown insights

이 명령은 데몬의 LaunchAgent를 언로드하고 plist를 제거하며 ~/.local/state에서 샘플링된 메트릭과 데몬 로그를 삭제하므로 백그라운드에서 실행되는 프로세스가 남지 않습니다.

보고서 작성자 클레임#

보고서 생성 요청은 TUIST_ACTOR_ID를 조직 범위 라벨로 명시적으로 설정한 경우에만 선택적 x-tuist-actor-id 헤더를 포함합니다. 예를 들어 TUIST_ACTOR_ID=employee-123 tuist inspect build와 같이 설정할 수 있습니다. 기본적으로 라벨은 전송되지 않으며, Tuist는 운영 체제 사용자 이름을 감지하지 않습니다. 빈 TUIST_ACTOR_ID는 보고된 식별자를 생략하지만 자격 증명 기반의 검증된 신원을 제거하지는 않습니다. 식별자는 공백이 없는 인쇄 가능한 ASCII 문자 1~128바이트여야 하며, 잘못된 재정의 값은 대체 없이 생략됩니다. 커스텀 프록시가 익숙하지 않은 헤더를 거부하는 경우, 빈 환경 변수 재정의 값을 사용하여 옵트아웃하세요.

검증된 개별 자격 증명이 우선하며, 그렇지 않은 경우 클라이언트가 보고한 식별자는 검증되지 않음으로 표시되며 권한을 부여하거나 사용자와 자동으로 연결되지 않습니다. 식별자는 프로젝트 보고서를 볼 수 있는 모든 사람에게 공개되며, 프로젝트가 공개된 경우 공개 뷰어에게도 보이고 데이터 내보내기에 포함되므로 비밀 정보를 포함하지 마세요. 이는 빌드, 테스트 및 명령 이벤트 보고서에 적용됩니다. 이전 서버는 선택적 헤더를 무시하며, 새로운 서버는 해당 헤더가 없는 이전 클라이언트를 허용합니다. 식별자가 없는 새로운 공유 토큰 보고서는 게시 조직 대신 알 수 없음으로 표시됩니다. 기존 보고서는 이전 속성 정보를 유지합니다. 빌드 및 테스트 목록에서는 검증된 사용자와 검증되지 않은 보고 식별자를 구분합니다. 자체 호스팅 인스턴스가 자격 증명 없는 보고를 명시적으로 활성화하고 클라이언트가 해당 정책을 발견하지 않는 한 인증은 여전히 필요합니다.

스킴 사후 작업#

작성자 클레임은 기본적으로 비활성화되어 있습니다. 스킴 사후 작업을 구성하려면 셸 내보내기에 의존하지 않고 해당 스크립트에서 TUIST_ACTOR_ID를 설정하세요. Dock에서 실행된 Xcode는 ~/.zshrc의 변수를 상속하지 않습니다. Homebrew를 사용하여 구성된 클레임을 명시적으로 억제하려면 다음을 사용하세요:

bash
export PATH="/opt/homebrew/bin:/usr/local/bin:$PATH"
export TUIST_ACTOR_ID=""
tuist inspect build

Mise를 사용하는 경우, Mise가 환경을 로드한 후 값을 재정의하세요:

bash
$HOME/.local/bin/mise x -C "$SRCROOT" -- env TUIST_ACTOR_ID="" tuist inspect build

빈 값 대신 명시적 라벨을 사용하여 옵트인하세요.

사용자 정의 메타데이터#

환경 변수를 사용하여 빌드에 메타데이터를 첨부하면 필터링을 개선할 수 있습니다.

환경 변수#

변수 형식 설명
TUIST_BUILD_TAGS 쉼표로 구분 하나의 변수에 여러 태그를 포함합니다.
TUIST_BUILD_VALUE_* 단일 값 접미사가 키인 키-값 쌍입니다.

예시#

빌드를 실행하기 전에 CI 또는 셸에서 이러한 값을 설정하세요:

bash
export TUIST_BUILD_TAGS="nightly,ios-team,release-candidate"
bash
export TUIST_BUILD_VALUE_TICKET="PROJ-1234"
export TUIST_BUILD_VALUE_PR_URL="https://github.com/myorg/myrepo/pull/123"