استكشاف الأخطاء وإصلاحها

حظر Chrome الوصول إلى الشبكة المحلية

تتصل الصفحة على droid.devpier.dev بالبوابة على جهاز Mac الخاص بك. يطلب Chrome الإذن في المرة الأولى. إذا رفضته، لا تستطيع الصفحة الاتصال، وبعد بضع محاولات فاشلة تخبرك بأن Chrome حظر الوصول إلى جهاز Mac الخاص بك.

للسماح بذلك مرة أخرى:

1. افتح في Chrome الإعدادات ← الخصوصية والأمان ← إعدادات الموقع.
2. ابحث عن droid.devpier.dev واسمح بالوصول إلى الشبكة المحلية.
3. أعد تحميل الصفحة.

إذا ظل الاتصال متعذرًا، استخدم صفحة الاحتياط المحلية.

المنفذ مستخدم بالفعل

تستمع البوابة على المنفذ 7300 افتراضيًا. إذا كان برنامج آخر يستخدم ذلك المنفذ بالفعل، لا تستطيع البوابة البدء عليه. اعثر على البرنامج:

lsof -nP -iTCP:7300 -sTCP:LISTEN

أوقف ذلك البرنامج، أو شغّل البوابة على منفذ آخر:

android-emu-web --port 7301

تضع البوابة المنفذ الجديد في العنوان الذي تفتحه، فتتصل الصفحة بالمنفذ الصحيح.

لم يُعثر على محاكٍ

إذا ذكرت الصفحة أنه لم يُعثر على محاكٍ قيد التشغيل:

• تحقق من أن هناك محاكيًا قيد التشغيل: يجب أن يعرض adb devices الجهاز emulator-5554 أو ما يشبهه.
• تحقق من أنه شُغّل مع تفعيل gRPC (-grpc <port>). لا تستطيع البوابة قراءة شاشة محاكٍ يعمل دون gRPC.

يمكنك أيضًا تشغيل جهاز من القائمة في الصفحة. راجع الأجهزة.

تستمر البوابة في العمل عندما لا يُعثر على محاكٍ، وتطبع السبب في Terminal.

إذا أبلغت البوابة عن فقدان Android SDK أو emulator أو platform-tools أو صورة النظام، فاتبع طريقة الإصلاح التي تطبعها. راجع التشغيل الأول.

“sdkmanager” مفقود

قد لا يتضمن SDK المثبَّت عبر Android Studio حزمة cmdline-tools، التي توفر sdkmanager وavdmanager. لا تنزّلها البوابة. نزّل أدوات سطر الأوامر من Google من developer.android.com وفك ضغطها بحيث يوجد هذا المسار:

<your SDK>/cmdline-tools/latest/bin/sdkmanager

انتهت صلاحية الرمز المميز

تنشئ البوابة رمزًا مميزًا جديدًا في كل مرة تبدأ فيها. إذا أعدت تشغيل البوابة، فإن الصفحة التي لا تزال تحمل الرمز القديم تعرض أن الرمز لم يعد صالحًا وتتوقف عن إعادة المحاولة. افتح الرابط الجديد الذي طبعته البوابة، أو شغّل البوابة مرة أخرى.

تذكر الصفحة أن البوابة أو الصفحة قديمة

• البوابة قديمة: شغّل أمر الترقية الذي تعرضه الصفحة. وهو نفس أمر التثبيت.
• الصفحة قديمة: أعد تحميل الصفحة قسريًا باستخدام Cmd+Shift+R.

متصفح غير مناسب

تعمل الصفحة في Chrome وEdge فقط. في المتصفحات الأخرى تطلب منك التبديل ولا تحاول الاتصال. راجع دعم المتصفحات.

استخدم صفحة الاحتياط المحلية

تقدّم البوابة الصفحة نفسها على http://127.0.0.1:7300/app/ (أو المنفذ الذي اخترته). استخدمها عندما لا تُحمَّل الصفحة العامة أو عندما يكون الوصول إلى الشبكة المحلية مرفوضًا.

توقف تحديث الشاشة

إذا خرج المحاكي أو أُعيد تشغيله، تعرض الصفحة أنه غير متصل. تستمر البوابة في العمل. وعندما يعود المحاكي، تعيد الصفحة الاتصال وتعود الشاشة.