내 게임을 Google Play에
여기에 게시한 게임은 이미 휴대폰에 설치할 수 있어요(게임 페이지의 설치 버튼). Play 스토어에도 올리려면 JumPHP가 게임을 진짜 Android 앱인 Trusted Web Activity로 만들어 줘요. Chrome에서 게임 페이지를 주소 표시줄 없이 전체 화면으로 열고, 게임의 아이콘과 이름이 붙어요. 게임은 사이트의 것 그대로예요(여기에 게시한 업데이트가 바로 앱에 반영돼요). 네트워크나 브라우저 없이 동작하는 앱이 필요하다면 네이티브 Android 앱을 참고하세요.
필요한 것: 내 컴퓨터의 JumPHP 프로젝트(내 컴퓨터에서), Docker, Google Play 개발자 계정(한 번만 25달러). Claude가 전부 대신 해 줄 수 있어요. "내 게임을 Google Play에 올려 줘"라고 부탁하세요.
1. 앱 만들기
bin/jumphp twa mon-jeu --url https://jumphp.net/mon-jeu
처음 실행하면 명령이 다음을 물어봐요.
- 앱의 패키지 이름(예:
io.github.moi.mon_jeu): Play 스토어에서의 식별자이고 이후에는 절대 바뀌지 않아요. - Google Android SDK 라이선스에 동의할지(SDK는
~/.jumphp에 한 번 내려받아요. 약 1 GB).
그러면 업로드 키(~/.jumphp/android/keys/, 비밀번호 포함: 백업해 두고 git에는 절대 넣지 마세요)를 만든 뒤 games/mon-jeu/dist/android/에 다음을 만들어요.
| 파일 | 용도 |
|---|---|
mon-jeu-1.aab |
Play 스토어 |
mon-jeu-1.apk |
내 휴대폰에서 시험하기(adb install, 또는 휴대폰에 복사) |
assetlinks.json |
사이트와 앱이 한 쌍임을 증명(2단계) |
키의 SHA-256 지문도 표시돼요. 아이콘 아래에 표시되는 이름은 게임의 짧은 이름이에요(game.yaml의 pwa: {short_name: …}, 없으면 제목).
2. 이 앱이 내 것이라고 사이트에 알리기
이 과정이 없으면 앱이 주소 표시줄과 함께 열려요. 스튜디오의 내 게임 페이지에서 Android 앱 부분에 패키지 이름과 지문을 입력하세요. 사이트가 이를 https://jumphp.net/.well-known/assetlinks.json에 게시하고, Android가 이를 검증해요.
Claude는 update_project(android_package, android_fingerprints)로 이 작업을 해요. 내 서버를 쓴다면 assetlinks.json을 https://내-도메인/.well-known/assetlinks.json 주소에 두세요.
3. Google Play에 게시하기
자세한 내용(키, 휴대폰에서 시험하기, Play Console의 각 항목 입력, 심사, 이후 버전, 함정)은 **Play 스토어에 게시하기, 단계별 안내**에 있어요. 요약하면 다음과 같아요.
- Play Console에서 같은 패키지 이름으로 앱 만들기를 하세요.
- 먼저 내부 테스트를 하세요.
.aab를 업로드하고 테스트 링크로 설치해 보세요. - 앱 서명(설정)에서 Google이 자체 키로 앱에 서명해요. 그 SHA-256 지문을 복사해 내 지문 옆에 추가하세요(2단계). 그렇지 않으면 주소 표시줄이 다시 나타나요.
- 스토어 등록정보(스크린샷은
bin/jumphp shot), 콘텐츠 등급, 그다음 프로덕션이에요.
이후 버전
게임 코드는 저절로 업데이트돼요(사이트가 곧 게임이니까요). 앱 자체(이름, 아이콘, 색)를 바꾸려면 다음을 실행하세요.
bin/jumphp twa mon-jeu # 버전 번호가 1 올라가요
games/mon-jeu/android/twa-manifest.json에 패키지, 주소, 버전이 보관돼요. 이 파일은 git에 넣어요.