edumunoz / miengine

The Visual Studio MI Debug Engine ("MIEngine") provides an open-source Visual Studio Debugger extension that works with MI-enabled debuggers such as gdb, lldb, and clrdbg.

Welcome to the Visual Studio MI Debug Engine ("MIEngine")

	Debug	Release
master

The Visual Studio MI Debug Engine ("MIEngine") provides an open-source Visual Studio extension that enables debugging with debuggers that support the gdb Machine Interface ("MI") specification such as GDB, LLDB, and CLRDBG.

What is MIEngine?

MIEngine is a Visual Studio Debug Engine that understands Machine Interface ("MI"). A Debug Engine is an implementation of the Core Debug Interfaces, enabling the VS UI to drive debugging. Machine Interface is a text-based protocol developed by GDB that allows a debugger to be used as a separate component of a larger system. Additional information:

• Visual Studio Debugger Extensibility
• GDB's Machine Interface

Debug Multiple Platforms

• Support for debugging C/C++ on Android and iOS.
• Debug on any platform that supports GDB, such as Linux and even Raspberry Pi.

Prerequisites

MIEngine requires Visual Studio 2015 with the following features installed:

• Programming Languages -> Visual C++ -> Common Tools for Visual C++
• Cross Platform Mobile Development -> Visual C++ Mobile Development
• Cross Platform Mobile Development -> Microsoft Visual Studio Emulator for Android
• Common Tools -> Visual Studio Extensibility Tools

Get Started

• Clone the sources: git clone https://github.com/Microsoft/MIEngine.git
• Open src/MIDebugEngine.sln in Visual Studio.
• Debug -> Start Debugging (or F5) to to build, deploy, and start debugging the Experimental Instance of Visual Studio.
• See the wiki for more info.

Contribute!

Before you contribute, please read through the contributing and developer guides to get an idea of requirements for pull requests.

• Contributing Guide
• Developer Guide

Want to get more familiar with what's going on in the code?

• Pull requests: Open/Closed
• Issues

You are also encouraged to start a discussion by filing an issue or creating a gist.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

License

MIEngine is licensed under the MIT License.