このプロジェクトについて

Pygbagは、PythonとPygameアプリケーションをモバイル版を含むモダンなWebブラウザ上で直接パッケージ化して実行するために設計された多用途ツールです。パッケージャー、テストサーバー、シミュレーターとして機能し、開発者がWebAssembly(Wasm)を使用してPythonゲームやインタラクティブアプリケーションをWebに持ち込めるようにします。 主な機能: - ブラウザでの直接実行:モバイルSafariやChromeを含むモダンなWebブラウザでPythonコードをシームレスに実行します。 - 非同期対応ループ:アプリケーションのメインループが非同期対応(asyncioを使用)である必要があります。 - インタラクティブREPL:ブラウザ上で直接テストとデバッグを行うためのインタラクティブターミナルとREPL環境を提供します。 - コマンドラインインターフェース:ビルド、パッケージ化、アプリ名のカスタマイズ、アイコン、テンプレート、SSL処理のオプションを備えた豊富なCLIを提供します。 - 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が推奨されます。