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 类访问由运行时系统公开的运行应用程序信息。