Android पर C++ के लिए, Play की गेम सेवाओं का इस्तेमाल शुरू करें

Google Sign-In API के बंद होने के बाद, हम 2026 में Games v1 एसडीके को हटा रहे हैं. फ़रवरी 2025 के बाद, Google Play पर ऐसे गेम पब्लिश नहीं किए जा सकेंगे जो Games v1 एसडीके के साथ अभी-अभी इंटिग्रेट किए गए हैं. हमारा सुझाव है कि आप इसके बजाय, Games v2 SDK का इस्तेमाल करें.
गेम के v1 इंटिग्रेशन वाले मौजूदा टाइटल, कुछ सालों तक काम करते रहेंगे. हालांकि, हमारा सुझाव है कि आप जून 2025 से v2 पर माइग्रेट करें.
यह गाइड, Play की गेम सेवाओं के v1 एसडीके का इस्तेमाल करने के लिए है. Play की गेम सेवाओं v2 के लिए C++ SDK टूल अभी उपलब्ध नहीं है.

इस डेवलपर गाइड में बताया गया है कि Google Play की गेम सेवाओं के एपीआई का इस्तेमाल करने वाले C++ गेम को Android पर कैसे कंपाइल और चलाया जा सकता है. शुरू करने से पहले, यहां दी गई ज़रूरी शर्तों को डाउनलोड और कॉन्फ़िगर करें:

इस डेवलपर गाइड में, Android नेटिव डेवलपमेंट किट (NDK) का इस्तेमाल किया गया है. अगर आपको NDK के बारे में नहीं पता है, तो आगे बढ़ने से पहले NDK के दस्तावेज़ और सैंपल देखें.

पहला चरण: अपना एनवायरमेंट सेट अप करना

  1. Android SDK और Android NDK डाउनलोड करें. इसके बाद, इन्हें अपने कंप्यूटर पर एक्सट्रैक्ट करें. अपने एनवायरमेंट में, SDK_ROOT को अपने Android SDK फ़ोल्डर की जगह पर और NDK_ROOT को अपने Android NDK फ़ोल्डर की जगह पर सेट करें.
  2. C++ के सैंपल गेम डाउनलोड करें. इस डेवलपर गाइड में, आपके कंप्यूटर पर मौजूद सैंपल की जगह को SAMPLES_DIR के तौर पर दिखाया गया है.
  3. Google Play की गेम सेवाओं का C++ SDK टूल डाउनलोड करें. एसडीके को अपने डेवलपमेंट मशीन पर एक्सट्रैक्ट करें. अपने एनवायरमेंट में, NDK_MODULE_PATH वैरिएबल को gpg-cpp-sdk डायरेक्ट्री के ऊपर मौजूद डायरेक्ट्री पर सेट करें. आपके पास यह डायरेक्ट्री स्ट्रक्चर होना चाहिए: 
    NDK_MODULE_PATH/
gpg-cpp-sdk/
  4. Eclipse खोलें. अगर आपने पहले से ऐसा नहीं किया है, तो Eclipse को बताएं कि आपने NDK कहां इंस्टॉल किया है. इसके लिए, Preferences > Android > NDK पर क्लिक करें.

  5. Google Play services लाइब्रेरी प्रोजेक्ट को अपने Eclipse वर्कस्पेस में इंपोर्ट करें.

    1. Eclipse में, File > Import > Android > Existing Android Code into Workspace पर क्लिक करें.
    2. SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib चुनें. यहां SDK_ROOT आपके Android SDK की जगह है.
    3. पूरा करें पर क्लिक करें.

  6. कम से कम सुविधाओं वाले सैंपल प्रोजेक्ट को अपने Eclipse वर्कस्पेस में इंपोर्ट करें.

    1. Eclipse में, File > Import > Android > Existing Android Code into Workspace पर क्लिक करें.
    2. SAMPLES_DIR/samples-android/minimalist को चुनें.
    3. पूरा करें पर क्लिक करें.

  7. MinimalistActivity प्रोजेक्ट पर राइट क्लिक करें और Properties पर क्लिक करें. Android में, नीचे की ओर स्क्रोल करके Library सेक्शन पर जाएं. इसके बाद, पक्का करें कि google-play-services_lib प्रोजेक्ट को सही तरीके से रेफ़रंस किया गया हो. अगर ऐसा नहीं होता है, तो रेफ़रंस हटाएं और उसे अपने वर्कस्पेस से फिर से जोड़ें.

Eclipse, आपके प्रोजेक्ट के Java और Android सोर्स को अपने-आप कंपाइल कर देगा. हालांकि, jni फ़ोल्डर में मौजूद नेटिव कोड को अलग से कंपाइल करना होगा. इसे मैन्युअल तरीके से करने के लिए, jni फ़ोल्डर पर जाएं और ndk-build चलाएं. jni फ़ोल्डर में कोई भी बदलाव करने के बाद, ऐसा करना न भूलें.

अब आपका प्रोजेक्ट कंपाइल हो जाएगा. हालांकि, यह अभी काम नहीं करेगा. आपको सबसे पहले Google Play Console में जाकर, अपने गेम को कॉन्फ़िगर करना होगा.

दूसरा चरण: Google Play Console में गेम सेट अप करना

Google Play Console में अपने गेम के लिए एक एंट्री बनाएं. इससे आपके ऐप्लिकेशन के लिए, गेम सेवाओं को चालू किया जाता है. साथ ही, अगर आपके पास पहले से OAuth 2.0 क्लाइंट आईडी नहीं है, तो यह उसे बना देता है.

  1. Google Play की गेम सेवाएं सेट अप करना में दिए गए निर्देशों का पालन करके, अपने गेम के लिए एंट्री बनाएं.
  2. AndroidManifest.xml में, <manifest> टैग के package एट्रिब्यूट की वैल्यू को उस पैकेज के नाम पर सेट करें जिसे आपने Google Play Console सेट अप करते समय चुना था. इस बदलाव के बाद, आपको पूरे प्रोजेक्ट में कुछ रेफ़रंस ठीक करने पड़ सकते हैं. खास तौर पर, जनरेट की गई R क्लास के रेफ़रंस.
  3. res/values/ids.xml खोलें और वहां अपना ऐप्लिकेशन आईडी डालें. ध्यान दें कि ऐप्लिकेशन आईडी और क्लाइंट आईडी एक जैसा नहीं होता. यह Google Play Console के गेम की जानकारी पेज पर, आपके गेम के नाम के बगल में मौजूद नंबर होता है.

तीसरा चरण: सैंपल चलाना

सेंपल चलाने के लिए, आपको Google Play services इंस्टॉल किया हुआ कोई Android डिवाइस या Emulator चाहिए:

  1. नेटिव कोड को कंपाइल करने के लिए, ndk-build चलाएं.
  2. Eclipse में, Run > Run As > Android Application पर क्लिक करें और अपने डिवाइस पर सैंपल चलाएं.
  3. सेंपल खुलने पर, स्क्रीन पर कहीं भी टैप करें. आपको Google Play Games का लोगो दिखेगा. अगर आपने ऐप्लिकेशन को सही तरीके से कॉन्फ़िगर किया है, तो आपको साइन इन करने के लिए कहा जाएगा.

ज़रूरी नहीं: Eclipse की मदद से अपने-आप बनाना

यहां बताया गया है कि ndk-build फ़ोल्डर में मौजूद फ़ाइलों में बदलाव करने पर, ndk-build को अपने-आप चलाने के लिए Eclipse को कैसे कॉन्फ़िगर करें.jni

  1. MinimalistActivity प्रोजेक्ट पर राइट क्लिक करें और Properties पर क्लिक करें. प्रॉपर्टी विंडो में जाकर, बिल्डर पैनल चुनें.
  2. नया बिल्डर जोड़ने के लिए, नया पर क्लिक करें. इसके बाद, प्रोग्राम चुनें और फिर ठीक है पर क्लिक करें.
  3. नाम फ़ील्ड में, 'NDK Builder' डालें.
  4. जगह में जाकर, फ़ाइल सिस्टम ब्राउज़ करें पर क्लिक करें. इसके बाद, NDK_ROOT डायरेक्ट्री पर जाएं और ndk-build कमांड चुनें.
  5. Working Directory में जाकर, Browse Workspace पर क्लिक करें. इसके बाद, MinimalistActivity प्रोजेक्ट फ़ोल्डर चुनें.
  6. रीफ़्रेश करें टैब पर क्लिक करें. पक्का करें कि अपडेट पूरा होने पर संसाधनों को रीफ़्रेश करें बॉक्स पर सही का निशान लगा हो.
  7. चुनिंदा संसाधन रेडियो बटन को चुनें. इसके बाद, संसाधन तय करें पर क्लिक करें. इसके बाद दिखने वाले डायलॉग बॉक्स में, MinimalActivity में जाकर jni फ़ोल्डर चुनें.
  8. बिल्डर बनाने की प्रोसेस पूरी करने के लिए, लागू करें और फिर ठीक है पर क्लिक करें.

अब जब भी jni फ़ोल्डर में मौजूद किसी फ़ाइल में बदलाव किया जाएगा, तब Eclipse ndk-build को चलाएगा और Eclipse Console में आउटपुट प्रिंट करेगा.