디렉터리

Tuist는 XDG Base Directory Specification을 따라 시스템의 여러 디렉터리에 파일을 정리합니다. 이를 통해 구성, 캐시 및 상태 파일을 깔끔하고 표준화된 방식으로 관리할 수 있습니다.

지원되는 환경 변수#

Tuist는 표준 XDG 변수와 Tuist 전용 접두사 변형을 모두 지원합니다. Tuist 전용 변형(TUIST_ 접두사)이 우선 적용되므로 다른 애플리케이션과 별도로 Tuist를 구성할 수 있습니다.

구성 디렉터리#

환경 변수:

TUIST_XDG_CONFIG_HOME (우선 적용)
XDG_CONFIG_HOME

기본값:~/.config/tuist

사용 목적:

서버 자격 증명 (credentials/{host}.json)

예시:

bash

# Set Tuist-specific config directory
export TUIST_XDG_CONFIG_HOME=/custom/config
tuist auth login

# Or use standard XDG variable
export XDG_CONFIG_HOME=/custom/config
tuist auth login

캐시 디렉터리#

환경 변수:

TUIST_XDG_CACHE_HOME (우선 적용)
XDG_CACHE_HOME

기본값:~/.cache/tuist

사용 목적:

Plugins: 다운로드 및 컴파일된 플러그인 캐시
ProjectDescriptionHelpers: 컴파일된 프로젝트 설명 헬퍼
Manifests: 캐시된 매니페스트 파일
Projects: 생성된 자동화 프로젝트 캐시
EditProjects: edit 명령어용 캐시
Runs: 테스트 및 빌드 실행 분석 데이터
Binaries: 빌드 아티팩트 바이너리(환경 간 공유 불가)
SelectiveTests: 선택적 테스팅 캐시

예시:

bash

# Set Tuist-specific cache directory
export TUIST_XDG_CACHE_HOME=/tmp/tuist-cache
tuist cache

# Or use standard XDG variable
export XDG_CACHE_HOME=/tmp/cache
tuist cache

상태 디렉터리#

환경 변수:

TUIST_XDG_STATE_HOME (우선 적용)
XDG_STATE_HOME

기본값:~/.local/state/tuist

사용 목적:

Sessions: 세션 로그 및 네트워크 기록 (sessions/{uuid}/)
Locks: 인증 잠금 파일 ({handle}.sock)

예시:

bash

# Set Tuist-specific state directory
export TUIST_XDG_STATE_HOME=/var/log/tuist
tuist generate

# Or use standard XDG variable
export XDG_STATE_HOME=/var/log
tuist generate

우선 순위#

사용할 디렉터리를 결정할 때 Tuist는 다음 순서로 환경 변수를 확인합니다:

Tuist 전용 변수(예: TUIST_XDG_CONFIG_HOME)
표준 XDG 변수(예: XDG_CONFIG_HOME)
기본 위치(예: ~/.config/tuist)

이를 통해 다음을 수행할 수 있습니다:

표준 XDG 변수를 사용하여 모든 애플리케이션을 일관되게 정리
Tuist에 다른 위치가 필요하면 Tuist 전용 변수로 재정의하세요
별도 구성 없이 합리적인 기본값을 사용하세요

일반적인 사용 사례#

프로젝트별 Tuist 격리#

프로젝트별로 Tuist의 캐시와 상태를 격리할 수 있습니다:

bash

# In your project's .envrc (using direnv)
export TUIST_XDG_CACHE_HOME="$PWD/.tuist/cache"
export TUIST_XDG_STATE_HOME="$PWD/.tuist/state"
export TUIST_XDG_CONFIG_HOME="$PWD/.tuist/config"

CI/CD 환경#

CI 환경에서는 임시 디렉터리를 사용할 수 있습니다:

yaml

# GitHub Actions example
env:
  TUIST_XDG_CACHE_HOME: /tmp/tuist-cache
  TUIST_XDG_STATE_HOME: /tmp/tuist-state

jobs:
  build:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v4
      - run: tuist generate
      - name: Upload logs
        if: failure()
        uses: actions/upload-artifact@v4
        with:
          name: tuist-logs
          path: /tmp/tuist-state/logs/*.log

격리된 디렉터리로 디버깅하기#

문제를 디버깅할 때 깨끗한 상태에서 시작하고 싶다면:

bash

# Create temporary directories for debugging
export TUIST_XDG_CACHE_HOME=$(mktemp -d)
export TUIST_XDG_STATE_HOME=$(mktemp -d)
export TUIST_XDG_CONFIG_HOME=$(mktemp -d)

# Run Tuist commands
tuist generate

# Clean up when done
rm -rf $TUIST_XDG_CACHE_HOME $TUIST_XDG_STATE_HOME $TUIST_XDG_CONFIG_HOME