Install Tuist

Tuist CLI는 실행 가능한 동적 프레임워크와 일련의 리소스(예: 템플릿)로 구성되어 있습니다. 소스에서 수동으로 Tuist를 빌드할 수도 있지만, 올바른 설치를 위해 다음 설치 방법 중 하나를 사용하는 것이 좋습니다.

권장: Mise

Tuist의 버전을 체계적으로 관리하고 활성화하기 위한 도구로 Mise가 기본으로 사용됩니다. Mise가 시스템에 아직 설치되어 있지 않은 경우 다음 설치 방법 중 하나를 사용할 수 있습니다. 그리고 터미널에서 Tuist 프로젝트 디렉터리를 선택할 때 올바른 버전이 활성화되도록, Shell에 제안된 명령어를 추가하는 것을 잊지 마세요.

INFO

Mise는 디렉토리별로 버전을 관리하고 활성화 하여 각 환경에서 동일한 버전의 Tuist를 일관되게 사용할 수 있도록 하기 때문에 HomeBrew와 같은 대안보다 권장됩니다.

설치가 완료되면, 다음 명령어 중 하나를 통해 Tuist를 설치할 수 있습니다.

mise install tuist # .tool-versions/.mise.toml에 지정된 현재 버전을 설치합니다.
mise install [email protected] # 특정 버전 설치
mise install tuist@3 # 주요 버전 설치

단일 버전의 도구를 시스템 전반에 걸쳐 설치 및 활성화하는 Homebrew와 같은 도구와 달리 Mise는 버전을 시스템 전체에 또는 프로젝트별로 활성화해야 한다는 점에 유의하세요. 이 작업은 mise use를 실행하여 수행합니다.

mise use [email protected] # 현재 프로젝트에서 tuist-x.y.z 사용
mise use tuist@latest # 현재 디렉터리에서 최신 tuist를 사용합니다.
mise use -g [email protected] # 시스템의 기본값으로 tuist-x.y.z 사용
mise use -g tuist@system # 시스템의 tuist를 전역 기본값으로 사용합니다.

대안: Homebrew

여러 환경 에서 버전 고정이 필요하지 않다면, Homebrew와 제공되는 공식 패키지를 사용하여 Tuist를 설치할 수 있습니다.

brew tap tuist/tuist
brew install --formula tuist
brew install --formula [email protected]

Shell completions

Tuist를 시스템 전체(global installation)에 설치했다면, Bash와 Zsh의 명령어 및 옵션 자동 완성을 사용할 수 있도록 shell completions을 설치할 수 있습니다.

Global installation란?

Global installation는 Shell의 $PATH 환경 변수에 포함된 설치를 말합니다. 즉, 터미널의 모든 디렉토리에서 tuist를 실행할 수 있습니다.이것은 Homebrew의 기본 설치 방법입니다. 이것은 Homebrew의 기본 설치 방법입니다.

Zsh

oh-my-zsh가 설치되어 있다면, 이미 자동으로 로드되는 완성 스크립트(completion script)들이 저장된 디렉터리인 .oh-my-zsh/completions가 있습니다. 새로운 완성 스크립트를 해당 디렉터리의 _tuist라는 새 파일에 복사합니다.

tuist --generate-completion-script > ~/.oh-my-zsh/completions/_tuist

oh-my-zsh가 없는 경우 함수 경로에 완성 스크립트 경로를 추가하고, 완성 스크립트 자동 로딩을 설정해야 합니다. 먼저 ~/.zshrc에 다음 줄을 추가합니다

fpath=(~/.zsh/completion $fpath)
autoload -U compinit
compinit

그런 다음, ~/.zsh/complication에 디렉터리를 생성한 후, 완성 스크립트를 해당 디렉터리의 _tuist라는 파일에 복사합니다.

tuist --generate-completion-script > ~/.zsh/completion/_tuist

Bash

bash-complement](https://github.com/scop/bash-completion)가 설치되어 있다면, 새로운 완성 스크립트를 /usr/local/etc/bash_complement.d/_tuist 파일에 복사하기만 하면 됩니다.

tuist --generate-completion-script > /usr/local/etc/bash_completion.d/_tuist

bash-completion이 없으면 완성 스크립트를 직접 불러와야 합니다. 해당 스크립트를 ~/.bash_completions/와 같은 디렉터리로 복사한 다음 ~/.bash_profile 또는 ~/.bashrc에 다음 줄을 추가합니다.

source ~/.bash_completions/example.bash