Paddle-Lite 在树莓派5上的编译问题及解决方案

问题背景

在使用Paddle-Lite v2.13版本在树莓派5(Debian 12.5 arm64系统)上进行本地编译时，用户遇到了两个主要问题：

1. 编译过程中出现错误，经排查是由于Python 3.10的setuptools版本(69.5.1)过高导致
2. 编译成功后生成的whl包版本号显示为git记录值(如cd09a8e01)，不符合标准版本号规范，导致pip安装时出现警告

问题分析

编译错误原因

Paddle-Lite的Python绑定在构建时对setuptools版本有特定要求。较新版本的setuptools(如69.5.1)与项目构建系统不完全兼容，这主要是因为：

1. 新版本setuptools引入了一些行为变更
2. 项目中的setup.py.in文件可能使用了某些已被弃用或修改的功能接口

版本号不规范问题

生成的whl包版本号显示为git commit哈希值而非标准版本号，这是因为：

1. 项目构建系统默认使用git describe --always获取版本信息
2. 当不在git仓库中或无法获取标签时，会回退到commit哈希
3. 这种版本号格式不符合Python包的标准版本规范

解决方案

解决编译问题

1. 降级setuptools： 执行以下命令将setuptools降级到兼容版本：

   pip install --upgrade setuptools==58.0.4
   

2. 重新编译： 使用原编译命令重新构建：

   ./lite/tools/build_linux.sh --with_python=ON --with_cv=ON
   

解决版本号问题

1. 设置环境变量： 在编译前设置PADDLELITE_TAG环境变量：

   export PADDLELITE_TAG=v2.13-rc
   

2. 修改构建脚本： 或者直接修改lite/api/python/setup.py.in文件，将版本号格式改为标准形式：

   PADDLELITE_VERSION = 'v0.0.' + PADDLELITE_COMMITE
   

技术建议

1. 长期解决方案：

   • 项目维护者应考虑更新构建系统以兼容新版setuptools
   • 实现更健壮的版本号生成机制，确保符合Python包版本规范

2. 用户注意事项：

   • 在树莓派等ARM设备上编译时，注意检查依赖版本
   • 关注pip的版本兼容性警告，及时调整构建环境

总结

在嵌入式设备如树莓派上编译Paddle-Lite时，环境配置尤为重要。通过合理调整setuptools版本和版本号生成策略，可以成功构建符合标准的Python包。建议用户关注项目更新，以获取更好的兼容性支持。