### 在 Ubuntu 或 Windows 主机上为 ARM 架构交叉编译 PyInstaller 打包的 Python 程序 #### 1. 环境准备 在开始交叉编译之前，需要确保主机环境已经配置完成。以下是必要的工具和库： - **安装交叉编译工具链**：对于 ARM 架构，通常使用 `arm-linux-gnueabihf` 工具链[^1]。 ```bash sudo apt-get install gcc-arm-linux-gnueabihf ``` - **安装 QEMU 静态二进制文件**：PyInstaller 使用 QEMU 来模拟目标架构的运行环境[^2]。 ```bash sudo apt-get install qemu-user-static ``` - **配置 Docker（可选）**：如果希望在一个隔离的环境中进行交叉编译，可以使用 Docker 容器[^3]。 #### 2. 修改 PyInstaller 的配置 为了生成与 ARM 架构兼容的可执行文件，需要对 PyInstaller 的配置进行调整。以下是一些关键步骤： - **指定目标平台**：通过设置环境变量 `PYINSTALLER_TARGET_ARCH`，告知 PyInstaller 目标架构为 ARM。 ```bash export PYINSTALLER_TARGET_ARCH=arm ``` - **启用 QEMU 模拟**：通过 PyInstaller 的 `--runtime-tmpdir` 参数，指定一个临时目录用于 QEMU 模拟。 ```bash pyinstaller --onefile --runtime-tmpdir=/tmp/qemu your_script.py ``` #### 3. 跨平台构建流程 以下是具体的构建命令和说明： - **在 Ubuntu 上交叉编译**： ```bash # 设置交叉编译工具链路径 export CC=arm-linux-gnueabihf-gcc export CXX=arm-linux-gnueabihf-g++ # 使用 PyInstaller 打包 pyinstaller --onefile --target-arch=arm your_script.py ``` - **在 Windows 上交叉编译**： 在 Windows 上进行交叉编译相对复杂，建议使用 WSL（Windows Subsystem for Linux）[^4]。通过 WSL 安装所需的工具链，并按照上述 Ubuntu 的方法操作。 #### 4. 验证生成的可执行文件 生成的可执行文件位于 `dist` 目录下。可以通过以下方式验证其是否适用于 ARM 架构： - **检查文件架构**： ```bash file dist/your_script ``` 输出应显示为 ARM 架构的 ELF 文件[^5]。 - **传输到目标设备**： 使用 SCP 将文件传输到 STM32MP257 开发板： ```bash scp dist/your_script user@stm32mp257:/path/to/destination ``` - **运行测试**： 在开发板上运行生成的可执行文件： ```bash ./your_script ``` #### 5. 示例代码 以下是一个简单的 Python 脚本示例，展示如何打包并运行： ```python # example_script.py def main(): print("Hello, STM32MP257!") if __name__ == "__main__": main() ``` 打包命令： ```bash pyinstaller --onefile --target-arch=arm example_script.py ``` #### 注意事项 - 如果目标设备运行的是 MicroPython，则需要将脚本适配为 MicroPython 兼容版本[^6]。 - 确保所有依赖库均支持 ARM 架构，否则可能需要手动编译或替换依赖项[^7]。 ---