index.html

---
layout: default
---

<!-- Place this tag in your head or just before your close body tag. -->
<script async defer src="https://buttons.github.io/buttons.js"></script>

<div class="header-container bg-primary jumbotron">
    <div class="container">
        <div class="intro">
            <h1>Debug Adapter Protocol</h1>
        </div>
        <p class="intro-text">
            The Debug Adapter Protocol (DAP) defines the abstract protocol used between a development tool (e.g. IDE or editor) and a debugger.
        </p>

        <br />
        <div class="intro-text">
            <a class="github-button" href="https://github.com/Microsoft/debug-adapter-protocol" data-size="large" data-icon="octicon-star" data-show-count="true" tabindex="0"
                aria-label="Star Microsoft/debug-adapter-protocol on GitHub">Star</a>
        </div>
    </div>
</div>

<div class="container">
    <div class="row align-items-center">
        <div class="col-lg-7" role="navigation" aria-label="Main">
            <h2 class="header-light regular-pad">What is the Debug Adapter Protocol?</h2>

            <p>Adding a debugger for a new language to an IDE or editor is not only a significant effort,
            but it is also frustrating that this effort can not be easily amortized over multiple development tools,
            as each tool uses different APIs for implementing the same feature.</p>

            <p>The idea behind the <i>Debug Adapter Protocol</i> (DAP) is to abstract the way how the debugging support of development tools
            communicates with debuggers or runtimes into a protocol. Since it is unrealistic to assume that existing debuggers or runtimes adopt this protocol any time soon,
            we rather assume that an intermediary component - a so called <i>Debug Adapter</i> - adapts an existing debugger or runtime to the Debug Adapter Protocol.</p>

            <p>The Debug Adapter Protocol makes it possible to implement a generic debugger for a development tool that can communicate with different debuggers via Debug Adapters.
            And Debug Adapters can be re-used across multiple development tools which significantly reduces the effort to support a new debugger in different tools.</p>

            <p>The <i>Debug Adapter Protocol</i> is a win for both debugger providers and tooling vendors!</p>
        </div>
        <div class="col-lg-5">
            <div id="carouselOne" class="carousel slide" data-ride="carousel">
                <div class="carousel-inner">
                    <div class="carousel-item">
                        <div class="row align-items-center">
                            <div class="col-lg-12">
                                <img alt="Inline values with the Python Debug Adapter" src="img/python-inline-values.gif" class="img-fluid rounded"/>
                                <p class="text-left"><i>VS Code showing inline values powered by the Python Debug Adapter</i></p>
                            </div>
                        </div>
                    </div>
                    <div class="carousel-item">
                        <div class="row align-items-center">
                            <div class="col-lg-12">
                                <img alt="Multi-threaded debugging with the Java Debug Adapter" src="img/java-threads.png" class="img-fluid rounded"/>
                                <p class="text-left"><i>VS Code's multi-thread debugging powered by the Java Debug Adapter</i></p>
                            </div>
                        </div>
                    </div>
                    <div class="carousel-item active">
                        <div class="row align-items-center">
                            <div class="col-lg-12">
                                <img alt="REPL console with the Node.js Debug Adapter" src="img/node-repl.gif" class="img-fluid rounded"/>
                                <p class="text-left"><i>REPL console in VS Code powered by the Node.js Debug Adapter</i></p>
                            </div>
                        </div>
                    </div>
                </div>
            </div>
        </div>
    </div>

    <hr>

    <div class="row more-info">
        <div class="col-lg-4">
            <h1 class="text-center"><i class="fa fa-cogs" aria-hidden="true"></i></h1>
            <a href='{{ "/overview" | prepend: site.baseurl }}'><h3 class="text-center">Overview</h3></a>
            <p>
                The protocol defines the format of the messages sent using JSON between the development tool and the debug adapter.
            </p>
        </div>
        <div class="col-lg-4">
            <h1 class="text-center"><i class="fas fa-book" aria-hidden="true"></i></h1>
            <a href='{{ "/specification" | prepend: site.baseurl }}'><h3 class="text-center">Specification</h3></a>
            <p>
                The latest version of the protocol specification is version 1.70.0.
            </p>
            <p>
                <a href='{{ "/changelog" | prepend: site.baseurl }}'>Change History</a>
            </p>
        </div>
        <div class="col-lg-4">
            <h1 class="text-center"><i class="fas fa-code-branch" aria-hidden="true"></i></h1>
            {% assign sorted = site.implementors | sort: 'index' %}
            <a href = "{{ sorted.first.url | prepend: site.baseurl }}"><h3 class="text-center">Implementations</h3></a>
            <p>
                The DAP has been implemented for many debuggers or runtimes and some development tools are hosting these debug adapters.
            </p>
        </div>
    </div>
</div>