ADB / Android Debug Bridge
مضمّن في Macro Deckتحكّم في هاتف أو جهاز لوحي يعمل بنظام Android عبر USB أو Wi-Fi: أيقظه، وشغّل التطبيقات، وانقر، واكتب، والتقط لقطات الشاشة.
علامة التبويب نظرة عامة لتكامل ADB / Android Debug Bridge، مع تنبيه بتفعيل ADB في الإعدادات
- إيقاظ جهاز Android متصل وقفله وإعادة تشغيله
- تشغيل التطبيقات أو إنهاؤها بالقوة وفتح الروابط على الجهاز
- إرسال المفاتيح والنقرات وحركات السحب والنصوص
- حفظ لقطات من شاشة الجهاز في مجلد
- أحداث الأجهزة ومتغيرات للبطارية والشاشة والتطبيق الظاهر في المقدمة
يتحكم تكامل ADB في هواتف Android وأجهزتها اللوحية عبر Android Debug Bridge (ADB)، وهي الأداة نفسها التي يستخدمها مطورو Android. يعثر Macro Deck على برنامج adb، ويشغّل خادم ADB، ويتتبع الأجهزة الموصولة عبر USB أو المتصلة عبر Wi-Fi. ويمكنه أيضًا تنزيل أدوات منصة Android الرسمية (platform-tools) نيابةً عنك.
يعمل كل إجراء على الجهاز الذي تختاره في الإجراء، أو على الجهاز الافتراضي عندما تترك الجهاز فارغًا. الجهاز الافتراضي هو الذي اخترته باستخدام تعيين كافتراضي في الإعدادات > ADB، أو الجهاز الموصول الوحيد إذا لم تختر أي جهاز.
ما يمكنك فعله
- الشاشة والطاقة: إيقاظ الجهاز، أو إطفاء الشاشة (بهذه الطريقة يقفل Android الجهاز)، أو إعادة تشغيله إلى Android أو وضع الاسترداد أو محمّل الإقلاع.
- التطبيقات والروابط: تشغيل تطبيق أو إنهاؤه بالقوة باسم حزمته، مثل
com.spotify.music، وفتح رابط بالتطبيق الذي يختاره الجهاز له. - الإدخال: إرسال مفتاح مثل Home أو Back أو Volume Up أو Media Play Pause، أو النقر على نقطة في الشاشة، أو السحب من نقطة إلى أخرى، أو كتابة نص في الحقل النشط.
- لقطات الشاشة: التقاط الشاشة كملف PNG في مجلد على حاسوبك، مع إمكانية كتابة مسار الملف في متغير.
بعض الأمثلة على الإعدادات:
- زر يوقظ جهازًا لوحيًا على مكتبك ويشغّل تطبيق الموسيقى.
- زر يرسل Media Play Pause إلى هاتفك.
- أتمتة على تم توصيل الجهاز تفتح صفحة لوحة معلومات على جهاز لوحي بمجرد توصيله.
الحالة المباشرة
يُبلغ التكامل عندما يُوصل جهاز أو يُفصل، أو يُفوَّض، أو يصبح غير مفوّض، أو ينقطع اتصاله أو يعود، فتستطيع التدفقات والأزرار الاستجابة لذلك. تحمل المتغيرات عدد الأجهزة المتصلة والمفوّضة، وللجهاز الافتراضي: طرازه، والشركة المصنّعة، ومستوى البطارية، وما إذا كانت الشاشة مضاءة، وما إذا كانت شاشة القفل ظاهرة، وأي تطبيق في المقدمة. ويحصل كل جهاز مفوّض أيضًا على متغيرات خاصة به، مسمّاة باسم طرازه. وما دام التكامل مفعّلًا، تظهر بطارية كل جهاز Android أيضًا في أداة البطارية.
تستمر الإجراءات الأساسية (المفاتيح والنقرات والسحب والنصوص والتطبيقات والروابط وإعادة التشغيل ولقطات الشاشة) في العمل أثناء قفل Macro Deck، فيعمل الزر المرتبط بأحدها حتى على حاسوب مقفل.
ما تحتاج إليه
- Macro Deck 3 على Windows أو macOS أو Linux
- جهاز Android فُعّل فيه USB debugging من Developer options
- كابل USB ينقل البيانات، أو تصحيح الأخطاء اللاسلكي للاتصال عبر Wi-Fi
- أدوات منصة Android (adb)؛ يستطيع Macro Deck تنزيلها من الإعدادات > ADB
- على Linux، إذن لمستخدمك بالوصول إلى جهاز USB، عادةً عبر قاعدة udev
خطوات الإعداد
الخطوة 1: فعّل تكامل ADB
في الشريط الجانبي، انقر التكاملات ثم ADB / Android Debug Bridge. يبقى التكامل معطّلًا حتى تشغّل المفتاح في أعلى اليسار. بعد تفعيله، تعرض الصفحة ADB معطّل إلى أن تفعّل ADB في الخطوة التالية.
الخطوة 2: فعّل ADB في Macro Deck
افتح الإعدادات > ADB وشغّل تفعيل ADB. إذا عرض برنامج ADB القيمة غير موجود، فانقر تنزيل أدوات المنصة. يُعثر تلقائيًا على Android SDK مثبّت أو على
adbموجود فيPATH، ويتيح لك مسار الملف التنفيذي الإشارة إلى نسخة أخرى.الخطوة 3: فعّل USB debugging على الجهاز
على الهاتف أو الجهاز اللوحي، افتح Settings > About phone وانقر Build number سبع مرات لتفعيل Developer options. ثم فعّل USB debugging في Settings > Developer options. يختلف المكان الدقيق قليلًا من شركة مصنّعة إلى أخرى.
الخطوة 4: وصّل الجهاز وفوّضه
وصّل الجهاز بكابل USB وأكّد Allow USB debugging? على شاشته. حدّد Always allow from this computer حتى لا يسألك مجددًا. يظهر الجهاز بعدها تحت الأجهزة في الإعدادات > ADB بحالة جاهز. للاتصال عبر Wi-Fi بدلًا من ذلك، أدخل عنوان IP للجهاز ومنفذه في الاتصال عبر Wi-Fi، مثل
192.168.1.20:5555.الخطوة 5: اختر جهازًا افتراضيًا
عند توصيل أكثر من جهاز، انقر تعيين كافتراضي بجانب الجهاز الذي يجب أن تستخدمه إجراءاتك عندما تترك الجهاز فارغًا. أما مع جهاز واحد، فيُستخدم تلقائيًا.
الخطوة 6: أضف إجراء ADB إلى زر
في صفحة اللوحة، تأكد من أن اللوحة غير مقفلة (يعرض الزر في أعلى اليسار قفل)، ثم انقر زرًا. يُفتح المحرر مع تحديد ضغطة قصيرة. انقر + إضافة إجراء، واختر ADB / Android Debug Bridge على يمين نافذة إضافة إجراء، ثم اختر إجراءً، مثل إيقاظ الجهاز أو تشغيل التطبيق. املأ حقوله، مثل الحزمة في تشغيل التطبيق، واترك الجهاز فارغًا لاستخدام الجهاز الافتراضي. لا تظهر الفئة إلا ما دام التكامل مفعّلًا.
الخطوة 7: اضغط الزر
انقر حفظ واضغط الزر على لوحتك. إذا لم يحدث شيء، فابحث في التكاملات عن تنبيه، مثل لا توجد أجهزة متصلة أو جهاز يحتاج إلى تفويض.
الإجراءات11
ضعها على زر أو شغّلها من تدفق.
- إيقاظ الجهاز
- يوقظ شاشة الجهاز.
- السكون / قفل الشاشة
- يطفئ شاشة الجهاز، وهي الطريقة التي يقفل بها Android الجهاز.
- تشغيل التطبيق
- يشغّل تطبيقًا باسم حزمته، أو ينقله إلى المقدمة.
- إنهاء التطبيق بالقوة
- ينهي تطبيقًا بالقوة باسم حزمته.
- فتح الرابط
- يفتح URI على الجهاز، تمامًا كالنقر على رابط.
- كتابة نص
- يكتب نصًا في الحقل النشط حاليًا على الجهاز.
- إرسال مفتاح
- يرسل حدث مفتاح Android واحدًا، مثل Home أو Back أو Volume Up أو Media Next.
- نقر
- ينقر على الشاشة عند الإحداثيين X وY المحددين.
- سحب
- يسحب على الشاشة من نقطة إلى أخرى خلال مدة محددة.
- إعادة تشغيل الجهاز
- يعيد تشغيل الجهاز في الوضع عادي أو الاسترداد أو محمّل الإقلاع.
- التقاط لقطة شاشة
- يلتقط شاشة الجهاز ويحفظها كملف PNG في مجلد، مع إمكانية كتابة مسارها في متغير.
المشغّلات6
يمكن لزر أو تدفق أن يستجيب لهذه الأحداث.
- تم توصيل الجهاز
- وُصل جهاز Android، أو رآه Macro Deck لأول مرة.
- تم فصل الجهاز
- فُصل جهاز Android، أو فقد Macro Deck أثره.
- تم تفويض الجهاز
- قُبل طلب التفويض على الجهاز.
- الجهاز أصبح غير مفوّض
- يحتاج جهاز فُوّض سابقًا إلى قبول طلب التفويض مجددًا.
- الجهاز أصبح متصلًا
- أصبح جهاز مفوّض قابلًا للوصول مجددًا.
- الجهاز أصبح غير متصل
- لم يعد بالإمكان الوصول إلى جهاز كان قابلًا للوصول.
المتغيرات11
اعرض هذه القيم على الأزرار والأدوات، أو استخدمها في الشروط.
adb_connected_device_count- عدد أجهزة Android الموصولة.
adb_authorized_device_count- عدد الأجهزة المتصلة والمفوّضة.
adb_device_connected- ما إذا كان الجهاز الافتراضي متصلًا.
adb_device_authorized- ما إذا كان الجهاز الافتراضي قد فوّض هذا الحاسوب.
adb_device_model- طراز الجهاز الافتراضي.
adb_device_manufacturer- الشركة المصنّعة للجهاز الافتراضي.
adb_device_battery_level- مستوى بطارية الجهاز الافتراضي بالنسبة المئوية.
adb_device_screen_on- ما إذا كانت شاشة الجهاز الافتراضي مضاءة.
adb_device_locked- ما إذا كان الجهاز الافتراضي يعرض شاشة القفل.
adb_device_foreground_app- اسم حزمة التطبيق الموجود في المقدمة على الجهاز الافتراضي.
adb_device_<device>_connected,adb_device_<device>_authorized,adb_device_<device>_model,adb_device_<device>_battery_level- الاتصال والتفويض والطراز ومستوى البطارية لكل جهاز مفوّض.
<device>هو طراز الجهاز بحروف صغيرة وأرقام وشرطات سفلية، وتُضاف إليه_2و_3وهكذا للأجهزة الأخرى من الطراز نفسه.
الأسئلة الشائعة
هل أحتاج إلى Android Studio أو Android SDK؟
لا. لا يحتاج Macro Deck إلا إلى برنامج adb من أدوات منصة Android. انقر تنزيل أدوات المنصة في الإعدادات > ADB فينزّل Macro Deck الحزمة الرسمية من Google، بحجم 15 MB تقريبًا، لاستخدامه الخاص. ويُعثر تلقائيًا على أي تثبيت موجود.
هل يمكنني التحكم في جهاز عبر Wi-Fi؟
نعم. فعّل تصحيح الأخطاء اللاسلكي على الجهاز وأدخل عنوان IP ومنفذه في الاتصال عبر Wi-Fi في الإعدادات > ADB. لا يقرن Macro Deck الأجهزة بنفسه: على Android 11 والأحدث، اقرن الجهاز بهذا الحاسوب أولًا، أو حوّله إلى تصحيح الأخطاء عبر الشبكة من خلال USB باستخدام adb tcpip. وإلا فسيرفض الجهاز الاتصال.
لماذا يفشل إجراء لعدم العثور على جهاز؟
عندما تترك الجهاز فارغًا، يستخدم الإجراء الجهاز الافتراضي. إذا لم تختر أي جهاز وكان أكثر من جهاز موصولًا، فلا يوجد جهاز افتراضي، لذا اختر جهازًا في الإجراء أو انقر تعيين كافتراضي في الإعدادات > ADB. وتحقق أيضًا من أن الجهاز يعرض جاهز وليس غير مصرّح به.
هل يوجد إجراء قفل منفصل؟
لا. لا يحتوي Android على أمر قفل منفصل. يطفئ السكون / قفل الشاشة الشاشة، فيقفل الجهاز بالطريقة نفسها التي يقفله بها زر التشغيل.
هل يؤثر تكامل ADB في البرامج الأخرى التي تستخدم ADB؟
يستخدم Macro Deck خادم ADB العادي، فتتشاركه برامج مثل Android Studio. يؤدي إعادة تشغيل خادم ADB في الإعدادات > ADB إلى فصل أجهزتها أيضًا لفترة قصيرة. يترك Macro Deck الخادم يعمل عند خروجه ما لم تفعّل إيقاف خادم ADB عند خروج Macro Deck.
لماذا يعرض الجهاز "لا توجد صلاحية للوصول إلى هذا الجهاز"؟
ليس لدى الحاسوب إذن بالتواصل مع الجهاز عبر USB. على Linux، ثبّت قواعد udev الخاصة بأدوات المنصة؛ وعلى Windows، ثبّت تعريف USB الخاص بالجهاز من الشركة المصنّعة.
المزيد في حاسوبك
النظام
مضمّن في Macro Deckتحكّم في حاسوبك من لوحتك: التطبيقات ومستوى الصوت والأوامر والإشعارات والسكون وإيقاف التشغيل.
لوحة المفاتيح
مضمّن في Macro Deckاضغط الاختصارات، واكتب النصوص، وشغّل تسلسلات المفاتيح على حاسوبك من زر.
الماوس
مضمّن في Macro Deckانقر، وحرّك المؤشر، واسحب، ومرّر على حاسوبك من زر.
Steam
مضمّن في Macro Deckشغّل ألعاب Steam وأغلقها، واعرض ما تلعبه وأصدقاءك ومكتبتك على لوحتك.