프로젝트 소개

Pygbag는 Python 및 Pygame 애플리케이션을 모바일 버전을 포함한 최신 웹 브라우저에서 직접 패키징하고 실행할 수 있도록 설계된 다목적 도구입니다. 패키저, 테스트 서버, 시뮬레이터 역할을 하며, 개발자가 WebAssembly(Wasm)를 사용하여 Python 게임과 인터랙티브 애플리케이션을 웹으로 가져올 수 있게 합니다. 주요 기능: - 직접 브라우저 실행: 모바일 Safari 및 Chrome을 포함한 최신 웹 브라우저에서 Python 코드를 원활하게 실행합니다. - 비동기 인식 루프: 애플리케이션의 메인 루프가 비동기 인식(asyncio 사용)이어야 합니다. - 인터랙티브 REPL: 브라우저에서 직접 테스트 및 디버깅을 위한 인터랙티브 터미널 및 REPL 환경을 제공합니다. - 명령줄 인터페이스: 빌드, 패키징, 앱 이름, 아이콘, 템플릿 사용자 지정 및 SSL 처리를 위한 옵션을 제공하는 풍부한 CLI를 제공합니다. - CPython 및 Pygame 지원: pygame-ce(pygame 커뮤니티 에디션) 및 사전 빌드된 CPython 버전(최대 3.14)을 특별히 지원합니다. - 자산 최적화: 네트워크 전송을 줄이고 로딩 시간을 개선하기 위한 자산 최적화 도구와 캐시 관리를 포함합니다. 빠른 시작: pygbag를 사용하려면 pip로 설치하고 async 루프가 있는 main.py가 포함된 폴더에 대해 실행합니다: pip3 install pygbag --user --upgrade pygbag your.app.folder 그런 다음 최신 브라우저에서 로컬 테스트 서버 URL(기본값 http://localhost:8000)로 이동합니다. 호환성: - V8 기반 브라우저(Chromium, Brave, Chrome)는 기준 WebAssembly 로딩 제한으로 인해 선호됩니다. - 모바일 Safari의 경우 iOS 15.x 이상이 필요합니다. 시작 시 사운드 재생은 피해야 하며, --ume_block 0을 권장합니다.