这个项目能做什么

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。