Support debug/flutter adapter, update Zed dependencies

[Dixzz]

🧩 Summary

This PR integrates Dart Debug Adapter Protocol (DAP) support into zed-extensions/dart, allowing interactive debugging sessions directly within Zed via dart debug_adapter

IMPORTANT

Make sure you have: in project path .zed/debug.json

[
  {
    "label": "Debug Flutter App",
    "adapter": "dart", // DO NOT EDIT
    "type": "flutter",
    "program": "lib/main.dart",
    "args": ["--web-port=9090"]
  }
]

Steps shown:

1. Launch Debug Flutter App task in Zed using F4 or command pallet debugger: start
2. Hit breakpoint at main.dart
3. Inspect variable frames
4. Step through code

---

📸 Screenshots

Description	Image
Debug session launched

---

All supported schema for .zed/debug.json config

{
    "adapter": {
      "type": "string",
      "enum": ["dart"]
    },
    "type": {
      "type": "string",
      "enum": ["dart", "flutter"],
      "description": "Debug Flutter or Dart file"
    },
    "label": {
      "type": "string",
      "description": "Human-readable name for this debug configuration",
      "examples": ["Launch Dart App", "Debug Main", "Dart Console"]
    },
    "program": {
      "type": "string",
      "description": "Path to the Dart file to debug",
      "examples": ["lib/main.dart", "bin/main.dart", "test/example_test.dart"]
    },
    "args": {
      "type": "array",
      "description": "Arguments passed to the Dart program.",
      "items": {
        "type": "string"
      },
      "default": []
    },
    "device_id": {
      "type": "string",
      "examples": ["chrome", "edge", "<android-id>", "<ios-id>"]
    },
    "platform": {
      "type": "string",
      "examples": ["web", "desktop"]
    },
    "stopOnEntry": {
      "type": "boolean",
      "description": "Pause debugger on entry.",
      "default": false
    }
  }

[Dixzz]

Tested on:
Zed Preview: v0.192.3-pre
Flutter Version: Flutter 3.29.3

[osiewicz]

FYI, this name shows up both in UI and in debug definitions (via "adapter" field); I'd suggest using Dart here to keep consistent with the name of tech (unless there's a precedent for lowercased name in other tools, e.g. VSC)

[Dixzz]

FYI, this name shows up both in UI and in debug definitions (via "adapter" field); I'd suggest using Dart here to keep consistent with the name of tech (unless there's a precedent for lowercased name in other tools, e.g. VSC)

Updated

[aikins01]

@Dixzz I'd like to take over working on this

[dario-valles]

Any way I can help on this? I really would like to see this live! @Dixzz @aikins01 ?

[Dixzz]

@aikins01 @dario-valles
There aren't any implementation at this moment but we can work on it at our pace

1. fvm custom path for flutter SDK binaries
2. Cross platform support (windows, mac, linux) when debugger is active (currently tested on Linux)

[felipecarvalho]

Any way I can help on this? I really would like to see this live! @Dixzz @aikins01 ?

Me too, we need this feature 🎉

[caturbgs]

Is there any ETA for this PR? 👀👀

[fstof]

I tested now on Zed 0.197.3
Installed this PR extension

I can't say that it works for me.
Hitting F4 shows the debug tasks as specified in debug.json but they do nothing

Plain dart as well as flutter apps do not start up
Here is my .zed/debug.json

[
  {
    "label": "Debug Flutter App",
    "adapter": "dart",
    "type": "flutter",
    "program": "lib/main.dart",
    "args": ["--web-port=9090"]
  },
  {
    "adapter": "dart",
    "type": "dart",
    "label": "Launch Dart App",
    "program": "lib/plain.dart",
    "stopOnEntry": false
  }
]

Am I missing something?

[dcrebbin]

Any updates on this

[peet0r]

Confirmed this PR is functional on Zed 0.198.5 when the following is added to .zed/debug.json in my flutter project:

{
    "label": "Debug Flutter App",
    "adapter": "Dart",
    "type": "flutter",
    "program": "lib/main.dart",
    "args": ["--web-port=9090", "-d", "macos"]
  }

Please note the device was set to macos so update for your device[s].

How much testing to we need to undertake to get this merged?

[peet0r]

I guess I should compile a few readme improvements...I'll push those shortly.

[Dixzz]

I tested now on Zed 0.197.3 Installed this PR extension

I can't say that it works for me. Hitting F4 shows the debug tasks as specified in debug.json but they do nothing

Plain dart as well as flutter apps do not start up Here is my .zed/debug.json

[
  {
    "label": "Debug Flutter App",
    "adapter": "dart",
    "type": "flutter",
    "program": "lib/main.dart",
    "args": ["--web-port=9090"]
  },
  {
    "adapter": "dart",
    "type": "dart",
    "label": "Launch Dart App",
    "program": "lib/plain.dart",
    "stopOnEntry": false
  }
]

Am I missing something?

Please provide:

Logs of flutter doctor
Zed version used
Platform you're running on

[peet0r]

FYI @Dixzz @fstof, the change from dart -> Dart tricked me during setup. When using dart with zed --foreground the logs were silent, which was confusing