Valve/Proton
1
0
Fork 0
mirror of https://github.com/ValveSoftware/Proton.git synced 2025-02-05 02:00:44 +03:00
Code Issues Packages Projects Releases Wiki Activity
Proton/docs/DEBUGGING-WINDOWS.md
Arkadiusz Hiler 0d2030e75f docs: Add DEBUGGING-WINDOWS.md.
2025-01-27 10:21:08 +02:00

2.8 KiB
Raw Blame History

Proton Debugging Tips For Windows Developers

This document is intended for people who are used to working with games natively running on Windows and want to use familiar tools.

Table Of Contents

Analyzing Minidumps

Introduction

Starting Proton 9 every released build (includes stable and experimental) the build is uploaded to a symbol store. Any tool that can understand those (e.g. Visual Studio, WinDbg) can be pointed to https://proton-archive.steamos.cloud/.

Visual Studio

  1. After opening a minidump in Visual Studio you need to click on "set symbol paths" or click Tools -> Options -> Debugging -> Symbols. This is global and needs to be done only once.

screenshot of the action described above

  1. Click on the plus button and add https://proton-archive.steamos.cloud/.

screenshot of the action described above

  1. Close the Options Window and proceed to any debugging action as you would normally do. You should see symbols being loaded from the just added location.

screenshot of the action described above

  1. Debugging should now work just like the native one including call stack, variables, etc. Too see the Wine/Proton part of callstack you can select "show external code".

screenshot of the action described above

WinDbg

  1. Click File -> Settings -> Debugging Settings
  2. Enter srv*https://proton-archive.steamos.cloud/ in the "symbol path" field.

  1. Debugging should now work just like the native one including call stack, variables, etc.

Live Debugging

How To

For loading dev builds of games onto a Steam Deck see https://partner.steamgames.com/doc/steamdeck/loadgames

For live debugging see https://partner.steamgames.com/doc/steamdeck/debugging

For best results either add a symbol server to Visual Studio as described above or use a debug build of Proton.

Getting A Debug Build Of Proton

Debug builds contain symbols and should be used for live debugging session.

  1. Locate the version of proton you are using in your Steam Library (e.g. Proton Experimental), click on a cog and select properties.

  1. In the "betas" tab select "debug - unstripped".

  1. Chosen Proton version will now download and update and the symbols will be available.