该技能面向 Dart 命令行(CLI)应用的开发,提供架构模式、入口点结构、退出码、流路由与子进程派生等实践指导。
用途:帮助开发者按规范组织 Dart CLI 项目,避免破坏性退出、缓冲截断与资源泄漏等问题。
主要能力与要点:
- 进程生命周期:避免直接调用 exit(code),改为设置 exitCode 或从 CommandRunner<int> 返回整数退出码;使用 package:io 的 ExitCode 常量(如 usage.code 64、software.code 70)。
- 入口点模式:bin/*.dart 仅作薄入口,业务逻辑放 lib/src/,便于内存内单元测试。
- 输出路由:结果与机器可读数据写 stdout,警告、错误与日志写 stderr;解析失败时错误与用法均写 stderr 并返回 64。
- 终端检测:输出 ANSI 前检查 stdout.hasTerminal、supportsAnsiEscapes 与 NO_COLOR。
- 项目配置:用 dart create -t console 脚手架,在 pubspec.yaml 的 executables: 声明命令;用 package:build_version 生成版本;缓存放 .dart_tool/<package_name>/。
- 参数解析:使用 package:args 的 ArgParser 或 CommandRunner<int>,用 results.flag/option/multiOption 类型安全访问。
- 异步与堆栈:避免 Chain.capture(),用 Trace.from(st).terse 精简堆栈。
- 子进程:不要依赖 Platform.resolvedExecutable,改用 package:cli_util 的 dartExecutable 或 sdkPath。
- 信号与终端:Windows 上 sigterm.watch() 会抛 UnsupportedError,需加平台判断;恢复 echoMode、lineMode 与光标可见性;关闭监听 socket。
- 测试:单元测试内存内运行,集成测试用 package:test_process 与 test_descriptor 验证退出码与 I/O。
- 编译分发:dart run、dart install、dart build cli、dart compile exe bin/cli.dart -o <output_path>。
限制:资料未提供具体收费、价格、平台支持范围或效果数据;部分细节需参考其 references 与 examples 文件。