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

शुरू करने से पहले

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

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

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

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

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

    1. Eclipse में, फ़ाइल > आयात करें > Android > Workspace में मौजूदा Android Code.
    2. SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib चुनें जहां SDK_ROOT आपके Android SDK की लोकेशन है.
    3. पूरा करें पर क्लिक करें.

  6. अपने Eclipse फ़ाइल फ़ोल्डर में, सिंपल सैंपल प्रोजेक्ट इंपोर्ट करें.

    1. Eclipse में, फ़ाइल > आयात करें > Android > Workspace में मौजूदा Android Code.
    2. SAMPLES_DIR/samples-android/minimalist चुनें.
    3. पूरा करें पर क्लिक करें.

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

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

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

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

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

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

चरण 3: सैंपल चलाएं

सैंपल चलाने के लिए, आपको एक ऐसे Android डिवाइस या एम्युलेटर की ज़रूरत होगी जिसमें Google Play services इंस्टॉल की गई:

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

ज़रूरी नहीं: एक्लिप्स के साथ अपने-आप बिल्डिंग बनाने की सुविधा

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

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

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