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

# Criar um pacote de símbolos manualmente

> Saiba como criar e carregar manualmente um pacote de símbolos quando o agrupamento automático de símbolos não estiver disponível.

O MakePkg e o Submission Validator normalmente criam o pacote de símbolos automaticamente quando você empacota ou carrega um título. Use este procedimento apenas como alternativa quando o agrupamento automático de símbolos não estiver disponível ou não produzir o pacote necessário.

## Antes de começar

Antes de criar o pacote, reúna as seguintes informações e arquivos:

* O nome completo do pacote (`PackageFullName`).
* A ID do título (`TitleId`).
* O valor `Name` de `Identity` em *MicrosoftGame.config*.
* O arquivo de layout exato que foi passado para o MakePkg usando `/f`.
* Os arquivos EXE e DLL empacotados.
* O arquivo PDB exatamente correspondente a cada EXE e DLL empacotado.

Se você criou o pacote sem `/f`, use [`makepkg genmap`](https://devdocs.xbox.com/pt-BR/build/core-features/common/packaging/deployment/makepkg#genmap) para criar um arquivo de layout. Recompile o pacote passando esse arquivo para `makepkg pack /f` e, em seguida, use o mesmo arquivo de layout no pacote de símbolos.

> [!IMPORTANT]
>
> Cada PDB deve corresponder exatamente ao binário do build empacotado. Um PDB de um build diferente não pode fornecer símbolos para esse binário.

## Criar o pacote

1. Crie um diretório raiz chamado `<PackageFullName>_<TitleId>`.

2. No diretório raiz, crie um arquivo chamado `game.txt` com o JSON a seguir. Substitua os valores de espaço reservado pelo nome de identidade e pelo nome completo do seu pacote.

   ```json theme={null}
   {
     "Title": "<IdentityName>",
     "Version": "<PackageFullName>"
   }
   ```

3. Copie o arquivo de layout exato que foi passado para o MakePkg para o diretório raiz. Por exemplo, copie `layout.xml`.

4. Recrie o caminho do diretório empacotado de cada EXE e DLL no diretório raiz.

5. No local de cada EXE ou DLL empacotado, crie um diretório com exatamente o mesmo nome do binário, incluindo a extensão `.exe` ou `.dll`.

6. Copie o binário e seu arquivo PDB exatamente correspondente para esse diretório.

7. Verifique a estrutura do pacote. Por exemplo, um pacote com `MyGame.exe` na raiz do pacote e `Resources\MyDll.dll` tem a seguinte estrutura:

   ```text theme={null}
   <PackageFullName>_<TitleId>\
   |-- game.txt
   |-- layout.xml
   |-- MyGame.exe\
   |   |-- MyGame.exe
   |   `-- MyGame.pdb
   `-- Resources\
       `-- MyDll.dll\
           |-- MyDll.dll
           `-- MyDll.pdb
   ```

   ![Exibições do Explorador de Arquivos do Windows do pacote de símbolos, com cada binário ao lado de seu PDB correspondente em uma pasta com o nome do binário.](https://mintcdn.com/microsoft-4404708b/5dcGPrKRKcrgaGe7/images/packaging/symbol-bundle-folder-structure.png?fit=max\&auto=format\&n=5dcGPrKRKcrgaGe7\&q=85\&s=c2ba7549a824cbe4bfbfa16c5a8a3aa8)

8. Crie um arquivo ZIP que contenha `<PackageFullName>_<TitleId>` como diretório de nível superior.

9. No Partner Center, carregue o arquivo ZIP como o pacote de símbolos do título e do pacote correspondentes.


## Related topics

- [Criar um pacote de desbloqueio de pré-venda](https://devdocs.xbox.com/pt-BR/publishing/game-publishing/how-to/how-to-create-preorder-unlock-bundle.md)
- [Criar um pacote de jogo e carregá-lo no Partner Center](https://devdocs.xbox.com/pt-BR/publishing/game-publishing/tutorial-xbox-managed/how-to-create-a-package.md)
- [Pacote de complementos e Season Pass](https://devdocs.xbox.com/pt-BR/publishing/game-publishing/concepts/add-ons/add-on-bundle.md)
- [Pacotes de conteúdo para download (DLC) do GDK](https://devdocs.xbox.com/pt-BR/build/core-features/common/packaging/packaging-downloadable-content-dlc.md)
- [Criar pacote (makepkg.exe)](https://devdocs.xbox.com/pt-BR/build/core-features/common/packaging/deployment/makepkg.md)