क्विकस्टार्ट

Windows कंप्यूटर पर Android Game Development Extension सेट अप करें. इसके बाद, Android डिवाइस या एम्युलेटर पर Visual Studio C++ का सैंपल प्रोजेक्ट चलाएं.

ज़रूरी शर्तें

एक्सटेंशन इंस्टॉल करने के लिए, अपने Windows कंप्यूटर को तैयार करने के लिए, इस सेक्शन में दिया गया तरीका अपनाएं:

1. Visual Studio के इन वर्शन में से कोई एक डाउनलोड और इंस्टॉल करें:

   • Visual Studio 2017 का वर्शन 15.4.0 (9 अक्टूबर, 2017) या इसके बाद का वर्शन.
   • Visual Studio 2019 का 16.0.0 या इसके बाद का वर्शन.
   • Visual Studio 2022 का 17.0.0 या इसके बाद का वर्शन.

2. .NET Core SDK 2.2 को डाउनलोड और इंस्टॉल करें.

3. Android Studio 3.5 या इसके बाद के वर्शन का इस्तेमाल करना ज़रूरी नहीं है. हालांकि, Android SDK और NDK इंस्टॉल करने के लिए, Android Game Development Extension के बजाय इसका इस्तेमाल किया जा सकता है.

4. AGDE 23.1.82 या इसके बाद के वर्शन के लिए, JDK 17 डाउनलोड और इंस्टॉल करें. इसके अलावा, AGDE 22.2.71 तक के वर्शन के लिए, JDK 11 डाउनलोड और इंस्टॉल करें. साथ ही, अपने JAVA_HOME एनवायरमेंट वैरिएबल को सेट करें.

एक्सटेंशन इंस्टॉल करना

Android Game Development Extension को डाउनलोड और इंस्टॉल करने के लिए, इस सेक्शन में दिया गया तरीका अपनाएं:

1. Visual Studio के सभी इंस्टेंस बंद करें.

2. डाउनलोड पेज से, एक्सटेंशन इंस्टॉलर और सैंपल का नया वर्शन डाउनलोड करें.

3. डाउनलोड की गई फ़ाइल पर दो बार क्लिक करें. इंस्टॉलर को पूरा होने में कुछ मिनट लगते हैं.

4. अगर आपने Visual Studio के एक से ज़्यादा वर्शन इंस्टॉल किए हैं, तो उन वर्शन को चुनें जिनके लिए आपको एक्सटेंशन इंस्टॉल करना है.

5. इंस्टॉलेशन पूरा करने के लिए, हो गया पर क्लिक करें.

Android SDK और NDK इंस्टॉल करना

Android Studio या Android गेम डेवलपमेंट एक्सटेंशन की मदद से, Android SDK और Android नेटिव डेवलपमेंट किट (NDK) इंस्टॉल की जा सकती है. एक्सटेंशन से एसडीके और एनडीके इंस्टॉल करने के लिए, एसडीके मैनेजर का इस्तेमाल करें. यह Visual Studio के एक्सटेंशन टूलबार में मौजूद होता है.

NDK इंस्टॉल करते समय, NDK (साइड-बाय-साइड) चेकबॉक्स का इस्तेमाल करना न भूलें, ताकि एक्सटेंशन इसे ढूंढ सके. आपको एक्सटेंशन के साथ काम करने वाला NDK वर्शन इंस्टॉल करना होगा. इसके लिए, NDK के वर्शन का इतिहास देखें.

अगर आपको SDK टूल को डिफ़ॉल्ट जगह के बजाय किसी दूसरी जगह पर इंस्टॉल करना है, तो अपने कंप्यूटर पर ANDROID_SDK_ROOT एनवायरमेंट वैरिएबल सेट करें:

1. पक्का करें कि Visual Studio बंद हो.
2. Windows Search में, Environment Variables खोजें.
3. सिस्टम एनवायरमेंट वैरिएबल में बदलाव करें को चुनें.
4. एनवायरमेंट वैरिएबल पर क्लिक करें.
5. उपयोगकर्ता वैरिएबल में जाकर, नया पर क्लिक करें.
6. वैरिएबल का नाम बॉक्स में, ANDROID_SDK_ROOT टाइप करें.
7. वैरिएबल वैल्यू बॉक्स में, Android SDK का पाथ डालें.
8. अपने कंप्यूटर को रीबूट करें.

एसडीके मैनेजर विंडो का इस्तेमाल करके, एसडीके की जगह में बदलाव नहीं किया जा सकता. ऐसा इसलिए, क्योंकि यह एनवायरमेंट वैरिएबल, एसडीके की जगह के लिए सोर्स-ऑफ़-ट्रुथ होता है.

सैंपल चलाना

इस सेक्शन में दिया गया तरीका अपनाकर, एमुलेटर पर दिए गए सैंपल को चलाएं. इसके बाद, उसे किसी Android डिवाइस पर चलाएं.

प्लैटफ़ॉर्म को कॉन्फ़िगर करना

1. सैंपल की ZIP फ़ाइल को अपनी पसंद की किसी डायरेक्ट्री में अनज़िप करें. इसमें ये सैंपल शामिल हैं:

   • endless-tunnel
   • HelloJNI
   • टीपॉट

2. अगर Visual Studio पहले से नहीं चल रहा है, तो इसे शुरू करें.

3. सैंपल डायरेक्ट्री खोलें. File > Open > Project/Solution चुनें और .sln फ़ाइल पर जाएं.

4. कोई Android प्लैटफ़ॉर्म चुनें:

   1. बनाएं > Configuration Manager को चुनें.
   2. चालू समाधान प्लैटफ़ॉर्म में जाकर, Android-x86_64 को चुनें.

   Android प्लैटफ़ॉर्म, सैंपल में पहले से कॉन्फ़िगर किए गए हैं. प्लैटफ़ॉर्म जोड़ने के लिए, ज़्यादा Android प्लैटफ़ॉर्म जोड़ें देखें.

5. पक्का करें कि सैंपल प्रोजेक्ट में Android SDK और NDK प्रॉपर्टी कॉन्फ़िगर की गई हों:

   

   • Solution Explorer में, प्रोजेक्ट पर राइट क्लिक करें और Properties चुनें.

   • सामान्य प्रॉपर्टी टैब चुनें. इसके बाद, Android के लिए प्लैटफ़ॉर्म प्रॉपर्टी ढूंढें.

6. Android पैकेजिंग प्रॉपर्टी टैब चुनें.

   

   इस टैब से, आउटपुट APK का नाम और डायरेक्ट्री बदली जा सकती है. ध्यान दें कि Android कॉन्फ़िगरेशन की कुछ प्रॉपर्टी, प्रॉपर्टी पेजों में तय की जाती हैं और उन्हें Gradle को पास किया जाता है. उदाहरण के लिए, APK के नाम वाली प्रॉपर्टी MSBUILD_ANDROID_OUTPUT_APK_NAME इस नाम को ऐप्लिकेशन build.gradle फ़ाइल में पास करती है.

एम्युलेटर सेट अप करना

1. Visual Studio में एक्सटेंशन टूलबार से AVD Manager शुरू करें. वर्चुअल डिवाइस कॉन्फ़िगर करें. इसके बाद, इसे Android Emulator में चलाएं.

   1. Android Virtual Device Manager में, Create Virtual Device पर क्लिक करें.
   2. डिवाइस की परिभाषा चुनें. उदाहरण के लिए, Pixel 2.
   3. कोई सिस्टम इमेज चुनें. आपको x86_64 ABI चुनना चाहिए, क्योंकि यह आर्किटेक्चर एम्युलेटर में तेज़ी से काम करता है.
   4. कॉन्फ़िगरेशन की पुष्टि करें और Finish पर क्लिक करें.

2. Android Virtual Device Manager में मौजूद, चलाएं बटन पर क्लिक करके वर्चुअल डिवाइस शुरू करें.

3. Visual Studio में, वर्चुअल डिवाइस को डीबग करना शुरू करें टूलबार बटन के बगल में दिखना चाहिए. डिवाइस पर सैंपल ऐप्लिकेशन लॉन्च करने के लिए, Start Debugging पर क्लिक करें. डीबगर को ऐप्लिकेशन से अटैच होने में कुछ समय लग सकता है. अगर Teapot सैंपल चलाया जा रहा है, तो माउस कर्सर को खींचकर टीपॉट को घुमाया जा सकता है.

   
   तीसरी इमेज 3. Android Emulator पर चल रहा टीपॉट सैंपल

डिवाइस सेट अप करना

1. किसी फ़िज़िकल Android डिवाइस पर सैंपल चलाने के लिए, आपको प्रोजेक्ट में नया Android प्लैटफ़ॉर्म बनाना पड़ सकता है. यह प्लैटफ़ॉर्म, डिवाइस के आर्किटेक्चर से मेल खाना चाहिए. नया प्लैटफ़ॉर्म बनाने के लिए, Visual Studio में यह तरीका अपनाएं:

   1. बनाएं > Configuration Manager को चुनें.
   2. चालू समाधान प्लैटफ़ॉर्म में जाकर, <नया> चुनें.

   3. नए प्लैटफ़ॉर्म के लिए, इनमें से कोई एक विकल्प टाइप करें:

      • Android-armeabi-v7a
      • Android-arm64-v8a
      • Android-x86
      • Android-x86_64

   4. सेटिंग कॉपी करें बॉक्स में, कोई दूसरा मौजूदा Android प्लैटफ़ॉर्म चुनें. अगर आपके पास अभी तक कोई Android प्लैटफ़ॉर्म नहीं है, तो कोई नहीं चुनें. पक्का करें कि आपने नए प्रोजेक्ट प्लैटफ़ॉर्म बनाएं विकल्प चालू किया हो.

2. यूएसबी केबल का इस्तेमाल करके, Android डिवाइस को कंप्यूटर से कनेक्ट करें. डिवाइस का टाइप, टूलबार बटन डीबग करना शुरू करें के बगल में दिखना चाहिए.

   
   चौथी इमेज. कनेक्ट किया गया Android डिवाइस, डीबग करना शुरू करें टूलबार बटन के बगल में दिखाया गया है

   अगर डिवाइस नहीं दिख रहा है, तो यहां दी गई जानकारी देखें:

   • प्लैटफ़ॉर्म का चुना गया वर्शन, आपके डिवाइस के एबीआई से मेल खाता हो.
   • डिवाइस पर डेवलपर के लिए सेटिंग और टूल और यूएसबी डीबग करने की सुविधा चालू हो.
   • यूएसबी केबल, डिवाइस से कंप्यूटर तक कनेक्ट हो.
   • यूएसबी केबल से डेटा ट्रांसफ़र किया जा सकता हो (सिर्फ़ पावर ट्रांसफ़र नहीं).

3. डिवाइस पर सैंपल ऐप्लिकेशन लॉन्च करने के लिए, टूलबार में मौजूद डिबग करना शुरू करें बटन पर क्लिक करें. डीबगर को ऐप्लिकेशन से अटैच होने में कुछ समय लग सकता है. अटैच होने के बाद, अपने डिवाइस पर ऐप्लिकेशन से इंटरैक्ट किया जा सकता है.

अक्सर पूछे जाने वाले सवाल

Android Game Development Extension के बारे में अक्सर पूछे जाने वाले कुछ सवाल यहां दिए गए हैं.

प्लगिन के लॉग कहां मौजूद होते हैं?

प्लगिन के लिए लॉग फ़ाइल खोलने के लिए, Android गेम डेवलपमेंट एक्सटेंशन टूलबार में मौजूद लॉग खोलें आइकॉन का इस्तेमाल करें.

यह प्लगिन किन एनवायरमेंट वैरिएबल का इस्तेमाल करता है?

यह प्लगिन, इन एनवायरमेंट वैरिएबल का इस्तेमाल करता है:

• ANDROID_SDK_ROOT
• ANDROID_SDK_HOME
• TEMP
• GOOGLE_ANDROID_LOG_DIR

अगला कदम क्या है

एक्सटेंशन के साथ अपने प्रोजेक्ट का इस्तेमाल करने के लिए, आपको उसे प्रोजेक्ट कॉन्फ़िगरेशन गाइड के मुताबिक कॉन्फ़िगर करना होगा.