ArduPilot 开发环境搭建中 wxPython 安装问题解析

问题背景

在搭建 ArduPilot 无人机开源项目的开发环境时，很多开发者会选择在 Ubuntu 系统上运行安装脚本 install-prereqs-ubuntu.sh 来自动配置所需环境。近期有用户报告在 Ubuntu 24.04 LTS 系统上执行该脚本时，遇到了 wxPython 4.2.3 版本编译失败的问题。

问题现象

当用户在 WSL 2 环境中运行安装脚本时，系统尝试构建 wxPython 的 wheel 包时失败。从错误日志中可以看到，虽然编译过程产生了一系列关于 wxBitmap 类方法的弃用警告（deprecation warnings），但最终导致构建失败的具体错误信息并未完整显示。

技术分析

wxPython 是一个用于创建桌面 GUI 应用程序的 Python 扩展模块，它封装了 wxWidgets C++ 库。在 ArduPilot 项目中，wxPython 被用于 Mission Planner 等地面站软件的开发。

编译过程中出现的警告信息主要涉及 wxBitmap 类的几个方法：

• SetWidth()
• SetHeight()
• SetDepth()

这些方法在 wxWidgets 的 GTK 版本中已被标记为弃用（DEPRECATED），但并不会直接导致编译失败。真正的失败原因可能是：

1. 系统缺少必要的编译依赖项
2. 内存不足（特别是在 WSL 环境中）
3. 网络问题导致依赖下载不完整
4. 系统路径或权限问题

解决方案

根据社区反馈和测试结果，这个问题可以通过以下几种方式解决：

1. 耐心等待：wxPython 的编译过程可能非常耗时（在某些系统上需要20分钟以上），特别是在资源受限的环境中。

2. 清理环境后重试：

   • 删除现有的虚拟环境
   • 确保系统有足够的磁盘空间和内存
   • 重新运行安装脚本

3. 手动安装 wxPython： 如果自动安装持续失败，可以尝试手动安装：

   pip install wxPython
   

4. 使用预编译版本： 检查是否有适用于您系统的预编译 wxPython 版本可用。

最佳实践建议

1. 资源准备：在 WSL 环境中运行资源密集型编译任务时，确保为 Linux 子系统分配足够的内存和CPU资源。

2. 日志收集：如果遇到问题，使用 -v 参数运行命令以获取更详细的日志信息，这有助于准确诊断问题。

3. 版本选择：考虑使用经过验证的稳定版本组合，如 Ubuntu 22.04 LTS，这在开发者社区中得到更广泛的测试。

4. 环境隔离：使用 Python 虚拟环境可以避免系统 Python 环境的污染，也便于问题排查和重试。

结论

wxPython 编译问题在 ArduPilot 开发环境搭建过程中并不罕见，通常可以通过等待更长时间、确保系统资源充足或手动安装等方式解决。随着 wxPython 项目的持续更新，这类编译问题有望在未来版本中得到改善。开发者遇到类似问题时，建议首先检查系统资源是否充足，然后考虑收集更详细的错误日志以便进一步分析。