flutter_ci_tools 0.2.0

flutter_ci_tools: ^0.2.0 copied to clipboard

⚠️ Breaking Changes #

• FeishuNotifyAction / FeishuBuildNotifyAction 的 shellRunner 参数换成 httpPoster（类型 HttpPoster）。只影响为测试注入假对象的调用方，正常构造 不受影响
• 删除 DeployTarget 枚举，FeishuBuildNotifyAction.target 改收 String。 它唯一的用途是往通知标题里填一个括号里的名字（🚀 App 新版本 12042 (Pgyer)），没有任何代码 switch 它，枚举只是逼调用方多 import 一个类型、 且发到枚举里没有的渠道时还得先改库。迁移：DeployTarget.pgyer → 'Pgyer'，DeployTarget.googlePlay → 'Google Play'， DeployTarget.appStore → 'App Store'

♻️ Refactoring #

• FeishuBuildNotifyAction 改为继承 FeishuNotifyAction，只覆写新增的 buildMessage() 生成正文。此前它在 run() 里 new 一个平级 Action 再调用， 两个 PipelineAction 嵌套执行，参数也要一个个手工透传。子类只做“消息怎么写”， 发送、重试、错误处理都留在父类
• 飞书通知改用 dart:io 的 HttpClient 发送，不再 fork curl 进程。新增 HttpPoster / HttpPosterImpl（postJson）。收益是拿得到真实状态码——此前 HTTP 400 只能打出 curl exited with 22，现在是 HTTP 400: <响应体>；代价是 HttpClient 默认不读代理环境变量，HttpPosterImpl 里已显式补上 findProxyFromEnvironment。pgyer 的 multipart 文件上传仍走 curl

📚 Documentation #

• 修正 example/README.md：流水线示例还停留在重构前的 API（BuildPipeline 基类、context.platforms / AppPlatform 分平台判断、Action 有返回值、 “没有字符串键的 context store”），另有 exampleConfig、writeBuildInfo、 CollectMetadataAction、build_info_writer.dart、test_pipeline.dart 等一批已不存在的符号。现按真实的 ci/pipelines/prod_pipeline.dart 重写

✅ Tests #

• 单元测试 134 → 99。砍掉的是「测语言本身」的用例（断言 enum 有几个值、 status = X 后再断言 status == X、expect(action, isA<自己>())）和同一 分支重复测多遍的（get() 缺 key 抛 StateError 测了 3 遍），断言覆盖没有 减少

🐛 Bug Fixes #

• FeishuBuildNotifyAction 补上 maxAttempts / retryDelay 并透传给 FeishuNotifyAction。此前这两个参数只存在于 FeishuNotifyAction 上，而所有 流水线用的都是 FeishuBuildNotifyAction，等于够不着，只能吃默认值

♻️ Refactoring #

• FeishuNotifyAction 去掉 curl 自带的 --retry：它会与外层重试相乘（3×3=9 次 请求、最坏约 2.5 分钟），且内部重试静默、日志上看不出试了几次。改为只保留 外层重试，请求数降到 3 次、最坏约 51 秒，每次失败都有明确日志

✨ Features #

• FeishuNotifyAction 大幅加固：新增 maxAttempts / retryDelay 参数，curl 补上 -sS -f --connect-timeout 5 --max-time 15 --retry 2 --retry-connrefused， 并解析响应体识别飞书的「HTTP 200 + 非零 code」业务错误；webhook 为空时跳过。 明确保证永不抛异常，通知失败不影响已产出的构建产物

🐛 Bug Fixes #

• pipeline_context_test 不再写死版本号，改为校验 semver 形态（0.0.4 → 0.1.0 时曾误报失败）

✨ Features #

• PgyerUploadV2Action 新增 maxRetries 参数 (900d7c3)
• GooglePlayUploadAction / AppStoreUploadAction 新增 maxRetries 参数 (00bc0a1)

📚 Documentation #

• README 新增 SVG hero、执行摘要与终端截图，嵌入 3 张截图并补充 status badges (#5, #6, #7, #8)
• 用户文档移至 doc/，开发计划移至 dev-docs/ (84a2a6d)

🔧 Chores #

• pubspec 补充 homepage / issue_tracker 字段，版本对齐为 0.1.0 (5c0cac1)

♻️ Refactoring #

• ShellRunner 新增 setLogger 方法，支持延迟 Logger 注入；各 action 在 run() 开头调用 _shellRunner.setLogger(context.logger)，ShellRunnerImpl 不再要求构造时传入 Logger (ba11c51)

✨ Features #

• GooglePlayUploadAction 新增可选 File? artifact 参数，支持并行上传时显式指定 AAB 文件 (57ab3ed)
• AppStoreUploadAction 新增可选 File? artifact 参数，支持并行上传时显式指定 IPA 文件 (57ab3ed)

⚠️ Breaking Changes #

• PipelineAction.run() 不再有泛型返回值 R，统一返回 Future<void>；action 间结果改走 PipelineContext KV bag (3bb3c82)
• Logger 从静态类改为实例类，支持 verbose / noColor / indent，需注入使用 (d5acc13)
• buildNumber / buildArtifact 迁移到 PipelineContext KV bag (413f212, 9abbc02)
• Pgyer 的 description 重命名为 buildUpdateDescription，对齐 API 参数名 (e73df8a)

✨ Features #

• PipelineContext 新增 KV bag（put / get / tryGet）与 ContextKeys (66fd5d9)
• 接入 --verbose 与 --no-color CLI 参数 (754c3c7)
• PipelineAction 新增 description getter，默认取 CamelCase 类名 (6f71068)

♻️ Refactoring #

• Pgyer 通过 resultKey 把下载 URL 写入 bag，FeishuBuildNotify 读取 downloadUrlKeys (c5d43e0)
• PipelineContext.logger 贯穿各 action，Pipeline 增加 section / closeSection (c8d67a3)
• 向 ShellRunnerImpl / GitManagerImpl / VersionManagerImpl 注入 Logger (f7a0905, 6111dd8)
• 移除 runStep，日志内联到 Pipeline._runTracked (f12b2c3)
• 移除 Logger 输出缩进 (4a5204f)

🐛 Bug Fixes #

• 为 GitManagerImpl 单例和延迟的 VersionManager action 注入 Logger (4d6d5d0)

📚 Documentation #

• KV bag 结果通道、多 key 下载 URL、日志改进的 spec 与实现计划 (8825efa, 6d0b109, cf4fa8f, b527077, e1fd33a)

🔧 Chores #

• opt claude (4d68973)
• add Claude Code Review workflow agent (d56f1c4)
• add Claude PR Assistant workflow agent (55c0deb)

📚 Documentation #

• add commit SHAs to CHANGELOG versions (41c3a2c)

Bug Fixes #

• remove hardcoded secrets, redact logs, use HTTPS, harden shell execution
  • Replace hardcoded Pgyer API key and Feishu webhook URL with env var reads
  • Redact sensitive args (_api_key, password, secret, token) in shell command logs
  • Move Pgyer API key from URL query param to POST form body
  • Mask App Store API key ID in log output
  • Use HTTPS instead of HTTP for Pgyer V2 API calls
  • Disable runInShell to prevent shell metacharacter injection
  • Use Directory.systemTemp.createTempSync() for secure temp file creation

Breaking Changes #

• PipelineContext.buildNumber is no longer a late int field. Use resolveBuildVersion() to set it; accessing before resolution throws StateError with a descriptive message.
• BuildAndroidAction and BuildIOSAction now return void instead of File. The build artifact is stored in context.buildArtifact.
• PgyerUploadAction, PgyerUploadV2Action, GooglePlayUploadAction, and AppStoreUploadAction no longer accept an artifact constructor parameter. They read from context.buildArtifact instead.
• DefaultShellRunner renamed to ShellRunnerImpl.
• DefaultGitManager renamed to GitManagerImpl.
• DefaultVersionManager renamed to VersionManagerImpl.

Added #

• PipelineContext.buildArtifact / setBuildArtifact() for passing build artifacts between actions.
• BuildVersion sealed type for type-safe build number state tracking.
• Dartdoc comments on all public API surfaces.

• Initial release: Logger, ShellRunner, GitManager, VersionManager, BuildMetadata, DeployService, EnvBuilder (abstract), CIToolsConfig.