> ## 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.

# Atualização

> Verifique se há uma versão estável mais recente da CLI e obtenha instruções para atualizá-la manualmente.

`xbox upgrade` verifica no GitHub se há uma versão estável mais recente e, se houver, informa como
instalá-la. Ele não baixa nem instala nada, e você não precisa entrar.

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

## Opções

| Opção | Descrição |
| - | - |
| `--check` | Verifica se há uma versão mais recente. Esse é o padrão; portanto, `xbox upgrade` e `xbox upgrade --check` fazem a mesma coisa. |
| `--output <format>` | `json` (padrão) ou `json-compact`. `table` não está disponível. |

`--confirm` (`--yes`, `-y`) é recusado, porque nada é instalado.

## Resultado

Uma verificação bem-sucedida grava um objeto JSON em stdout:

| Campo | Descrição |
| - | - |
| `schemaVersion` | `1`. |
| `currentVersion` | A versão em execução, a mesma que `xbox --version` mostra. |
| `latestVersion` | A versão estável mais recente, sem o `v` inicial. |
| `updateAvailable` | `true` quando a versão estável mais recente é mais nova que a versão em execução. |
| `releaseNotesUrl` | A página da versão no GitHub. |
| `message` | Um resumo para pessoas lerem. |
| `instructions` | Como atualizar, quando `updateAvailable` é `true`; caso contrário, uma matriz vazia. |

```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":["..."]}
```

Para instalar a atualização, consulte [Atualizar uma instalação via ZIP](https://docs.xbox.com/pt-BR/tools/xbox-cli/installation.md#update-a-zip-installation)
ou, para o WinGet, [Windows: instalar com o WinGet](https://docs.xbox.com/pt-BR/tools/xbox-cli/installation.md#windows-install-with-winget). Uma
versão pode chegar ao WinGet algumas horas depois de aparecer no GitHub; portanto, `winget upgrade` talvez ainda não
a ofereça.

## Códigos de saída

| Código de saída | Significado |
| - | - |
| `0` | A verificação foi bem-sucedida, haja ou não uma atualização disponível. Leia `updateAvailable`. |
| `1` | A verificação falhou, e stdout fica vazio. |

A verificação não entra no GitHub. Um HTTP 404 significa que ela não encontrou nenhuma versão estável pública, e um
HTTP 403 ou 429 significa que o GitHub recusou a solicitação ou limitou sua taxa. Em qualquer caso, abra a
[página de versões](https://github.com/xbox/cli/releases) no navegador.


## Related topics

- [Tutorial de atualização da reestruturação da API de entidade](https://docs.xbox.com/pt-BR/services/playfab/live-service-management/game-configuration/entities/entity-api-restructure-upgrade-tutorial.md)
- [Instalação por streaming e Intelligent Delivery: uma visão geral](https://docs.xbox.com/pt-BR/build/core-features/common/packaging/overviews/streaming_install-intelligent_delivery.md)
- [Notas de versão do Microsoft Game Development Kit (GDK)](https://docs.xbox.com/pt-BR/announcements/gdk/release-notes.md)
- [Criando, examinando e testando atualizações de conteúdo](https://docs.xbox.com/pt-BR/build/core-features/common/packaging/packaging-testing-updates.md)
- [Opções de teste de pré-lançamento](https://docs.xbox.com/pt-BR/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-prerelease.md)
