用途:面向 Contentstack Dart SDK 仓库的测试工作,适用于在 test/ 目录下新增或修改测试、本地运行测试套件或生成覆盖率、以及处理集成式测试所需的 API 密钥与环境变量。
主要能力与布局:测试文件位于 test/ 目录,例如 stack_test.dart、query_test.dart、entry_test.dart。运行全部测试使用命令 dart test。可选的覆盖率流程与 LCOV 步骤记录在 test/run_test.sh 中,涉及 dart test --coverage=./coverage、coverage:format_coverage 等。
凭据处理:如 test/stack_test.dart 等测试通过 dotenv 加载凭据,包括 apiKey、deliveryToken、environment 以及可选的 host。不要提交密钥,仅在本地 .env 或按团队文档使用 CI secrets,切勿将真实 token 粘贴到仓库或 PR 描述中。
范围与限制:纯逻辑优先使用单元测试;仅在具备 stack 凭据时使用受保护的集成测试。代码生成变更后,需确保测试仍然通过,并在使用 test/run_test.sh 脚本时让覆盖率排除生成文件。参考资料包括 ../dev-workflow/SKILL.md(CI 工作流中的 dart test)、../contentstack-dart-sdk/SKILL.md(被测行为)以及 package:test。具体覆盖率阈值、CI 配置细节与更多测试用例暂未提供。