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

# シンボル バンドルを手動で作成する

> 自動シンボル バンドルを使用できない場合に、シンボル バンドルを手動で作成してアップロードする方法について説明します。

通常、MakePkg と Submission Validator は、タイトルをパッケージ化またはアップロードするときにシンボル バンドルを自動的に作成します。この手順は、自動シンボル バンドルを使用できない場合、または必要なバンドルが生成されない場合の代替手段としてのみ使用してください。

## 始める前に

バンドルを作成する前に、次の情報とファイルを収集します。

* パッケージの完全名 (`PackageFullName`)。
* タイトル ID (`TitleId`)。
* *MicrosoftGame.config* の `Identity` の `Name` 値。
* `/f` を使用して MakePkg に渡したものとまったく同じレイアウト ファイル。
* パッケージ化された EXE ファイルと DLL ファイル。
* パッケージ化された各 EXE および DLL と完全に一致する PDB ファイル。

`/f` を使用せずにパッケージを作成した場合は、[`makepkg genmap`](/ja-jp/build/core-features/common/packaging/deployment/makepkg#genmap) を使用してレイアウト ファイルを作成します。そのファイルを `makepkg pack /f` に渡してパッケージを再ビルドし、同じレイアウト ファイルをシンボル バンドルで使用します。

> \[!IMPORTANT]
> 各 PDB は、パッケージ化されたビルドのバイナリと完全に一致している必要があります。別のビルドの PDB では、そのバイナリのシンボルを提供できません。

## バンドルを作成する

1. `<PackageFullName>_<TitleId>` という名前のルート ディレクトリを作成します。

2. ルート ディレクトリに、次の JSON を含む `game.txt` という名前のファイルを作成します。プレースホルダーの値を、パッケージの ID 名とパッケージの完全名に置き換えます。

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

3. MakePkg に渡したものとまったく同じレイアウト ファイルをルート ディレクトリにコピーします。たとえば、`layout.xml` をコピーします。

4. ルート ディレクトリの下に、各 EXE および DLL のパッケージ化されたディレクトリ パスを再作成します。

5. パッケージ化された各 EXE または DLL の場所に、`.exe` または `.dll` 拡張子を含め、バイナリとまったく同じ名前のディレクトリを作成します。

6. バイナリと、それに完全に一致する PDB ファイルをそのディレクトリにコピーします。

7. バンドルの構造を確認します。たとえば、パッケージのルートに `MyGame.exe` があり、`Resources\MyDll.dll` があるパッケージの構造は次のようになります。

   ```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="シンボル バンドルを表示した Windows エクスプローラー。各バイナリが、そのバイナリの名前が付いたフォルダー内で、対応する PDB と並んで配置されています。" width="581" height="328" data-path="images/packaging/symbol-bundle-folder-structure.png" />

8. `<PackageFullName>_<TitleId>` を最上位ディレクトリとして含む ZIP アーカイブを作成します。

9. Partner Center で、対応するタイトルとパッケージのシンボル バンドルとして ZIP アーカイブをアップロードします。


## Related topics

- [予約注文アンロックバンドルを作成する](/ja-jp/publishing/game-publishing/how-to/how-to-create-preorder-unlock-bundle.md)
- [Economy v2 バンドル](/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/bundles.md)
- [Microsoft Store マーケットプレイスでの引き換え](/ja-jp/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-redemption/microsoft.md)
- [タッチ バンドル レイアウト入門](/ja-jp/build/core-features/common/game-streaming/building-touch-layouts/samples/game-streaming-touch-getting-started-with-sample-layouts.md)
- [MSIXVC ツールを使用した PC タイトル パッケージングの概要](/ja-jp/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC.md)