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