Capacitor से Google Play पर HTML5 game publish करें, चरण-दर-चरण
Game फ़ोल्डर से signed app bundle तक, Play Console के फ़ॉर्म, नए खातों के लिए 12-tester नियम, और हमारे अपने apps में आई webview की समस्याएँ।
HTML5 game को Google Play पर publish करने के लिए आप game फ़ोल्डर को Capacitor से एक native Android project में लपेटते हैं, Android Studio में signed Android App Bundle बनाते हैं, Play Console में app बनाते हैं, उसके content forms भरते हैं, और production से पहले bundle को test track पर upload करते हैं। अगर आपका developer account 13 नवंबर 2023 के बाद बना personal account है, तो Google production के लिए आवेदन से पहले 14 दिन तक कम से कम 12 testers वाला closed test भी माँगता है।
हमने यह अपने games के साथ किया है। अक्टूबर 2026 में हमने Ricopop और Velvet Pool को Capacitor से पैक करके दोनों को Google Play production review में भेजा, और हमारा action game Little Ninja Dash भी। यह गाइड Capacitor, Android और Play Console के आधिकारिक पेजों की बातें मिलाती है, जो 30 अक्टूबर 2026 को पढ़े गए थे, और हमारे अपने release notes में दर्ज बातें। नियम और शर्तें बदलती रहती हैं, इसलिए submit करने से पहले हर linked पेज जाँच लें।
HTML5 game को Google Play पर publish करने से पहले
- Google Play developer account। Google एक बार की registration fee US$25 लेता है और हर developer से identity verify करवाता है। Personal accounts को publish से पहले Play Console mobile app के साथ एक Android device तक पहुँच भी verify करनी होती है।
- Node.js और Android Studio। Capacitor का Android documentation कहता है कि Capacitor Android apps Android Studio से configure और manage होते हैं।
- एक game जो अपने फ़ोल्डर से offline चलता है, root पर index.html के साथ।
- Game की licence। हमारे templates के साथ एक licence एक end product को कवर करता है, और वह game आप जहाँ चाहें publish कर सकते हैं, Google Play और App Store समेत। Template खुद दोबारा बेचना मना है। Price या in-app purchases जोड़ने से पहले हमसे पूछें, क्योंकि हमारी शर्तें बताती हैं कि खिलाड़ी product मुफ़्त में या advertising के ज़रिए पाते हैं।
हमारे template editions browser games हैं। हर edition के पेज पर लिखा है कि native app builds शामिल नहीं हैं, इसलिए नीचे के चरण वह काम हैं जो आप करते हैं, या जो आप हमसे quote पर करवाते हैं।
Velvet Pool देखें, वह pool template जिसे हमने Android के लिए भी पैक किया है
चरण 1: game फ़ोल्डर को Capacitor से लपेटें
Capacitor को एक package.json, built web files वाला फ़ोल्डर, और उस फ़ोल्डर के root पर index.html चाहिए। उसका getting-started पेज चेतावनी देता है कि index.html में head tag होना चाहिए, वरना plugins काम नहीं करेंगे। डाउनलोड किए HTML5 template में फ़ोल्डर आमतौर पर पहले से होता है: हमारे में वह game/ है।
- एक नए project फ़ोल्डर में npm i @capacitor/core और npm i -D @capacitor/cli चलाएँ।
- npx cap init चलाएँ। वह app का नाम, app ID (reverse domain, जैसे com.yourstudio.yourgame) और web फ़ोल्डर पूछता है। webDir को अपने game फ़ोल्डर पर रखें।
- npm i @capacitor/android चलाएँ, फिर npx cap add android। इससे android/ project बनता है।
- Game फ़ाइलें बदलने पर हर बार npx cap sync चलाएँ। वह उन्हें native project में कॉपी करता है।
- Project को Android Studio में खोलने के लिए npx cap open android चलाएँ।
Capacitor का documentation कहता है कि API 24 और बाद वाले, यानी Android 7 और उससे ऊपर, समर्थित हैं। हमारे Android projects यही न्यूनतम इस्तेमाल करते हैं।
हम अलग क्या करते हैं: native project को एक अलग mobile/ workspace में रखते हैं, जो game को अपने web फ़ोल्डर में कॉपी करता है। Website वाला संस्करण अछूता रहता है, और जो सिर्फ़ app का है, जैसे native ads, वह workspace में रहता है।
चरण 2: app bundle बनाएँ और sign करें
अगस्त 2021 से Google Play पर नए apps APK नहीं, Android App Bundles (AAB) के रूप में publish होने चाहिए। Android Studio में Build, फिर Generate Signed Bundle/APK चुनें, Android App Bundle चुनें, और keystore बनाएँ या चुनें।
वह keystore आपकी upload key रखता है। Google का app-signing पेज बताता है कि Play App Signing के साथ, जिसे नए apps को पहली publication पर सेट करना ज़रूरी है, Google app signing key रखता है और आप हर upload को upload key से sign करते हैं। Upload key गुप्त रखें, मज़बूत passwords चुनें और keystore सुरक्षित जगह रखें। अगर वह खो जाए या उससे छेड़छाड़ हो, तो Play Console में upload key reset का अनुरोध किया जा सकता है।
- Target API level: 31 अगस्त 2026 से नए apps और अपडेट्स को Android 16 (API level 36) या उससे ऊपर target करना होगा। Target को android/app/build.gradle में जाँचें।
- Version code: हर upload से पहले उसे बढ़ाएँ। आपका हर upload किया bundle अपना version code खर्च कर देता है, इसलिए हम हर build से पहले Play Console में सबसे ऊँचा नंबर पढ़ते हैं।
- सिर्फ़ release build: production में भेजे bundle में कोई debug menu, test ad IDs या developer shortcuts नहीं होने चाहिए।
Webview के अंदर क्या टूटता है, और हमने उसका क्या किया
जो game browser में अच्छा चलता है, वह app के अंदर अलग व्यवहार कर सकता है। ये वे समस्याएँ हैं जो हमारे release notes में दर्ज हैं, और जहाँ documented समाधान है, वह भी।
Android back button
Capacitor के App plugin में backButton event है। उसका documentation कहता है कि इसे सुनने से default back button का व्यवहार बंद हो जाता है, तो तय आप करते हैं कि back क्या करेगा, और app बंद करने के लिए App.exitApp() मिलता है। Velvet Pool में हमने back को game बंद करने के बजाय pause menu खोलने वाला बनाया।
Pause और resume
वही plugin appStateChange, pause और resume events देता है। खिलाड़ी app छोड़े तो game, timers और चल रहे किसी भी ad को रोकने के लिए, और वापस आने पर साफ़ तरीके से चालू करने के लिए इन्हें इस्तेमाल करें।
localhost पर debug shortcuts
App के अंदर Capacitor game को एक local address से serve करता है। अगर आपका game localhost पर चलते समय debug tools चालू करता है, तो वे app में भी चालू हो जाएँगे। हमारी build scripts उन flags को बंद करती हैं, और अगर ऐसा न कर सकें तो build करने से मना कर देती हैं।
Ads
हम अपने apps के अंदर website वाला ad code इस्तेमाल नहीं करते। Android पर हम Capacitor plugin के ज़रिए native AdMob SDK इस्तेमाल करते हैं, टेस्टिंग के दौरान Google के demo ad units के साथ, और अपने units सिर्फ़ production build में।
Layout और saving
Emulator पर हमें landscape में बटन कटे हुए और लंबे शब्द बुरी तरह टूटते मिले, जो browser संस्करण में नहीं दिखे थे। हर screen दोनों orientations में टेस्ट करें, और जाँचें कि app बंद करके दोबारा खोलने पर progress बची रहती है।
Ricopop देखें, एक और template जिसे हमने Google Play के लिए पैक किया
चरण 3: Play Console सेटअप और store listing
Play Console में app बनाएँ, फिर app content वाला हिस्सा पूरा करें। हर game के लिए हमने ये फ़ॉर्म भरे: privacy policy, app access, ads, content rating, target audience, Data safety, advertising ID, और सरकारी, वित्तीय व स्वास्थ्य घोषणाएँ।
- Content rating: Google कहता है कि सभी apps के पास IARC rating होनी चाहिए, वरना apps हटा दिए जाएँगे। यह ईमानदारी से questionnaire भरकर मिलती है।
- Data safety: हर app को इसे पूरा करना होता है, उन apps समेत जो कोई डेटा इकट्ठा नहीं करते। इसमें third-party SDKs द्वारा इकट्ठा किया डेटा, जैसे ad SDK, दिखना चाहिए, और privacy policy link भी चाहिए।
- Target audience: उन खिलाड़ियों के लिए जवाब दें जिन्हें आप असल में लक्ष्य करते हैं। Rating और audience अलग-अलग जवाब हैं।
Store listing की फ़ाइलें
- App icon: 512 x 512 pixels, 32-bit PNG, 1024 KB तक।
- Feature graphic: 1024 x 500 pixels, JPEG या alpha के बिना 24-bit PNG।
- Screenshots: कम से कम दो, हर device type के लिए आठ तक। Games के लिए Google कम से कम तीन 16:9 landscape (कम से कम 1920 x 1080) या 9:16 portrait (कम से कम 1080 x 1920) captures की सलाह देता है जो असली gameplay दिखाएँ।
- Short description: 80 अक्षरों तक।
चरण 4: testing, फिर production
हमारा runbook पहले internal testing रखता है: Play से असली account के साथ app इंस्टॉल करके उसे पहले खेलें। फिर release को production में बढ़ाया जाता है, जहाँ वह Google की review से गुज़रता है।
नए personal accounts का नियम
Google का Play Console Help कहता है कि 13 नवंबर 2023 के बाद बने personal developer accounts को closed test चलाना होगा, जिसमें कम से कम 12 testers हों जो कम से कम 14 दिनों तक लगातार opted in रहें। उसके बाद आप Dashboard से production access के लिए आवेदन करते हैं, और closed test, app और उसकी production तैयारी के सवालों के जवाब देते हैं। इन दो हफ़्तों को अपनी launch तारीख में शामिल करें।
Client को रिपोर्ट करते समय स्थितियाँ अलग रखें: test track पर upload, review के लिए submit, approved, और Google Play पर public, ये चार अलग पड़ाव हैं। हमारे release notes submission की तारीखें दर्ज करते हैं, approval की नहीं, और यह गाइड भी वैसा ही करती है।
हमारे templates में क्या है, और हम आपके लिए क्या कर सकते हैं
हर template के साथ तैयार-होस्ट करने लायक game फ़ोल्डर, पढ़ने योग्य source, एक manual और 6 महीने का support आता है, या extension के साथ 12 महीने। Support में दी गई files इंस्टॉल और इस्तेमाल करना, और दोहराए जा सकने वाले defects ठीक करना शामिल है। Android के लिए packaging, native ads, SDK integration और store publication अलग सेवाएँ हैं।
अगर आप Android Studio खुद नहीं चलाना चाहते, तो template, store account plan और deadline भेजें। काम से पहले हम scope, कीमत और समय बताते हैं। Custom काम की कीमत-सूची हम प्रकाशित नहीं करते।
अपना game Google Play के लिए पैक करवाने का quote माँगें
अक्सर पूछे जाने वाले प्रश्न
HTML5 game को Google Play पर publish करने का खर्च कितना है?
Google developer account के लिए एक बार की registration fee US$25 है। बाकी खर्च game की licence, store art और आपका समय है, या अगर कोई और packaging करे तो quote की गई सेवा।
क्या Google Play पर publish करने के लिए 12 testers चाहिए?
सिर्फ़ तब, जब आपका account 13 नवंबर 2023 के बाद बना personal developer account हो। ऐसे accounts को production access के लिए आवेदन से पहले कम से कम 14 दिन तक कम से कम 12 opted-in testers के साथ closed test चलाना होगा।
APK या AAB?
AAB। अगस्त 2021 से Google Play पर नए apps को Android App Bundle इस्तेमाल करना पड़ता है। APK अब भी अपने test फ़ोन पर सीधे build इंस्टॉल करने के लिए काम का है।
क्या app सिर्फ़ मेरी website से game लोड कर सकता है?
हम ऐसा नहीं करते। हम game फ़ाइलें app के अंदर बाँधते हैं, ताकि वह offline चले और किसी site पर निर्भर न रहे। Google की spam policy उन apps को भी निशाना बनाती है जिनका मुख्य उद्देश्य मालिक की अनुमति के बिना किसी website का webview हो।
क्या आपके templates Google Play के लिए सीधे तैयार हैं?
नहीं। ये होस्ट करने लायक browser games हैं, और item पेजों पर लिखा है कि native app builds शामिल नहीं हैं। आप उन्हें ऊपर के चरणों से खुद पैक कर सकते हैं, या काम का quote देकर हमसे करवा सकते हैं।