發布管道

Tuist CLI 透過三個管道提供，各自具備不同的穩定性保證。建議的安裝版本為 stable，更新節奏較慢：它不會在每次功能合併時就推進，因此升級不再意味著要吸收一批不相干的變更。早期採用者仍可在 canary 上執行每次提交的建置，而 release candidate 管道則讓團隊在版本成為穩定版之前，先行試用即將發布的版本線。

各管道#

管道	版本格式	更新頻率	預設解析？
Canary	`X.Y.0-canary.N`（例如 `4.201.0-canary.42`）	每次提交至 `main`	否 — 需明確選擇
Release candidate	`X.Y.0-rc.N`（例如 `4.200.0-rc.1`）	每週一從 `main` 切出，試用約 1 週	否 — 需明確選擇
Stable	`X.Y.Z`（例如 `4.200.0`、`4.200.1`）	經過順利試用後，於每週一提升為穩定版	是

Canary 與 release candidate 建置會以預發布版本的形式發布。Mise 與 Homebrew 等工具在解析 latest、一般安裝或鎖定版本線時，會排除預發布版本，因此除非你明確指定，否則不會安裝到這些版本。

Canary#

每次提交至 main 都會發布一個 canary 版本。Canary 始終代表 下一個尚未發布的次要版本：一旦某個版本線被切出準備發布，main 就會推進到下一個次要版本（例如從 4.200.0-canary.42 到 4.201.0-canary.1）。如果你希望盡早獲得最新訊號，或想在修復進入穩定版之前驗證你所回報或貢獻的修正是否符合預期，Canary 是適合的管道。

Release candidate#

當某個次要版本準備發布時，其版本線會被凍結至受保護的 releases/<major>.<minor>.x 分支，並以 X.Y.0-rc.1 的形式發布。該版本線會凍結新功能；只會挑選關鍵修正與回歸修復，且每接受一項修正就會遞增 RC 編號（-rc.2、-rc.3、…）。在順利完成試用期後，該版本線會提升為穩定版。

Stable#

Stable 是建議使用的管道，也是所有文件指向的版本。只有在 release candidate 順利完成試用後，才會發布穩定版的次要版本（X.Y.0），而且當新功能合併至 main 時，它並不會推進。穩定版本線上的修補版本（X.Y.1、X.Y.2、…）僅包含回溯移植的修正，絕不包含新功能。

選擇版本#

使用 Mise（建議）：

bash

mise use tuist@latest              # Latest stable (recommended)
mise use [email protected]               # Pin to a stable line; receives backported fixes only
mise use [email protected]             # Pin to an exact stable patch
mise use [email protected]        # Opt into a release candidate to soak it
mise use [email protected]   # Opt into a specific canary build

使用 Homebrew 時，brew install --formula tuist 一律安裝最新的穩定版；預發布版本不會透過該公式發布。

建議策略#

鎖定穩定版本線，例如 [email protected]。該版本線僅接收回溯移植的修正，絕不包含新功能，因此日常升級的風險較低。
謹慎採用新功能。 當你準備好升級到下一個次要版本時，先在 release candidate 管道上試用，然後將你的版本鎖定移至新的穩定版本線。
嘗試 canary：若你是希望盡早獲得最新訊號的早期採用者，可在非關鍵環境中試用 canary。

支援與回溯移植#

任何時間點都會積極維護兩個穩定版本線：

版本線	接收內容
目前（`X.Y.x`）	回歸修復與安全性修正
前一版（`X.(Y-1).x`）	僅限關鍵修正與安全性修正
更舊版本	無 — 請升級至受維護的版本線

修正會先合併至 main（canary）。回歸修復與安全性修正會回溯移植到目前的穩定版本線，而前一版僅接收關鍵修正與安全性修正。其他錯誤修正不會回溯移植；它們會隨下一個次要版本一起發布。當新版本線提升為穩定版時，原本的「目前」版本線會變成「前一版」，而原本的「前一版」則停止接收回溯移植。

無論使用哪個管道，Tuist 伺服器都與過去 3 個月內發布的任何 CLI 保持相容，因此只要你在該期間內升級，鎖定穩定版本線就不會讓你超出支援範圍。