릴리스 채널

Tuist CLI는 서로 다른 안정성 보장을 제공하는 세 가지 채널을 통해 배포됩니다. 권장 설치 방식은 stable이며 변경 속도가 느립니다. 기능이 병합될 때마다 자동으로 업데이트되지 않으므로, 업그레이드 시 관련 없는 변경 사항을 일괄 적용하지 않아도 됩니다. 얼리 어답터는 canary에서 커밋 단위 빌드를 실행할 수 있으며, release candidate 채널을 사용하면 팀이 upcoming 라인이 stable이 되기 전에 충분히 검증할 수 있습니다.

채널#

채널	버전 형식	배포 주기	기본적으로 선택되나요?
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는 가장 빠른 신호를 원하는 얼리 어답터나, 보고하거나 기여한 수정 사항이 stable에 도달하기 전에 예상대로 동작하는지 검증하려는 경우에 적합한 채널입니다.

Release candidate#

마이너 버전을 출시할 준비가 되면 해당 라인은 보호된 releases/<major>.<minor>.x 브랜치로 고정되고 X.Y.0-rc.1로 게시됩니다. 이 라인은 기능 추가가 중단되며, 중요한 수정 사항과 회귀 문제만 선별 적용되고 각 수용된 수정 사항은 RC 버전을 증가시킵니다(-rc.2, -rc.3, …). 검증 기간이 문제 없이 종료되면 라인은 stable로 승격됩니다.

Stable#

Stable은 권장 채널이며 모든 문서에서 참조하는 채널입니다. Stable 마이너 버전(X.Y.0)은 release candidate가 문제 없이 검증된 후에만 게시되며, 새로운 기능이 main에 병합되더라도 업데이트되지 않습니다. Stable 라인의 패치 버전(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는 항상 최신 stable 버전을 설치하며, 프리릴리스는 formula를 통해 배포되지 않습니다.

권장 전략#

Stable 라인에 고정하세요. 예를 들어 [email protected]입니다. 해당 라인은 백포팅된 수정 사항만 수신하고 새로운 기능은 추가되지 않으므로 일상적인 업그레이드의 위험이 낮습니다.
새 기능을 신중하게 도입하세요. 다음 마이너 버전을 사용할 준비가 되면 release candidate 채널에서 검증한 후, 고정을 새로운 stable 라인으로 이동하세요.
가장 빠른 신호를 원하는 얼리 어답터라면 중요하지 않은 환경에서 canary를 시도해 보세요.

지원 및 백포트#

언제든지 두 개의 stable 라인이 활발히 유지됩니다:

라인	수신 대상
현재 (`X.Y.x`)	회귀 문제 및 보안 수정 사항
이전 (`X.(Y-1).x`)	중요 및 보안 수정 사항만
이전 버전	없음 — 유지 관리 중인 라인으로 업그레이드

수정 사항은 먼저 main(canary)에 적용됩니다. 회귀 문제와 보안 수정 사항은 현재 stable 라인으로 백포팅되며, 이전 라인은 중요 및 보안 수정 사항만 수신합니다. 다른 버그 수정 사항은 백포팅되지 않으며 다음 마이너 버전에 포함됩니다. 새로운 라인이 stable로 승격되면 기존 current 라인은 "previous"가 되고, 기존 "previous" 라인은 백포트 수신을 중단합니다.

채널과 무관하게 Tuist 서버는 지난 3개월 동안 출시된 모든 CLI와 호환 상태를 유지하므로, 해당 기간 내에 업그레이드하는 한 stable 라인에 고정해도 지원 범위에서 벗어나지 않습니다.