MbedTLS测试框架核心脚本迁移方案解析

背景与现状

在MbedTLS项目中，all.sh测试脚本长期以来承担着核心测试执行功能。随着项目发展，这个原本单一的脚本文件已经演进为模块化结构——核心逻辑与组件定义分离。具体来说，原all.sh被拆分为核心部分（仍保留all.sh名称）和多个组件定义文件（components*.sh）。

迁移需求分析

当前存在一个重要需求：将测试框架的核心部分迁移至框架仓库。这一调整主要出于两个目的：

1. 代码复用：使tf-psa-crypto项目能够共享相同的测试框架核心
2. 版本兼容：支持MbedTLS 3.6版本和开发分支同时使用

技术方案设计

架构设计原则

迁移方案遵循以下设计原则：

• 最小侵入性：保持现有CI脚本路径不变
• 灵活性：允许不同仓库/分支保留特定配置
• 模块化：核心功能与项目特定逻辑分离

具体实施方案

1. 现有脚本重构：

   • 将all.sh重构为纯函数定义+精简调用的结构
   • 识别并迁移组件专用函数到对应组件文件

2. 核心迁移：

   • 创建all-core.sh包含核心函数定义
   • 保留tests/scripts/all.sh作为薄包装层

3. 包装层示例：

setup_and_parse_command_line "$@"
load_components "components*.sh"
run_components
report_and_tear_down

实施步骤详解

第一阶段：代码重构

1. 整理当前all.sh中的函数定义，确保它们集中在文件头部
2. 将分散在文件中的执行逻辑（如"Include the components"）整合到适当函数中
3. 定义新的高层函数（如示例中的4个函数）来简化主流程

第二阶段：功能拆分

1. 将仅用于特定组件的函数（如helper_libtestdriver1_*系列）迁移到对应组件文件
2. 验证每个函数的调用范围，确保拆分后不影响功能

第三阶段：核心迁移

1. 将通用函数定义移至all-core.sh
2. 在框架仓库中建立测试核心库
3. 调整各项目的包装脚本引用新核心

技术挑战与解决方案

路径处理问题

挑战：不同项目可能需要不同的组件路径配置 方案：在包装层实现路径解析逻辑，保持核心与路径无关

版本兼容问题

挑战：MbedTLS 3.6和开发分支可能有不同需求 方案：通过包装脚本实现分支特定逻辑，核心保持通用

函数依赖管理

挑战：确保迁移后函数依赖关系完整 方案：建立函数调用关系图，验证拆分合理性

预期收益

1. 代码复用率提升：核心测试框架可跨项目共享
2. 维护成本降低：bug修复和功能增强只需在单一位置进行
3. 扩展性增强：新项目接入测试框架更加便捷
4. 版本管理简化：不同分支可灵活定制测试策略

后续演进方向

1. 进一步细化组件接口规范
2. 建立测试框架版本管理机制
3. 开发自动化迁移验证工具
4. 完善跨项目测试用例共享机制

这种架构调整代表了测试框架向更加模块化、可复用方向发展的必然趋势，将为MbedTLS生态系统的长期健康发展奠定坚实基础。