Partilhar via


Attaching the Visual Studio debugger to games running on remote Windows devices

Important

The Xbox PC Toolbox app is in preview. To learn more, contact your Microsoft representative.

The remote Windows game development tools include the ability to attach the Visual Studio 2022 debugger to a game running on a remote Windows device. All debugging traffic between the development PC and remote Windows device is encrypted. The ability to attach the debugger is provided by a Visual Studio 2022 extension, which is available in the public Visual Studio marketplace.

Before debugging, your development PC and remote Windows device must be provisioned and paired using the steps described in the QuickStart guide.

After pairing and provisioning, download the Xbox PC Remote Debugger extension using the Extension Manager in Visual Studio.

picture of marketplace

To attach the debugger to a game running on a remote device, select Attach to Process... from Visual Studio's Debug menu. Select Xbox PC Remote Device from the Connection Type dropdown and enter the IP address or host name of your remote device in the Connection Target text box. The list of processes running on your remote device will be displayed. Select the game you'd like to debug and click the Attach button.

include picture of attach dialog with correct transport selected

Note

You may need to configure your symbol paths so Visual Studio can find the symbols for your game. Do so using the Debugging settings on the Options dialog accessible from the Tools menu.

See also

Remote Windows Game Development Tools