# 채널과 단계적 배포

채널은 설치된 앱이 따라가는 릴리스의 흐름입니다. 모든 데스크톱 앱은 `stable` 채널로 시작합니다. 빌드를 더 빨리 받고 싶은 사람을 위해 `beta`나 `nightly`를 추가할 수 있습니다. 릴리스를 게시할 때는 항상 채널을 지정하며, 게시한 순간부터 그 채널에서 업데이트를 확인하는 모든 앱에 해당 릴리스가 제공됩니다.

설치된 앱은 업데이터 엔드포인트에 들어간 채널(`?channel=beta`)을 확인하므로, 한 번 만든 채널은 이름을 바꾸거나 지울 수 없습니다. 앱 하나에 채널은 최대 10개입니다.

## 채널 탭

프로젝트를 열고 **데스크톱 릴리스 → 채널**로 이동합니다. 채널마다 다음을 보여 줍니다.

- 채널 이름. 누르면 채널 페이지가 열립니다.
- **표시됨** 또는 **숨김**. 표시한 채널은 공개 릴리스 페이지와 공개 릴리스 목록에 나옵니다.
- 지금 플랫폼별로 제공 중인 버전.

소유자와 관리자에게는 채널마다 **표시**/**숨기기** 버튼과 **채널 추가** 양식도 보입니다. 다른 멤버는 같은 페이지를 읽기만 합니다.

### 채널 추가

1. 이름을 입력합니다. 영문 소문자로 시작하고 소문자·숫자·하이픈만 씁니다(예: `beta`).
2. 공개 페이지에 보여야 하면 **릴리스 페이지에 표시**를 선택합니다.
3. **채널 추가**를 누릅니다.

빌드의 업데이터 엔드포인트에 `?channel=beta`를 넣어 그 채널을 따라가게 하고, 릴리스 페이지, Action(`channel`), CLI(`--channel`) 또는 `/v1`에서 그 채널에 게시합니다.

### 숨김은 비공개가 아닙니다

숨기기는 채널을 알리지 않을 뿐입니다. 업데이터, `latest.json`, `/latest/<platform>` 다운로드는 이름을 아는 사람에게 숨긴 채널도 계속 제공합니다. 비밀로 지켜야 하는 빌드에는 숨긴 채널을 쓰지 마세요.

## 채널 페이지

채널 이름을 누르면 채널 페이지가 열립니다.

- **지금 제공 중**: 플랫폼마다 채널이 제공하는 버전과 언제부터인지, 또는 **제공하는 버전 없음**을 보여 줍니다. 버전을 누르면 해당 릴리스가 열립니다. 단계적 배포가 진행 중이면 새 버전, 배포 비율, 일시 중지 여부도 함께 보여 줍니다.
- **단계적 배포**: 배포가 진행 중일 때 **비율 설정**, **일시 중지** 또는 **재개**, **완료**를 할 수 있습니다. 보호된 채널이면 페이지에 그렇게 표시되고, 비율 올리기·재개·완료는 승인 요청(**승인 요청**)으로 보내지며, 일시 중지와 비율 낮추기는 바로 적용됩니다.
- **기록**: 채널이 제공하는 버전이 바뀐 모든 기록(게시, 단계적 배포 변경, 철회)을 최신순으로, 누가 바꿨는지와 사유와 함께 보여 줍니다. **7일**, **30일**, **전체** 중에서 고를 수 있고, 선택한 기간은 페이지 주소에 들어가므로 같은 화면을 그대로 공유할 수 있습니다.
- 소유자와 관리자에게는 **표시**/**숨기기** 버튼과 숨긴 채널에 대한 같은 안내가 보입니다.