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

चेतावनी: यह गाइड, Play की गेम सेवाओं के वर्शन 1 का इस्तेमाल करने के लिए है. Play के गेम सेवाओं के 2.0 वर्शन के लिए, सी SDK टूल और ज़्यादा जानकारी देने वाले दिशा-निर्देश जल्द ही उपलब्ध होंगे. इस बीच, आपको साइन इन करने के लिए गाइड में v2 के बारे में ज़्यादा जानकारी मिल सकती है. अगर आपको SDK टूल के नए वर्शन की जांच करनी है, तो ज़्यादा जानकारी के लिए Google प्रतिनिधि से संपर्क करें.

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

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

• Android NDK, वर्शन 14 या इसके बाद का वर्शन.
• Android SDK v10 या उसके बाद के वर्शन और Eclipse ADT का सबसे नया वर्शन.
• डिवाइस पर Android 4.0 (एपीआई लेवल 14) या उसके बाद का वर्शन होना चाहिए.
• Google Play services SDK टूल का सबसे नया वर्शन.

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

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

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

   NDK_MODULE_PATH/
   gpg-cpp-sdk/

4. Eclipse खोलें. अगर आपने पहले से ऐसा नहीं किया है, तो Preferences > Android > NDK पर क्लिक करके Eclipse को बताएं कि आपने NDK कहां इंस्टॉल किया है.

5. Eclipse फ़ाइल फ़ोल्डर में, Google Play सेवाओं की लाइब्रेरी का प्रोजेक्ट इंपोर्ट करें.

   1. Eclipse में, फ़ाइल > इंपोर्ट करें > Android > Workspace में मौजूदा Android कोड पर क्लिक करें.
   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 कोड पर क्लिक करें.
   2. SAMPLES_DIR/samples-android/minimalist चुनें.
   3. पूरा करें पर क्लिक करें.

7. MinimalistActivity प्रोजेक्ट पर दायां क्लिक करें और प्रॉपर्टी पर क्लिक करें. Android सेक्शन में, नीचे की ओर स्क्रोल करके लाइब्रेरी सेक्शन पर जाएं और पक्का करें कि 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 के गेम की जानकारी वाले पेज पर, आपके गेम के नाम के आगे दिया गया नंबर होता है.

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

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

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

अहम जानकारी: पक्का करें कि आपने APK को उसी सर्टिफ़िकेट से साइन किया हो जिसका सर्टिफ़िकेट आपने Google Play Console पर कॉन्फ़िगर किया है. ऐसा न करने पर गड़बड़ियां मिलेंगी.

अहम जानकारी: अगर आपको किसी अनपब्लिश किए गए गेम की जांच करनी है, तो पक्का करें कि जिस खाते से साइन इन करना है (आम तौर पर, टेस्ट डिवाइस पर खाता) वह प्रोजेक्ट में टेस्टर के तौर पर दर्ज हो. अनुमति देने के लिए, Google Play Console के गेम सेवाएं सबटैब में टेस्टिंग पेज खोलें. ऐसा न करने पर, सर्वर यह काम करता है, जैसे कि आपका प्रोजेक्ट नहीं है. इस वजह से, सर्वर से जुड़ी गड़बड़ियां मिलती हैं.

वैकल्पिक: ग्रहण के साथ अपने आप बनाना

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

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

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

ध्यान दें: अगर आपको Eclipse में ऐसी C या C++ फ़ाइलें में बदलाव करते समय गड़बड़ियां दिखती हैं जो आपको प्रोजेक्ट बनाने से रोकती हैं, तो हो सकता है कि आप Eclipse में C/C++ गड़बड़ी की रिपोर्टिंग बंद करें. अपनी प्रोजेक्ट प्रॉपर्टी में, C/C++ General > CodeAnalytics > Launching पर जाएं और पक्का करें कि दोनों बॉक्स से सही का निशान हटाया गया हो. इसके बाद, लागू करें और फिर ठीक है पर क्लिक करें. यह Eclipse को अपने नेटिव कोड की जांच करने से रोकने का एक तरीका है. इससे, आपको आ रही वास्तविक गड़बड़ियों को ठीक नहीं किया जा सकता.