pyinstaller ursina

### 使用 PyInstaller 打包 Ursina 游戏或应用

为了使用 PyInstaller 成功打包基于 Ursina 的游戏或应用程序，可以遵循以下方法：

#### 终端命令配置
构建过程中的关键在于正确设置 `pyinstaller` 命令参数来确保所有依赖项被妥善处理。对于一个名为 `FPS.py` 的脚本文件，完整的命令如下所示[^1]：

pyinstaller --add-data "panda3d/;panda3d" --collect-all ursina --collect-all pygame -w -i E:\ZZZ_FILE\FPS_logo.ico FPS.py

这条指令包含了几个重要的选项用于指定额外的数据路径以及收集特定库的所有资源。

- `--add-data`: 此标志允许添加自定义数据目录到最终的应用程序中，在此例子中指定了 Panda3D 库的位置。
- `--collect-all`: 这一标记用来指示 PyInstaller 收集某个模块下的全部文件，这里分别针对 `ursina` 和 `pygame` 模块进行了两次调用。
- `-w`: 表明创建的是窗口化（无控制台）可执行文件。
- `-i`: 设置图标文件路径给生成的 .exe 文件。

#### Python 脚本准备
除了上述命令外，还需要保证主入口 `.py` 文件能够正常运行并导入所需的第三方库。如果项目结构较为复杂，则可能还需调整 `spec` 文件以适应更复杂的场景需求。

#### 注意事项
当遇到某些特殊情况下，比如存在动态加载资源或其他非标准行为时，建议仔细阅读官方文档获取更多高级特性支持说明，并适当修改 spec 文件来进行定制化的打包操作。