पहली बार चलाना

1. गेटवे शुरू करें

android-emu-web

गेटवे डिफ़ॉल्ट रूप से 127.0.0.1 पर, पोर्ट 7300 पर सुनता है। कोई दूसरा पोर्ट इस्तेमाल करने के लिए कमांड लाइन देखें।

2. उसे आपका Android SDK जाँचने दें

शुरू होने पर गेटवे Android SDK, cmdline-tools, emulator, platform-tools, सिस्टम इमेज system-images;android-34;google_apis;arm64-v8a, और कम से कम एक वर्चुअल डिवाइस (AVD) की जाँच करता है। जो भी चीज़ मौजूद नहीं है, उसे वह उसके समाधान के साथ इस क्रम में प्रिंट करता है:

क्या मौजूद नहीं है	गेटवे क्या करता है
Android SDK या cmdline-tools	Google के command line tools का डाउनलोड पेज और वह डायरेक्टरी प्रिंट करता है जिसमें उन्हें अनपैक करना है। यह इन्हें ख़ुद डाउनलोड नहीं करता।
emulator, platform-tools, सिस्टम इमेज	sdkmanager कमांड और अनुमानित साइज़ प्रिंट करता है, फिर [y/N] पूछता है।
कोई AVD नहीं	emu_web_default नाम का एक डिफ़ॉल्ट डिवाइस (Pixel 5 प्रोफ़ाइल, 4096 MB RAM) बनाने का विकल्प देता है, फिर [y/N] पूछता है।

डिफ़ॉल्ट जवाब N है। जब तक आप y टाइप नहीं करते, कुछ भी डाउनलोड नहीं होता और कुछ भी नहीं बनाया जाता। अगर आप N जवाब देते हैं, तो गेटवे कमांड प्रिंट कर देता है ताकि आप उन्हें ख़ुद चला सकें, और शुरू होना जारी रखता है।

इससे पहले कि sdkmanager पैकेज इंस्टॉल करे, Android SDK के लाइसेंस स्वीकार करने ज़रूरी हैं। sdkmanager --licenses उन्हें आपके Terminal में दिखाता है, और आप उन्हें ख़ुद स्वीकार करते हैं।

उदाहरण के लिए, सिस्टम इमेज को हाथ से इंस्टॉल करने के लिए:

sdkmanager "system-images;android-34;google_apis;arm64-v8a"

3. पेज खोलें

गेटवे हर बार शुरू होने पर एक नया रैंडम टोकन बनाता है, और आपका डिफ़ॉल्ट ब्राउज़र इस तरह के पते पर खोलता है:

https://droid.devpier.dev/app/#port=7300&token=<token>

पोर्ट और टोकन # के बाद होते हैं, इसलिए ब्राउज़र उन्हें वेब सर्वर को नहीं भेजता। पेज उन्हें ब्राउज़र में सेव करता है और एड्रेस बार से हटा देता है। अगर आपका डिफ़ॉल्ट ब्राउज़र Chrome या Edge नहीं है, तो Terminal से पता कॉपी करके Chrome या Edge में खोलें।

4. लोकल नेटवर्क एक्सेस की अनुमति दें

जब पेज पहली बार आपके Mac पर गेटवे से कनेक्ट होता है, तो Chrome एक अनुमति प्रॉम्प्ट दिखाता है जिसमें पूछा जाता है कि क्या droid.devpier.dev आपके लोकल नेटवर्क को एक्सेस कर सकता है। इसकी अनुमति दें। Chrome उस साइट के लिए यह चुनाव याद रखता है।

अगर आपने इसे मना कर दिया था, तो समस्या निवारण देखें।

5. एमुलेटर इस्तेमाल करें

अगर gRPC वाला कोई एमुलेटर पहले से चल रहा है, तो पेज उसकी स्क्रीन दिखाता है।

नहीं तो सूची में से कोई डिवाइस चुनें और उसे शुरू करें। डिवाइस देखें।

स्क्रीन को कीबोर्ड फ़ोकस देने के लिए उस पर क्लिक करें। फिर:

• टैप के लिए क्लिक करें; स्वाइप के लिए ड्रैग करें।
• अपने Mac के कीबोर्ड पर टाइप करें। कीबोर्ड और इनपुट देखें।
• स्क्रीन के ऊपर Back, Home और Recents बटन इस्तेमाल करें।

बंद करें

जिस Terminal में गेटवे चल रहा है, उसमें Ctrl+C दबाएँ। चल रहे एमुलेटर चलते रहते हैं। अगली बार जब आप गेटवे शुरू करेंगे, तो वह उनसे फिर से कनेक्ट हो जाएगा।

लोकल फ़ॉलबैक पेज

गेटवे यही पेज ख़ुद भी http://127.0.0.1:7300/app/ पर (या आपके चुने हुए पोर्ट पर) सर्व करता है। अगर पब्लिक पेज लोड नहीं होता या कनेक्ट नहीं हो पाता, तो इसका इस्तेमाल करें।