这个项目能做什么
Pygbag 是一款多功能工具,旨在将 Python 和 Pygame 应用直接打包并在现代网页浏览器(包括移动版)中运行。它集打包器、测试服务器和模拟器于一身,让开发者能够借助 WebAssembly(Wasm)将 Python 游戏和交互式应用带到网页上。
主要特性:
- 直接在浏览器中执行:在现代网页浏览器中无缝运行 Python 代码,包括移动版 Safari 和 Chrome。
- 异步感知循环:要求应用的主循环具备异步感知能力(使用 asyncio)。
- 交互式 REPL:提供交互式终端和 REPL 环境,可直接在浏览器中进行测试和调试。
- 命令行界面:提供功能丰富的 CLI,包含构建、打包、自定义应用名称、图标、模板以及处理 SSL 等选项。
- CPython 和 Pygame 支持:专门支持 pygame-ce(pygame 社区版)以及预构建的 CPython 版本(最高至 3.14)。
- 资源优化:包含资源优化器和缓存管理,以减少网络传输并缩短加载时间。
快速开始:
要使用 pygbag,请通过 pip 安装,并针对包含带有异步循环的 main.py 的文件夹运行它:
pip3 install pygbag --user --upgrade
pygbag your.app.folder
然后,在现代浏览器中访问本地测试服务器 URL(默认为 http://localhost:8000)。
兼容性:
- 由于基线 WebAssembly 加载限制,首选基于 V8 的浏览器(Chromium、Brave、Chrome)。
- 对于移动版 Safari,需要 iOS 15.x 或更高版本。应避免在启动时播放声音,建议使用 --ume_block 0。
评论
0 评分人数达到10人后显示
登录后参与讨论。