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

# Créer manuellement un ensemble de symboles

> Découvrez comment créer et téléverser manuellement un ensemble de symboles lorsque la création automatique de l'ensemble de symboles n'est pas offerte.

MakePkg et le validateur de soumission (Submission Validator) créent normalement l'ensemble de symboles automatiquement lorsque vous empaquetez ou téléversez un titre. Utilisez cette procédure uniquement comme solution de rechange lorsque la création automatique de l'ensemble de symboles n'est pas offerte ou ne produit pas l'ensemble requis.

## Avant de commencer

Avant de créer l'ensemble, rassemblez les informations et les fichiers suivants :

* Le nom complet du package (`PackageFullName`).
* L'ID du titre (`TitleId`).
* La valeur `Name` de l'élément `Identity` dans *MicrosoftGame.config*.
* Le fichier de disposition exact qui a été passé à MakePkg au moyen de `/f`.
* Les fichiers EXE et DLL empaquetés.
* Le fichier PDB correspondant exactement à chaque fichier EXE et DLL empaqueté.

Si vous avez créé le package sans `/f`, utilisez [`makepkg genmap`](/fr-CA/build/core-features/common/packaging/deployment/makepkg#genmap) pour créer un fichier de disposition. Régénérez le package en passant ce fichier à `makepkg pack /f`, puis utilisez ce même fichier de disposition dans l'ensemble de symboles.

> \[!IMPORTANT]
> Chaque fichier PDB doit correspondre exactement au fichier binaire du build empaqueté. Un fichier PDB provenant d'un autre build ne peut pas fournir les symboles de ce fichier binaire.

## Créer l'ensemble

1. Créez un répertoire racine nommé `<PackageFullName>_<TitleId>`.

2. Dans le répertoire racine, créez un fichier nommé `game.txt` contenant le JSON suivant. Remplacez les valeurs d'espace réservé par le nom d'identité et le nom complet de votre package.

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

3. Copiez dans le répertoire racine le fichier de disposition exact qui a été passé à MakePkg. Par exemple, copiez `layout.xml`.

4. Recréez sous le répertoire racine le chemin de répertoire empaqueté de chaque fichier EXE et DLL.

5. À l'emplacement de chaque fichier EXE ou DLL empaqueté, créez un répertoire portant exactement le nom du fichier binaire, y compris son extension `.exe` ou `.dll`.

6. Copiez dans ce répertoire le fichier binaire et le fichier PDB qui lui correspond exactement.

7. Vérifiez la structure de l'ensemble. Par exemple, un package contenant `MyGame.exe` à la racine du package et `Resources\MyDll.dll` présente la structure suivante :

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

   <img src="https://mintcdn.com/microsoft-4404708b/5dcGPrKRKcrgaGe7/images/packaging/symbol-bundle-folder-structure.png?fit=max&auto=format&n=5dcGPrKRKcrgaGe7&q=85&s=c2ba7549a824cbe4bfbfa16c5a8a3aa8" alt="Vues de l'Explorateur de fichiers Windows montrant l'ensemble de symboles, où chaque fichier binaire se trouve à côté du fichier PDB correspondant dans un dossier portant le nom du fichier binaire." width="581" height="328" data-path="images/packaging/symbol-bundle-folder-structure.png" />

8. Créez une archive ZIP dont le répertoire de premier niveau est `<PackageFullName>_<TitleId>`.

9. Dans Partner Center, téléversez l'archive ZIP comme ensemble de symboles pour le titre et le package correspondants.


## Related topics

- [Créer un ensemble de déverrouillage de précommande](/fr-CA/publishing/game-publishing/how-to/how-to-create-preorder-unlock-bundle.md)
- [Créer un package (makepkg.exe)](/fr-CA/build/core-features/common/packaging/deployment/makepkg.md)
- [Vue d'ensemble de MicrosoftGame.config](/fr-CA/build/core-features/common/game-config/MicrosoftGameConfig-Overview.md)
- [Vue d'ensemble des classements basés sur les événements](/fr-CA/services/xbox-services/player-data/stats-leaderboards/event-based/live-leaderboards-eb-overview.md)
- [Système de bannissement d'adresses IP](/fr-CA/services/playfab/player-progression/player-data/ip-bans.md)
