Ippubblika logħba HTML5 fuq Google Play b'Capacitor, pass pass

Biex tippubblika logħba HTML5 fuq Google Play, tgħaqqad il-fowlder tal-logħba ma' proġett Android nattiv b'Capacitor, tibni Android App Bundle iffirmat f'Android Studio, toħloq l-app f'Play Console, twieġeb għall-formoli tal-kontenut tagħha u tgħabbi l-bundle f'track ta' test qabel il-produzzjoni. Jekk il-kont tal-iżviluppatur tiegħek huwa kont personali maħluq wara t-13 ta' Novembru 2023, Google titlob ukoll test magħluq b'mill-inqas 12-il tester għal 14-il jum qabel ma tkun tista' tapplika għall-produzzjoni.

Għamilna dan bil-logħbiet tagħna stess. F'Ottubru 2026 ippakkjajna Ricopop u Velvet Pool b'Capacitor u bagħatna t-tnejn għar-reviżjoni tal-produzzjoni ta' Google Play, u wkoll il-logħba tal-azzjoni tagħna Little Ninja Dash. Din il-gwida tgħaqqad dak li jgħidu l-paġni uffiċjali ta' Capacitor, Android u Play Console, miqrija fit-30 ta' Ottubru 2026, ma' dak li jirrekordjaw in-noti tar-rilaxx tagħna stess. Ir-regoli u r-rekwiżiti jinbidlu, allura iċċekkja kull paġna msemmija qabel tibgħat.

Qabel ma tippubblika logħba HTML5 fuq Google Play

• Kont ta' zviluppatur ta' Google Play. Google titlob tariffa ta' reġistrazzjoni waħda ta' US$25 u titlob li kull zviluppatur jivverifika l-identità tiegħu. Il-kontijiet personali jridu jivverifikaw ukoll l-aċċess għal apparat Android bl-app mobbli ta' Play Console qabel ma jippubblikaw.
• Node.js u Android Studio. Id-dokumentazzjoni Android ta' Capacitor tgħid li l-apps Android ta' Capacitor jiġu kkonfigurati u mmaniġġjati permezz ta' Android Studio.
• Logħba li taħdem offline mill-fowlder tagħha stess, b'index.html fl-għeruq.
• Liċenzja għall-logħba. B'templates tagħna, liċenzja waħda tkopri prodott finali wieħed, u tista' tippubblika dik il-logħba fejn trid, Google Play u l-App Store inklużi. Ma tistax terġa' tbigħ it-template innifsu. Staqsina qabel ma tiżid prezz jew xiri ġewwa l-app, għax it-termini tagħna jitkellmu dwar plejers li jaċċessaw il-prodott b'xejn jew permezz tar-reklami.

L-edizzjonijiet tat-template tagħna huma logħbiet tal-browser. Kull paġna ta' edizzjoni tgħid li l-build nattivi tal-app mhumiex inklużi, allura l-passi hawn taħt huma xogħol li tagħmel int, jew xogħol li tordna minna b'kwotazzjoni.

Ara Velvet Pool, it-template tal-pool li ppakkjajna wkoll għal Android

Pass 1: għaqqad il-fowlder tal-logħba ma' Capacitor

Capacitor jeħtieġ package.json, fowlder bil-fajls tal-web mibnija u index.html fl-għeruq ta' dak il-fowlder. Il-paġna tal-bidu tiegħu tiwissi li l-index.html irid ikollu tag head, inkella l-plugins ma jaħdmux. Template tal-HTML5 li tniżżel normalment diġà jkollu l-fowlder: tagħna huwa game/.

1. F'fowlder ġdid tal-proġett, mexxi npm i @capacitor/core u npm i -D @capacitor/cli.
2. Mexxi npx cap init. Jitlob l-isem tal-app, l-app ID (dominju bil-maqlub, pereżempju com.yourstudio.yourgame) u l-fowlder tal-web. Immira webDir lejn il-fowlder tal-logħba tiegħek.
3. Mexxi npm i @capacitor/android, imbagħad npx cap add android. Dan joħloq il-proġett android/.
4. Mexxi npx cap sync kull darba li tbiddel il-fajls tal-logħba. Jikkopjahom fil-proġett nattiv.
5. Mexxi npx cap open android biex tiftaħ il-proġett f'Android Studio.

Id-dokumentazzjoni ta' Capacitor tgħid li API 24 u aktar, jiġifieri Android 7 u aktar, huma appoġġjati. Il-proġetti Android tagħna jużaw dak il-minimu.

Dak li nagħmlu b'mod differenti: nżommu l-proġett nattiv f'workspace separat għall-mobile, li jikkopja l-logħba fil-fowlder web tiegħu stess. Il-verżjoni tal-websajt tibqa' bla ħsara, u kull ma jappartjeni biss lill-app, bħar-reklami nattivi, jgħix fil-workspace.

Pass 2: ibni u iffirma l-app bundle

Minn Awwissu 2021 'l hawn, l-apps ġodda f'Google Play iridu jiġu ppubblikati bħala Android App Bundles (AAB), mhux APKs. F'Android Studio, uża Build, imbagħad Generate Signed Bundle/APK, agħżel Android App Bundle u oħloq jew agħżel keystore.

Dak il-keystore iżomm l-upload key tiegħek. Il-paġna ta' Google dwar l-iffirmar tal-app tispjega li b'Play App Signing, li l-apps ġodda jridu jissettjaw fl-ewwel pubblikazzjoni, Google iżomm il-muftieħ tal-iffirmar tal-app u int tiffirma kull upload bl-upload key. Żomm l-upload key sigriet, agħżel passwords b'saħħithom u aħżen il-keystore f'post sikur. Jekk jintilef jew jiġi kkompromess, Play Console jħallik titlob reset tal-upload key.

• Livell target tal-API: mill-31 ta' Awwissu 2026, apps ġodda u aġġornamenti jridu jimmiraw Android 16 (API level 36) jew aktar. Iċċekkja t-target f'android/app/build.gradle.
• Version code: żidu qabel kull upload. Kull bundle li tuploada jonqos mill-version code tiegħu, allura aħna naqraw l-ogħla waħda f'Play Console qabel kull build.
• Release build biss: l-ebda menu tad-debug, l-ebda ID ta' reklami tat-test jew shortcuts tal-iżviluppatur fil-bundle li tibgħat għall-produzzjoni.

X jinkiser ġewwa webview, u x'għamilna dwaru

Logħba li taħdem tajjeb fil-browser tista' timxi b'mod differenti ġewwa app. Dawn huma l-kwistjonijiet li rrekordjaw in-noti tar-rilaxx tagħna, bil-korrezzjoni ddokumentata fejn teżisti waħda.

Il-buttuna ta' lura tal-Android

Il-plugin App ta' Capacitor għandu event backButton. Id-dokumentazzjoni tiegħu tgħid li min jisma' għalih jiddiżattiva l-imġiba default tal-buttuna ta' lura, allura int tiddeċiedi x'jagħmel il-lura, u joffri App.exitApp() biex jagħlaq l-app. F'Velvet Pool għamilna l-lura jiftaħ il-menu tal-pause minflok ma jagħlaq il-logħba.

Pause u resume

L-istess plugin jitfa' l-events appStateChange, pause u resume. Uża dawn biex tipawża l-logħba, it-timers u kwalunkwe reklam li jkun qed jaħdem meta l-plejer joħroġ mill-app, u biex terġa' tkompli b'mod nadif.

Shortcuts tad-debug fuq localhost

Ġewwa l-app, Capacitor iservi l-logħba minn indirizz lokali. Jekk il-logħba tiegħek tixgħel għodod tad-debug meta tiġi mmexxija fuq localhost, dawn jixegħlu wkoll fl-app. Is-scripts tal-build tagħna jitfu dawk il-flags b'mod furzat u jirrifjutaw li jibnu jekk ma jistgħux.

Reklami

Il-kodiċi tar-reklami tal-websajt mhuwiex dak li nużaw fl-apps tagħna. Fuq Android nużaw l-SDK nattiv ta' AdMob permezz ta' plugin ta' Capacitor, b'unitajiet demo ta' Google matul it-test u l-unitajiet tal-app stess biss fil-build tal-produzzjoni.

Layout u salvataġġ

Fuq l-emulatur sibna buttuni maqtugħin f'landscape u kliem twil li jinqasam ħażin, li l-verżjoni tal-browser ma uriet. Ittestja kull skrin fiż-żewġ orjentazzjonijiet, u iċċekkja li l-progress jibqa' meta l-app tingħalaq u terġa' tinfetaħ.

Ara Ricopop, template ieħor li ppakkjajna għal Google Play

Pass 3: Play Console u l-listing tal-ħanut

Oħloq l-app f'Play Console, imbagħad ħdem fit-taqsima tal-kontenut tal-app. Il-formoli li mlejna għal kull logħba kienu: privacy policy, app access, ads, content rating, target audience, Data safety, l-ID tar-reklami u d-dikjarazzjonijiet tal-gvern, tal-finanzi u tas-saħħa.

• Content rating: Google tgħid li l-apps kollha jridu jkollhom klassifikazzjoni IARC, u apps mingħajr waħda jitneħħew. Tikseb waħda billi twieġeb il-kwestjonarju b'mod onest.
• Data safety: kull app trid tlestiha, anke l-apps li ma jiġbru l-ebda dejta. Trid tirrifletti d-dejta miġbura minn SDKs ta' partijiet terzi, bħal SDK tar-reklami, u jeħtieġ link għall-politika tal-privatezza.
• Target audience: wieġeb għall-plejers li timmira fihom tassew. Il-klassifikazzjoni u l-udjenza huma tweġibiet separati.

Assi tal-listing fil-ħanut

• Icon tal-app: 512 fuq 512 pixel, PNG ta' 32-bit, sa 1024 KB.
• Feature graphic: 1024 fuq 500 pixel, JPEG jew PNG ta' 24-bit mingħajr alpha.
• Screenshots: mill-inqas tnejn, sa tmienja għal kull tip ta' apparat. Għal logħbiet, Google tirrakkomanda mill-inqas tlieta ta' captures 16:9 landscape (mill-inqas 1920 fuq 1080) jew 9:16 portrait (mill-inqas 1080 fuq 1920) li juru gameplay reali.
• Deskrizzjoni qasira: sa 80 karattru.

Pass 4: testijiet, imbagħad produzzjoni

Il-runbook tagħna jpoġġi l-ittestjar intern l-ewwel: installa l-app minn Play b'kont reali u ilgħabha qabel kollox. Imbagħad ir-rilaxx jitla' għall-produzzjoni, fejn jgħaddi mir-reviżjoni ta' Google.

Ir-regola għal kontijiet personali ġodda

Il-Play Console Help ta' Google tgħid li l-kontijiet personali tal-iżviluppatur maħluqa wara t-13 ta' Novembru 2023 jridu jmexxu test magħluq b'mill-inqas 12-il tester li kienu opted in b'mod kontinwu għal mill-inqas 14-il jum. Wara dan, tapplika għall-aċċess għall-produzzjoni mid-Dashboard u twieġeb mistoqsijiet dwar it-test magħluq, l-app u l-ħejja għall-produzzjoni. Ippjana dawn iż-żewġ ġimgħat fid-data tal-launch tiegħek.

Żomm l-istati separati meta tirrapporta lill-klijent: uploaded għal track tat-test, submitted għar-reviżjoni, approved u public f'Google Play huma erba' mumenti differenti. In-noti tar-rilaxx tagħna jirrekordjaw dati ta' sottomissjoni, mhux dati ta' approvazzjoni, u din il-gwida tagħmel l-istess.

X fih it-template tagħna, u l-parti li nistgħu nagħmlu għalik

Kull template ġej bil-fowlder tal-logħba lest għall-hosting, is-sors li jinqara, manwal u 6 xhur ta' support, jew 12 bl-estensjoni. Is-support jkopri l-installazzjoni u l-użu tal-fajls mogħtija u t-tiswija ta' difetti li jistgħu jiġu riprodotti. Il-packaging għal Android, ir-reklami nattivi, l-integrazzjoni tal-SDK u l-pubblikazzjoni fil-ħanut huma servizzi separati.

Jekk ma tridx timmaniġġja Android Studio int stess, ibgħatilna t-template, il-pjan tal-kont tal-ħanut u d-deadline. Nwieġbuk bl-ambitu, il-prezz u l-ħin qabel ma nibdew xogħol. Ma nippubblikawx lista ta' prezzijiet għal xogħol personalizzat.

Itlob kwotazzjoni biex tippakkja l-logħba tiegħek għal Google Play

Mistoqsijiet frekwenti

Kemm jiswa li tippubblika logħba HTML5 fuq Google Play?

Google titlob tariffa ta' reġistrazzjoni waħda ta' US$25 għal kont tal-iżviluppatur. Spejjes oħra huma l-liċenzja tal-logħba, l-arti tal-ħanut u l-ħin tiegħek, jew servizz ikkwotat jekk ħaddieħor jagħmel il-packaging.

Irridu 12-il tester biex nippubblika fuq Google Play?

Biss jekk il-kont tiegħek huwa kont personali tal-iżviluppatur maħluq wara t-13 ta' Novembru 2023. Dawk il-kontijiet jridu jmexxu test magħluq b'mill-inqas 12-il tester opted in għal mill-inqas 14-il jum qabel japplikaw għall-aċċess għall-produzzjoni.

APK jew AAB?

AAB. L-apps ġodda f'Google Play ilhom jridu juru l-Android App Bundle minn Awwissu 2021. APK xorta jservi biex tinstalla build direttament fuq it-telefon tat-test tiegħek.

Nista' sempliċiment ikollha l-app tgħabbi l-logħba tiegħi mill-websajt tiegħi?

Ma nagħmlux dan. Nqiegħdu l-fajls tal-logħba ġewwa l-app, allura taħdem offline u ma tiddependix minn sit. Il-politika anti-spam ta' Google tmiss ukoll l-apps li l-iskop prinċipali tagħhom huwa webview ta' websajt mingħajr il-permess tas-sid tas-sit.

It-templates tagħkom lesti għal Google Play mill-ewwel?

Le. Huma logħbiet tal-browser lesti għall-hosting, u l-paġni tal-prodott jgħidu li l-build nattivi tal-app mhumiex inklużi. Tista' tippakkjahom int stess bil-passi hawn fuq, jew tordna x-xogħol minna b'kwotazzjoni.