Shell 自動補全

如果你已全域安裝 Tuist（例如透過 Homebrew），你可以為 Bash 和 Zsh 安裝 Shell 自動補全，以自動完成指令與選項。

什麼是全域安裝

全域安裝是指安裝位置包含在你的 Shell $PATH 環境變數中。這表示你可以在終端機的任何目錄執行 tuist。這是 Homebrew 的預設安裝方式。

如果你已安裝 oh-my-zsh，你已經擁有一個會自動載入補全腳本的目錄 — .oh-my-zsh/completions。將新的補全腳本複製到該目錄中名為 _tuist 的新檔案：

bash

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

若沒有 oh-my-zsh，你需要將補全腳本的路徑加入函式路徑，並啟用補全腳本的自動載入。首先，將以下幾行加入 ~/.zshrc：

bash

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

接著，在 ~/.zsh/completion 建立一個目錄，並將補全腳本複製到該新目錄中，同樣命名為 _tuist。

bash

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

如果你已安裝 bash-completion，你可以直接將新的補全腳本複製到檔案 /usr/local/etc/bash_completion.d/_tuist：

bash

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

若沒有 bash-completion，你需要直接 source 補全腳本。將其複製到例如 ~/.bash_completions/ 的目錄，然後將以下這行加入 ~/.bash_profile 或 ~/.bashrc：

bash

source ~/.bash_completions/example.bash

如果你使用 fish shell，你可以將新的補全腳本複製到 ~/.config/fish/completions/tuist.fish：

bash

mkdir -p ~/.config/fish/completions
tuist --generate-completion-script > ~/.config/fish/completions/tuist.fish