الأجهزة

الجهاز هنا هو جهاز Android افتراضي (AVD) على جهاز Mac الخاص بك. تعرض الصفحة جهازًا واحدًا في كل مرة.

قائمة الأجهزة

تعرض القائمة على اليسار كل AVD يُبلغ عنه emulator -list-avds. ولكل جهاز تعرض:

• الاسم؛
• دقة الشاشة؛
• إصدار Android؛
• الحالة: غير قيد التشغيل، أو قيد الإقلاع (مع الثواني المنقضية)، أو قيد التشغيل، أو قيد التشغيل لكن لا يمكن تولّي التحكم فيه؛
• زر تشغيل أو إيقاف.

تأتي الدقة وذاكرة RAM وإصدار Android من ملف config.ini الخاص بكل AVD في ~/.android/avd/<name>.avd/. إذا عيّنت ANDROID_AVD_HOME، تقرأ البوابة ذلك الدليل بدلًا منه. إذا كان حقل ما مفقودًا من config.ini، يُترك فارغًا.

تشغيل جهاز

انقر على زر التشغيل بجانب جهاز. تشغّل البوابة:

emulator -avd <name> -no-window -grpc <port> -no-boot-anim -gpu host

• يعني -no-window أنه لا تُفتح نافذة محاكٍ منفصلة. تظهر الشاشة في الصفحة فقط.
• منفذ gRPC هو أول منفذ زوجي متاح بدءًا من 8554 فصاعدًا.
• يُعدّ الجهاز قد أكمل الإقلاع عندما يُرجع adb -s emulator-<serial> shell getprop sys.boot_completed القيمة 1. وتعرض الصفحة التقدم حتى ذلك الحين.
• إذا لم يكتمل إقلاع الجهاز بعد 180 ثانية، يفشل التشغيل وتنهي البوابة عملية المحاكي.

النقر على زر التشغيل مرة أخرى أثناء إقلاع جهاز لا يشغّل نسخة ثانية. إذا أغلقت الصفحة أثناء الإقلاع ثم فتحتها مرة أخرى، يستمر عرض التقدم.

إيقاف جهاز

انقر على زر الإيقاف. تشغّل البوابة adb -s emulator-<serial> emu kill.

المحاكيات التي تعمل بالفعل

تعثر البوابة على المحاكيات قيد التشغيل من خلال الملفات التي يكتبها المحاكي في ~/Library/Caches/TemporaryItems/avd/running/. إذا كان هناك محاكٍ يعمل مع تفعيل gRPC، على سبيل المثال محاكٍ شغّلته باستخدام -grpc <port>، تتصل به البوابة بدلًا من تشغيل نسخة أخرى.

يُوسم المحاكي الذي يعمل دون gRPC بأنه “قيد التشغيل لكن لا يمكن تولّي التحكم فيه”. تحتاج البوابة إلى gRPC لقراءة الشاشة وإرسال الإدخال. أوقف ذلك المحاكي وشغّله من الصفحة.

عند توقف البوابة

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

إنشاء جهاز

إذا لم يكن لديك أي AVD، تعرض البوابة في التشغيل الأول إنشاء emu_web_default: ملف تعريف Pixel 5، وصورة نظام arm64 لـ Android 14 (API 34)، وذاكرة RAM بسعة 4096 MB، ودقة 1080×2340. راجع التشغيل الأول. يمكنك أيضًا إنشاء أجهزة باستخدام avdmanager أو Android Studio؛ وستظهر في القائمة.