> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Pacotes
> Use a nova experiência de Pacotes no Partner Center para carregar, validar, certificar e publicar builds de jogos para XBOX e PC ou alterne para a interface clássica.
Este artigo fornece um guia para carregar, validar, certificar e publicar builds de jogos usando a experiência **Packages** mais recente no Partner Center. O artigo [Pacotes (experiência clássica)](/pt-BR/publishing/game-publishing/concepts/packages-overview) está disponível durante a transição para a nova experiência. A Microsoft desabilitará a experiência clássica em uma versão futura. Durante a versão prévia, alternar entre as duas experiências não afeta os pacotes ou as configurações existentes.
## Alternar entre a experiência padrão e a experiência clássica
O Partner Center permite alternar entre a experiência padrão e a experiência clássica a qualquer momento.
* A alternância não afeta seus pacotes, status de certificação, publicação ou histórico.
* Ambas as experiências mostram os mesmos pacotes e envios.
* Use a alternância se encontrar um problema ou precisar consultar a interface clássica.
Use a experiência mais recente e compartilhe seus comentários. Sua opinião ajuda a Microsoft a melhorar a experiência.
## Visão geral de Pacotes
**Packages** é um local único para gerenciar os pacotes do seu jogo.
| Ação | Descrição |
| - | - |
| Carregar o build do jogo | Carregue seus pacotes no Partner Center: pacotes XVC para consoles XBOX ou pacotes MSIXVC para PC. |
| Analisar erros de validação | Os erros de validação aparecem automaticamente quando você carrega um pacote. Você resolve os erros antes de enviar seu build para certificação. |
| Enviar para certificação | Envie seu build para certificação. |
| Testar com um público limitado | Use versões de pré-lançamento (flights) para testar seu build com equipes internas ou parceiros antes de um lançamento amplo. |
| Publicar para os jogadores | Publique seu build em uma sandbox de desenvolvedor ou na sandbox RETAIL após a certificação. |
| Reverter um build | Restaure um build certificado anterior na sandbox RETAIL sem precisar carregá-lo novamente nem recertificá-lo. |
### Terminologia e recursos de Pacotes
Use a terminologia a seguir para entender os recursos disponíveis em Pacotes.
* **Galeria de branches (página Packages):** a exibição principal da página **Packages**, que mostra os branches do produto divididos entre **Draft** e **Live**.
* **Branch:** um contêiner para arquivos de pacote e sua configuração associada.
* **Menu do branch:** as opções disponíveis após selecionar **...** em qualquer branch específico. Dependendo do branch (Main ou outros), as opções do menu podem incluir **View and Edit**, **Create Flight**, **Promote to Main** e **Delete**.
* **History:** o registro das ações executadas em branches ou flights específicos.
* **Certify:** a opção para iniciar o envio para a Certificação XBOX.
* **Review and Publish:** a opção para iniciar a publicação em uma sandbox de desenvolvimento ou em RETAIL.
## Branches: trabalhar com vários builds
Os branches permitem trabalhar com várias versões do seu jogo ao mesmo tempo sem que uma interfira na outra. Pense em cada branch como um espaço de trabalho separado para uma finalidade específica.
### Por que usar branches?
* Certificar um build estável em um branch enquanto carrega e testa um build diferente em outro.
* Testar alterações arriscadas sem mexer no build ativo.
* Criar um branch de hotfix para isolar correções urgentes do desenvolvimento em andamento.
* Preparar variantes regionais ou de localização de forma independente.
## Galeria de branches: rascunho e ativo
Ao abrir a página **Packages**, você vê duas exibições: **Draft** e **Live**. Essas exibições representam diferentes estados dos branches.
### Exibição Draft
A exibição **Draft** é sua área de trabalho ativa. **Draft** permite carregar pacotes, verificar o status de certificação e preparar builds para teste ou publicação. A exibição **Draft** mostra duas seções:
* **Branch principal:** mostra o rascunho de trabalho vinculado ao seu lançamento público atual. Somente o branch principal pode ser publicado em RETAIL.
* **Branches adicionais:** mostra todos os outros branches.
### Opções de menu da exibição Draft
Cada branch tem um menu (selecione o ícone **...**) com ações específicas do branch.
| Tipo de branch | Ações disponíveis |
| - | - |
| Branch principal | **View & Edit:** abre o branch para carregar e gerenciar pacotes.
**Create flight:** cria um flight diretamente a partir deste branch. |
| Branches adicionais (sandbox ou flight) | **View & Edit:** abre o branch para carregar e gerenciar pacotes.
**Create flight:** cria um flight diretamente a partir deste branch.
**Promote to main branch:** substitui todo o conteúdo do branch Main pelos pacotes deste branch. Os pacotes anteriores em Main são excluídos permanentemente e não podem ser recuperados.
**Delete:** exclui permanentemente este branch. |
### Exibição Live
A exibição **Live** mostra os pacotes publicados que estão disponíveis para os jogadores. Essa exibição inclui pacotes publicados para disponibilidade geral na Microsoft Store, branches de flight ativos e branches de sandbox em estado publicado.
### Opções de menu da exibição Live
Cada branch tem um menu (selecione o ícone **More options** (**…**)) que inclui ações específicas do branch.
| Tipo de branch | Ações disponíveis |
| - | - |
| Branch principal (RETAIL) | **Rollback:** restaura instantaneamente um build certificado anteriormente sem precisar carregá-lo novamente nem recertificá-lo. A reversão está disponível no branch principal. |
| Branches de flight | **Promote to main branch:** substitui todo o conteúdo do branch Main pelos pacotes deste branch. Os pacotes anteriores em Main são excluídos permanentemente e não podem ser recuperados. |
| Branches de sandbox | **Promote to main branch:** substitui todo o conteúdo do branch Main pelos pacotes deste branch. Os pacotes anteriores em Main são excluídos permanentemente e não podem ser recuperados. |
Você trabalha em **Draft**. Os jogadores veem **Live**. Alternar entre as duas exibições esclarece a diferença entre builds em andamento e conteúdo publicado.
## Como criar um branch
1. Abra a página **Packages**.
2. Na exibição **Draft**, selecione **Add branch**.
3. Insira um **Name** (por exemplo, Testes, Hotfix, Localização ou Experimento) e uma **Description** para o branch.
4. Depois que você criar o branch, ele aparecerá em **Additional branches**.
## Exibir e editar um branch
Ao abrir um branch usando **View & Edit**, você é levado à página **Edit branch**. Use essa página para gerenciar os pacotes do branch.
### Barra de ações superior
Na parte superior da página **Edit branch**, as seguintes ações estão disponíveis.
| Botão | Descrição |
| - | - |
| **History** | Abre um registro de todas as atividades neste branch, incluindo envios para certificação, eventos de publicação e reversões, com detalhes sobre quem executou cada ação e quando. |
| **Certify** | Envia o branch para a certificação XBOX depois que os pacotes estiverem completos e todos os erros de validação tiverem sido resolvidos. |
| **Save as draft** | Salva suas alterações sem enviar o branch para certificação ou publicação. |
| **Review & publish** | Abre a página [Analisar e publicar](/pt-BR/publishing/game-publishing/concepts/modular-submission), na qual você pode analisar o branch e publicar pacotes em sandboxes de desenvolvedor e em **RETAIL**. |
### Detalhes do branch
Você também pode editar os campos **Display name** e **Description** de um branch.
* **Nome de exibição do branch:** o nome mostrado para este branch em todo o Partner Center.
* **Descrição:** uma breve observação que descreve a finalidade do branch, por exemplo, *A ser lançado* ou *Hotfix de abril*.
## Arquivos de pacote obrigatórios: o que carregar
Ao carregar um build de jogo, alguns arquivos são obrigatórios e outros são opcionais. A página **Edit branch** lista claramente cada espaço de arquivo para indicar quais arquivos você pode carregar.
### Formatos de pacote
O formato do pacote do seu jogo depende do dispositivo de destino. O tipo de pacote enviado deve corresponder à disponibilidade de família de dispositivos selecionada.
| Dispositivo | Quem pode baixar | Formato obrigatório | Como criar |
| - | - | - | - |
| Console XBOX | Jogadores em consoles XBOX | XVC | [Introdução ao empacotamento de títulos para consoles XBOX](/pt-BR/build/core-features/common/packaging/overviews/packaging-getting-started-for-console) |
| PC com Windows | Dispositivos com Windows 10 ou Windows 11 | MSIXVC | [Introdução ao empacotamento de jogos para PC](/pt-BR/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC) |
Sempre incremente o número de versão para cada novo pacote. Use o atributo `Version` no elemento `Identity` do arquivo MicrosoftGame.Config. Se quiser, você pode usar o mesmo número de versão em pacotes para plataformas diferentes. A Certificação XBOX pode rejeitar pacotes se você não incrementar o número de versão a cada novo envio.
### Arquivos obrigatórios
| Arquivo | Descrição |
| - | - |
| Build empacotado (.xvc/.msixvc) | Seu arquivo de pacote principal que contém o build do jogo preparado. |
| Pacote de Chaves de Criptografia (EKB) | Obrigatório para pacotes MSIXVC e XVC. Garante a criptografia correta para distribuição aos jogadores. O carregamento do pacote não prossegue até que você carregue este arquivo. |
### Arquivos opcionais, mas recomendados
| Arquivo | Descrição | Quando você precisa dele |
| - | - | - |
| Símbolos (.zip) | Permite relatórios abrangentes de despejos de falhas para depuração. | Recomendado para todos os lançamentos. |
| Arquivo de layout de disco (.xml) | Define a estrutura do disco e a ordem de instalação para lançamentos em disco. | Necessário somente para jogos em disco ou com vários discos. Não se aplica a jogos somente digitais. |
| Log do Submission Validator (.xml) | O Submission Validator é um componente do XBOX Game Development Kit (GDK) que executa uma série de verificações básicas de qualidade em um pacote de jogo. A saída é um arquivo de log XML que contém os resultados da validação do pacote. Para pacotes destinados à certificação ou à publicação em RETAIL, você deve carregar esse arquivo no Partner Center, e o log deve exibir um resultado geral de aprovação ou você deve ter uma exceção aprovada para cada problema marcado como **failure**. Você também deve verificar o arquivo de log em busca de problemas marcados como **warning** e garantir que os avisos sejam esperados. Sempre verifique se você está usando a [versão mais recente do Submission Validator](https://aka.ms/currentsubvalzip) (Observação: este link baixa a pasta zip mais recente). Um erro com instruções de atualização é exibido no log se a versão que você está usando tiver expirado. Os resultados da validação em linha são exibidos se houver avisos ou erros no log. | Obrigatório para pacotes enviados para certificação ou publicação em RETAIL. |
| State Object Database (SODB) | Um arquivo SODB contém uma coleção de objetos de estado de pipeline (PSOs) do D3D12 capturados do seu jogo. Quando enviado com seu pacote ao XBOX Partner Center, a Microsoft compila esses objetos de estado offline em um Precompiled Shader Database (PSDB) otimizado para cada combinação de GPU/driver. Os PSDBs são entregues automaticamente aos jogadores por meio do Windows Update ou da Microsoft Store. Isso reduz ou elimina a compilação de sombreadores em tempo de execução, que pode causar longos tempos de carregamento e travamentos durante o jogo no PC. | Recomendado para todos os pacotes de PC em que você deseja eliminar travamentos de compilação de sombreadores e reduzir os tempos de carregamento. |
O arquivo de layout de disco é diferente do arquivo layout.xml gerado pela ferramenta **makepkg**, que especifica o layout de partes do pacote. Não carregue esse layout.xml como layout de disco.
## Validações de pacote: detectar problemas antes da certificação
O Partner Center valida automaticamente os pacotes quando você os carrega. As validações verificam se o seu pacote está completo e pronto para certificação ou publicação. Resolver problemas nesta etapa reduz o risco de rejeição e falha na certificação.
* Todos os erros de validação de branch e pacote são exibidos diretamente na interface.
* Os arquivos obrigatórios são validados automaticamente. Os arquivos EKB e de log do Submission Validator devem estar presentes.
* Se o log do Submission Validator contiver avisos ou erros, eles serão exibidos claramente em linha para sua análise.
* Se você configurar pacotes específicos de mercado, a configuração de cada variante será validada antes que a publicação seja permitida.
## Pacotes padrão: carregar e gerenciar arquivos
A seção Default packages permite montar pacotes para um branch. Os pacotes padrão estão disponíveis em todos os mercados. Os [pacotes específicos de mercado](#market-specific-packages-and-regional-variants) para países ou regiões individuais são carregados e gerenciados separadamente.
### Opções de carregamento
* **Import:** copia pacotes de outro branch para este sem precisar carregá-los novamente. O botão **Import** aparece na parte superior da seção **Default packages**, ao lado de **Upload package**.
* **Upload package:** carregue arquivos do jogo arrastando e soltando um ou mais arquivos ou usando **Browse files** para seleção individual. O sistema detecta e categoriza automaticamente os arquivos nos espaços corretos.
### Ícones de status do pacote
| Status | O que significa | O que fazer |
| - | - | - |
| Passed | O pacote foi aprovado na certificação. | Nenhuma ação necessária: pronto para publicar. |
| Certify | O pacote não está pronto para certificação: validação incompleta ou arquivos ausentes. | Resolva primeiro todos os erros de validação. |
| Failed | O pacote foi reprovado na certificação. | Corrija os problemas e carregue um novo build. |
| Passed with notes | O pacote foi aprovado, mas tem avisos. | Analise as observações: pode ser necessário agir antes do próximo envio. |
| Ícone Excluir | Remove permanentemente este arquivo de pacote do branch. | Use com cuidado: esta ação não pode ser desfeita. |
## Pacotes específicos de mercado e variantes regionais
A seção **Market-specific packages** mostra todas as variantes regionais configuradas para os mercados selecionados. Esta seção se aplica quando você precisa de builds diferentes para atender a requisitos regulatórios ou específicos de país/região.
### Ações disponíveis
* **Import**: copia pacotes de outro branch para um grupo de mercados específico.
* **Add market-specific package:** cria uma nova variante regional para um grupo de mercados.
* Cada grupo de mercados (por exemplo, Alemanha) tem um menu de três pontos (**...**) com as opções **Edit** e **Delete**.
### Criar um novo grupo específico de mercado
1. Confirme que você está na página **Edit branch** do branch pretendido.
2. Selecione **Add market-specific package**.
3. Insira um **Market group name** (por exemplo, Alemanha) especificando um novo nome ou selecionando um nome existente.
4. Carregue um pacote para cada grupo.
## Opções avançadas: pré-venda e agendamento de atualizações de pacote
Na parte inferior da página **Edit branch**, a seção Advanced options oferece dois recursos: configuração de pré-venda usando pacotes de espaço reservado e agendamento de datas de disponibilidade de Atualizações de Conteúdo (CU).
### Pacote de espaço reservado para pré-venda
Se você configurar uma data de pré-venda nas configurações de Preços e disponibilidade, selecione **Configure placeholder package(s) to enable pre-order** em **Advanced options** e especifique o **Expected maximum file size** do pacote final. Esse valor aparece na Página de Detalhes do Produto (PDP) do seu produto na Microsoft Store. Ele orienta os clientes que fazem a pré-venda a instalar o produto em uma unidade com espaço em disco suficiente para o pacote completo. Esse processo garante que haja armazenamento suficiente disponível quando o produto for lançado.
Pelo menos uma semana antes da data de lançamento do produto, publique um pacote atualizado que substitua o espaço reservado para que os dispositivos dos clientes comecem a instalar o pacote completo antes do lançamento. Ao publicar o pacote atualizado, desmarque a caixa de seleção **Configure placeholder package(s) to enable pre-order**.
Entre em contato com seu representante da Microsoft se você planeja usar um pacote de espaço reservado.
### Agendar atualizações de pacote
As CUs dão suporte a datas de disponibilidade personalizadas para lançamento aos jogadores. Selecione **Configure availability date for my package(s)** para habilitar o agendamento. Depois de habilitado, defina duas datas por pacote.
| Tipo de data | O que controla | Obrigatório? |
| - | - | - |
| Data de disponibilidade | Define quando a CU se torna obrigatória. Se a atualização não estiver instalada, o jogo não poderá ser jogado enquanto estiver conectado à rede XBOX. | Obrigatória para CUs agendadas. |
| Data de pré-download | Define quando a atualização pode ser baixada em segundo plano nos dispositivos em que essa funcionalidade está habilitada. Essa configuração permite que os jogadores usem a atualização imediatamente na data de disponibilidade. | Opcional, mas recomendada. |
Defina sua **data de pré-download** pelo menos 48 horas antes da data de disponibilidade. Esse prazo dá aos jogadores tempo para baixar a atualização em segundo plano e começar a jogar imediatamente no dia do lançamento, sem espera.
### O que acontece com diferentes configurações de data
* **Mesma data de pré-download e de disponibilidade:** sem download antecipado; a atualização é aplicada nessa data.
* **Nenhuma data de pré-download definida:** a atualização é baixada somente na data de disponibilidade.
* **Nenhuma data de disponibilidade definida:** a atualização fica disponível imediatamente após ser publicada na sandbox RETAIL.
* **Pacotes específicos de mercado:** defina a disponibilidade e o pré-download de forma independente por mercado.
## Flights: testar com um público limitado
Use flights para testar um branch com um grupo limitado de usuários antes de publicá-lo amplamente. Esse método de teste é útil para testes internos, versões prévias para parceiros ou grupos de acesso antecipado.
### Como criar um flight
1. Acesse a guia **Flights** na página **Packages**.
2. Selecione **Create new flight**.
3. Insira um **nome** para o flight e selecione o **público** (grupos de dispositivos ou de usuários).
4. Selecione o **Branch** que você deseja testar.
5. (Opcional) Defina as datas de **início** e **término**.
6. Selecione **Save**. O flight aparece imediatamente na sua lista de flights.
Você também pode criar flights diretamente na **Galeria de branches**. Selecione um branch e escolha **Create Flight** no menu (ícone **...**). O branch é pré-selecionado e a experiência é idêntica.
### Editar um flight
Depois de criar um flight, você pode adicionar ou remover grupos de público conforme necessário. A Microsoft Store reflete essas alterações imediatamente. Você também pode editar a classificação do flight após a criação.
## Certificação: obter a aprovação do seu build
A Certificação XBOX verifica se o seu build atende a todos os requisitos da plataforma antes que você possa publicá-lo para os jogadores. Selecione **Certify** em um branch e siga os prompts para enviar seu build para a Certificação XBOX. Para obter mais informações, consulte [Certificar um jogo](/pt-BR/publishing/game-publishing/tutorial-xbox-managed/how-to-certify-a-game).
| Resultado | Descrição | O que fazer em seguida |
| - | - | - |
| Aprovado | O build atende a todos os requisitos. | Prossiga para a publicação. |
| Certificado com observações | O build foi aprovado com observações. Problemas menores sinalizados. | Analise as observações e decida se deseja publicar ou corrigir primeiro. |
| Reprovado | O build não atende aos requisitos. | Corrija os problemas, carregue um novo build e reenvie. |
| Não certificado | O pacote ainda não foi enviado para certificação e permanece como rascunho. | Preencha todos os campos e arquivos obrigatórios, resolva os erros de validação e selecione o botão **Certify**. |
| Em análise | A certificação está em andamento. O pacote está em análise. | Aguarde o resultado. Nenhuma alteração é permitida neste branch durante a análise. |
Antes de enviar qualquer pacote para certificação, preencha o [Questionário de certificação](/pt-BR/publishing/game-publishing/concepts/certification/certification-supplemental-info) do produto selecionando **Certification** na navegação da página do produto.
## Reversão: recuperar-se de um lançamento com problemas
Quando um build lançado causa problemas para os jogadores, você pode restaurar um build certificado anteriormente sem carregá-lo novamente nem recertificá-lo. Em **Packages**, você pode iniciar uma reversão a partir de dois locais.
### Como reverter
Na **exibição Draft (Main Branch)**, siga estas etapas para reverter um pacote.
1. Abra o menu do **Main Branch** (ícone **...**).
2. Selecione **Rollback** nas opções do menu. Essa opção oferece acesso rápido a **Rollback** sem alternar as exibições.
Na **exibição Live (menu Main Branch)**, siga estas etapas para reverter um pacote.
1. Acesse a **exibição Live** na página **Packages**.
2. Localize o **Main Branch** em **In the Microsoft Store**.
3. Abra o menu do branch (ícone **...**) e selecione **Rollback**. Use este ponto de entrada quando quiser ver primeiro o estado publicado atual antes de decidir qual build restaurar.
### O que acontece quando você reverte
Ao selecionar **Rollback**, uma janela modal guiada é aberta e conduz você por quatro etapas antes de fazer qualquer alteração.
**Etapa 1 - Selecionar a publicação anterior:** você vê uma lista de builds certificados e publicados anteriormente. Selecione o build que deseja restaurar. Cada entrada mostra a versão do build, a data de certificação e quem o enviou para ajudar você a identificar o correto.
**Etapa 2 - Exibir detalhes:** os detalhes completos do build selecionado, como nomes de pacotes, versões, famílias de dispositivos e status de certificação, são exibidos. Analise essas informações com cuidado para confirmar que é o build correto antes de prosseguir.
**Etapa 3 - Comparar os pacotes atuais e de destino:** uma comparação lado a lado do build ativo atual e do build que você está prestes a restaurar é exibida. Esta etapa é essencial: ela permite ver exatamente o que muda para os jogadores após a conclusão da reversão. Verifique se nenhum build ou família de dispositivos importante é perdido no processo.
**Etapa 4 - Confirmar e enviar** Antes de a reversão ser executada, você confirma explicitamente que entende o que muda. Depois que você confirmar, a reversão é enviada e o build estável mais antigo entra em vigor imediatamente, sem necessidade de carregar novamente nem recertificar.
Use **History** para encontrar o build exato que deseja restaurar. **History** mostra todas as atividades em todos os branches (carregamentos, envios para certificação, eventos de publicação, flights e reversões), com quem fez o quê e quando.
## Confira também
* [Criar e carregar um pacote de jogo](/pt-BR/publishing/game-publishing/tutorial-xbox-managed/how-to-create-a-package)
* [Visão geral do empacotamento](/pt-BR/build/core-features/common/packaging/overviews/packaging)
## Related topics
- [XR-037 Dependências de pacotes de conteúdo](/pt-BR/publishing/certification/xr/xr-037.md)
- [XR037 Dependências de pacotes de conteúdo](/pt-BR/publishing/certification/fma/xr-037.md)
- [Requisitos XBOX testados na certificação para jogos de console XBOX](/pt-BR/publishing/certification/console-cert-tested-requirements.md)
- [Requisitos do XBOX para jogos do XBOX](/pt-BR/publishing/certification/xbox-requirements.md)
- [Compile e execute seu primeiro título de console com o GDKX](/pt-BR/home/build-first-title/first-console-title-walkthrough.md)