Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dimixar/remoteunitydebuggerattacher

A real Remote Unity Debugger Attacher
https://github.com/dimixar/remoteunitydebuggerattacher

debugging-tool unity unity-3d unity-debugging unity-development visual-studio-code vscode-extension

Last synced: 4 days ago
JSON representation

A real Remote Unity Debugger Attacher

Awesome Lists containing this project

README

        

# WARNING
I've managed to test the functionality only on macOS and Windows for now. The code for Linux is also present there, but haven't been able to test it properly yet. I would be very glad if you would create issues to those platforms and send pull requests with proposed fixes. This would help me immensely.

# Find and Attach Unity Debugger to a Remotely Running Game.

This extension, unlike Unity VSCode extension is able to attach to a build launched on another device that is connected to your LAN. And just like Unity extension, it's also able to detect builds running on the same device as the code editor.

## Features

It listens to a socket that Unity Editor uses for finding Unity Players for remote debugging/profiling, and then sets up a launch configuration for remote debugging on that player.

## Requirements
- Have Microsoft's Unity extension installed in your editor. (because it's calling internally on the `vstuc` tool that becomes available only upon installing the Unity extension)

## Getting Started

1. Install the extension in VSCode using the vsix package from `releases` section. (Optionally I plan to publish this extension on VSCode marketplace, once I'm sure that it works on other platforms as well.)
2. Open your unity c# project in VSCode.
3. Press `SHIFT+F5` and choose the device/player to attach unity debugger.

## Usage

The command for binding to keyboard shortcuts:
- FindRemoteDebug.findAndAttach (default key shortcut: `SHIFT+F5`)

You can also use the command palette by typing this text:
- Find and Attach Unity Debugger