PolarSSL项目中密码学模块的目录结构调整实践

在PolarSSL项目（现为Mbed TLS）的演进过程中，随着功能模块的不断扩展和代码规模的增大，项目团队决定对密码学相关模块进行目录结构调整。本文将详细介绍这一重要的架构优化过程。

背景与动因

密码学作为PolarSSL项目的核心功能，其代码组织方式直接影响着项目的可维护性和扩展性。随着TF-PSA-Crypto（Trusted Firmware PSA Crypto）项目的推进，为了更好地支持未来Mbed TLS与TF-PSA-Crypto的代码库分离，项目团队决定对密码学模块的目录结构进行调整。

主要变更内容

此次调整的核心是将所有密码学相关的C模块和头文件迁移到专门的tf-psa-crypto目录下，使其与TF-PSA-Crypto主分支的目录结构保持一致。具体包括：

1. 代码迁移：将所有密码学实现代码和头文件重新组织到tf-psa-crypto目录中
2. 构建系统适配：同步更新Make、CMake和Windows构建系统以支持新的目录结构
3. 关键文件处理：特别处理了几个关键文件的位置和包含关系

技术难点与解决方案

在实施过程中，开发团队遇到了几个关键的技术挑战：

1. 核心头文件处理：

   • 原core/common.h文件需要重新定位
   • core/psa_crypto_core_common.h的包含关系需要调整

2. 配置系统适配：

   • 处理drivers/builtin/include/mbedtls/config_adjust_mbedtls_from_tf_psa_crypto.h的路径变更
   • 更新drivers/builtin/mbedtls_config.h的引用方式

3. 构建信息文件：

   • include/psa/build_info.h需要在新结构中保持可用性

针对这些挑战，开发团队采取了以下解决方案：

• 对核心头文件进行了合理的重新定位，确保不破坏现有包含关系
• 重构了配置系统的路径处理逻辑
• 保持了构建信息文件的向后兼容性

实施效果与后续影响

此次目录结构调整带来了多方面的积极影响：

1. 代码组织更清晰：密码学相关代码有了明确的归属目录，便于维护
2. 构建系统更规范：构建脚本与TF-PSA-Crypto主分支保持一致
3. 为未来拆分做准备：为Mbed TLS与TF-PSA-Crypto的代码库分离奠定了良好基础

经验总结

这一架构调整实践为开源项目提供了宝贵的经验：

1. 渐进式重构：通过分阶段实施，确保变更不会影响项目稳定性
2. 兼容性考虑：在结构调整时充分考虑现有代码的兼容性
3. 前瞻性设计：为未来的架构演进预留空间

这种模块化、结构化的代码组织方式，不仅提升了PolarSSL项目的可维护性，也为其他类似项目提供了有价值的参考案例。