dart:developer 库

与调试器和检查器等开发者工具进行交互。

这是一个专门用于通过编程方式与 Dart 运行时交互以进行调试和检查的库。示例用法包括高级调试和创建开发者工具。

此库为 Dart Web 和 Dart Native (VM) 提供了平台特定实现。特定平台可能不支持所有操作。

此库提供的功能通常仅适用于以开发模式运行的 Dart 代码，例如 dart run，而不适用于生产模式，例如 dart compile exe 的输出。

调试

可以使用 debugger 函数停止程序，就像触发了断点一样。断点将放置在 debugger 调用之后。此功能可以根据代码中的逻辑触发断点。

示例

var counter = 0;
final someInterestingValue = 1000;
while (true) {
  if (counter == someInterestingValue) {
    // Trigger a breakpoint in the the debugger.
    debugger();
  }
  counter++;
}

使用 dart run --observe 执行并在 DevTools 中打开时，调试器将停止，并将 counter 设置为 1000。

检查

连接到运行时系统的开发者工具，如 Dart DevTools，可能允许在“时间轴”视图中检查执行时间。可以使用 Timeline 的静态方法向此视图添加额外信息和时间事件。

示例

void main() {
  Timeline.timeSync('Calculation loop', () {
    for (var i = 30; i < 50; i++) {
      Timeline.timeSync('fib($i)', () {
        fibonacci(i);
      });
    }
  });
}

int fibonacci(int n) => (n < 2) ? n : fibonacci(n - 2) + fibonacci(n - 1);

使用 dart run --observe 执行并在 DevTools 中打开时，性能选项卡将显示包含传递给 timeSync 的注释的时间轴。

开发者工具

内置在 dart 命令中的调试器等开发者工具可以通过 Service 和 ServiceProtocolInfo 类访问运行时系统公开的应用程序信息。