メインコンテンツまでスキップ

Microsoft シンボルサーバーを使用してデバッグする

Last updated on June 12, 2024

Overview

Microsoft symbol server is a Windows technology used to obtain symbol debugging information. It will help you find the appropriate symbol (PDB) from the minidump you want to debug.

AccelByte Development Toolkit (ADT) has a symbol server, which enables you to download minidump from the website and use Visual Studio to debug it without having the PDB file.

備考

We recommend using Visual Studio as your IDE, but you can use any IDE you prefer.

Prerequisites

  • An Admin or Developer account in ADT Web.
  • An ADT IAM account.
  • ADT Symbol client proxy
  • GNU Make

Set up client Proxy

  1. Download the ADT Symbol client proxy from the download page in ADT Web.

  2. Open the downloaded folder and run the terminal.

  3. Run this command in the CLI.

    .\client-symbol-proxy-v0.2.1-win64.exe login
  4. A browser window will open and redirect you to the ADT Login page. Type in your namespace and select Continue.

    ADT namespace login page

  5. Log in using your ADT credential or SSO.

    ADT credentials login page

  6. The CLI will confirm if you have successfully logged in.

        PS D:\SymbolServer> .\client-symbol-proxy-v0.2.1-win64.exe login
    time="2023-10-23T13:52:31+07:00" level=info msg="Client is running at http://localhost:9094"
    time="2023-10-23T13:53:18+07:00" level=info msg="Login success"
  7. Run this command in the CLI.

    .\client-symbol-proxy-v0.2.1-win64.exe serve

    The response should be as follows:

    time="2023-10-23T13:57:38+07:00" level=info msg="serve port :8080"

    This means that the client proxy is ready.

Debug in Visual Studio

Follow these steps:

  1. Download the minidump from the ADT Crash details page.

    Image shows the Download button

  2. Open the DMP file with Visual Studio.

    Image shows opening the dump file in Visual Studio

  3. The debugging window appears. Click on the Set Symbol Paths button.

    Image shows clicking on set symbol paths

  4. The Options window appears. Click the plus (+) button.

    Image shows the plus button

  5. A new entry for the symbol server will be created. In the textbox, type in the local host.

    http://localhost:8080/<NAMESPACE>/<GAME_ID>

    Tick the checkbox, then click the OK button.

    Image shows the local host path

  6. Click Debug With Native Only to start debugging.

    Alt text