> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 업그레이드

> CLI의 최신 안정 릴리스를 확인하고 수동으로 업데이트하는 방법을 안내받습니다.

`xbox upgrade`는 GitHub에서 최신 안정 릴리스를 확인하고, 있으면 설치 방법을 알려 줍니다. 아무것도
다운로드하거나 설치하지 않으며, 로그인할 필요도 없습니다.

```bash theme={null}
xbox upgrade
```

## 옵션

| 옵션 | 설명 |
| - | - |
| `--check` | 최신 릴리스를 확인합니다. 이것이 기본값이므로 `xbox upgrade`와 `xbox upgrade --check`는 같은 작업을 수행합니다. |
| `--output <format>` | `json`(기본값) 또는 `json-compact`. `table`은 사용할 수 없습니다. |

아무것도 설치되지 않으므로 `--confirm`(`--yes`, `-y`)은 거부됩니다.

## 결과

확인에 성공하면 stdout에 JSON 개체 하나를 씁니다.

| 필드 | 설명 |
| - | - |
| `schemaVersion` | `1`. |
| `currentVersion` | 실행 중인 버전이며, `xbox --version`이 표시하는 버전과 같습니다. |
| `latestVersion` | 앞의 `v`를 뺀 최신 안정 릴리스입니다. |
| `updateAvailable` | 최신 안정 릴리스가 실행 중인 버전보다 최신이면 `true`입니다. |
| `releaseNotesUrl` | GitHub의 릴리스 페이지입니다. |
| `message` | 사람이 읽을 수 있는 요약입니다. |
| `instructions` | `updateAvailable`이 `true`일 때의 업데이트 방법이며, 그렇지 않으면 빈 배열입니다. |

```bash theme={null}
xbox upgrade --output json-compact
```

```json theme={null}
{"schemaVersion":1,"currentVersion":"1.2.0","latestVersion":"1.3.0","updateAvailable":true,"releaseNotesUrl":"https://github.com/xbox/cli/releases/tag/v1.3.0","message":"A newer stable XBOX CLI release is available. Update manually using the instructions below.","instructions":["..."]}
```

업데이트를 설치하려면 [ZIP 설치 업데이트](https://docs.xbox.com/ko/tools/xbox-cli/installation.md#update-a-zip-installation)를
참조하고, WinGet의 경우 [Windows: WinGet으로 설치](https://docs.xbox.com/ko/tools/xbox-cli/installation.md#windows-install-with-winget)를
참조하세요. 릴리스가 GitHub에 표시된 후 WinGet에 반영되기까지 몇 시간이 걸릴 수 있으므로, `winget upgrade`에서
아직 제공되지 않을 수 있습니다.

## 종료 코드

| 종료 코드 | 의미 |
| - | - |
| `0` | 업데이트 사용 가능 여부와 관계없이 확인에 성공했습니다. `updateAvailable`을 읽으세요. |
| `1` | 확인에 실패했으며 stdout은 비어 있습니다. |

확인 시 GitHub에 로그인하지 않습니다. HTTP 404는 공개된 안정 릴리스를 찾지 못했음을 의미하고, HTTP 403 또는
429는 GitHub가 요청을 거부했거나 속도를 제한했음을 의미합니다. 두 경우 모두 대신 브라우저에서
[릴리스 페이지](https://github.com/xbox/cli/releases)를 여세요.


## Related topics

- [계정 업그레이드](https://docs.xbox.com/ko/services/playfab/pricing/account-upgrades.md)
- [엔터티 API 재구성 업그레이드 튜토리얼](https://docs.xbox.com/ko/services/playfab/live-service-management/game-configuration/entities/entity-api-restructure-upgrade-tutorial.md)
- [Visual Studio 2019 GDK 지원 정보](https://docs.xbox.com/ko/tools/tools-console/visualstudio/vs-2019-support-notes.md)
- [Visual Studio 2019 지원 노트](https://docs.xbox.com/ko/tools/tools-pc/visualstudio/gr-vs-2019-support-notes.md)
- [PlayFab 릴리스 노트 2017](https://docs.xbox.com/ko/services/playfab/release-notes/2017.md)
