التشغيل الأول
1. شغّل البوابة
Section titled “1. شغّل البوابة”android-emu-webتستمع البوابة على 127.0.0.1، على المنفذ 7300 افتراضيًا. لاستخدام منفذ آخر، راجع سطر الأوامر.
2. دعها تتحقق من Android SDK لديك
Section titled “2. دعها تتحقق من Android SDK لديك”عند البدء، تتحقق البوابة من وجود Android SDK وcmdline-tools وemulator وplatform-tools وصورة النظام system-images;android-34;google_apis;arm64-v8a وجهاز افتراضي واحد على الأقل (AVD). وتطبع كل عنصر مفقود مع طريقة إصلاحه، بهذا الترتيب:
| المفقود | ما تفعله البوابة |
|---|---|
Android SDK أو cmdline-tools |
تطبع صفحة تنزيل أدوات سطر الأوامر من Google والدليل الذي يجب فك ضغطها فيه. لا تنزّلها بنفسها. |
emulator وplatform-tools وصورة النظام |
تطبع أمر sdkmanager والحجم التقريبي، ثم تسأل [y/N]. |
| لا يوجد AVD | تعرض أن تنشئ جهازًا افتراضيًا (AVD) مبدئيًا باسم emu_web_default (ملف تعريف Pixel 5، وذاكرة RAM بسعة 4096 MB)، ثم تسأل [y/N]. |
الإجابة الافتراضية هي N. لا يُنزَّل أو يُنشأ أي شيء ما لم تكتب y. إذا أجبت بـ N، تطبع البوابة الأوامر لتشغّلها بنفسك، وتواصل البدء.
يجب قبول تراخيص Android SDK قبل أن يثبّت sdkmanager الحزم. يعرضها sdkmanager --licenses في Terminal، وتقبلها أنت بنفسك.
على سبيل المثال، لتثبيت صورة النظام يدويًا:
sdkmanager "system-images;android-34;google_apis;arm64-v8a"3. افتح الصفحة
Section titled “3. افتح الصفحة”تنشئ البوابة رمزًا مميزًا (token) عشوائيًا جديدًا في كل مرة تبدأ فيها، وتفتح متصفحك الافتراضي على عنوان مثل هذا:
https://droid.devpier.dev/app/#port=7300&token=<token>يأتي المنفذ والرمز المميز بعد #، لذلك لا يرسلهما المتصفح إلى خادم الويب. تحفظهما الصفحة في المتصفح وتزيلهما من شريط العنوان. إذا لم يكن متصفحك الافتراضي Chrome أو Edge، فانسخ العنوان من Terminal إلى Chrome أو Edge.
4. اسمح بالوصول إلى الشبكة المحلية
Section titled “4. اسمح بالوصول إلى الشبكة المحلية”في المرة الأولى التي تتصل فيها الصفحة بالبوابة على جهاز Mac الخاص بك، يعرض Chrome طلب إذن يسأل عمّا إذا كان مسموحًا لـ droid.devpier.dev بالوصول إلى شبكتك المحلية. اسمح بذلك. يتذكر Chrome هذا الاختيار للموقع.
إذا رفضته، راجع استكشاف الأخطاء وإصلاحها.
5. استخدم المحاكي
Section titled “5. استخدم المحاكي”إذا كان هناك محاكٍ يعمل بالفعل مع gRPC، تعرض الصفحة شاشته.
وإلا فاختر جهازًا من القائمة وشغّله. راجع الأجهزة.
انقر على الشاشة لمنحها تركيز لوحة المفاتيح. ثم:
- انقر لتنفيذ لمسة، واسحب لتنفيذ سحبة بالإصبع.
- اكتب بلوحة مفاتيح جهاز Mac. راجع لوحة المفاتيح والإدخال.
- استخدم أزرار الرجوع والشاشة الرئيسية والتطبيقات الأخيرة فوق الشاشة.
الإيقاف
Section titled “الإيقاف”اضغط Ctrl+C في Terminal الذي تعمل فيه البوابة. تستمر المحاكيات قيد التشغيل في العمل. في المرة التالية التي تشغّل فيها البوابة، تتصل بها مرة أخرى.
صفحة الاحتياط المحلية
Section titled “صفحة الاحتياط المحلية”تقدّم البوابة أيضًا الصفحة نفسها بنفسها على http://127.0.0.1:7300/app/ (أو المنفذ الذي اخترته). استخدمها إذا لم تُحمَّل الصفحة العامة أو تعذّر عليها الاتصال.