تشغيل التطبيقات على جهاز

اختبِر تطبيق Android دائمًا على جهاز حقيقي قبل طرحه للمستخدمين. توضّح هذه الصفحة كيفية إعداد بيئة التطوير وجهاز Android للاختبار وتصحيح الأخطاء من خلال اتصال Android Debug Bridge (ADB).

إعداد جهاز للتطوير

قبل أن تتمكّن من بدء تصحيح الأخطاء على جهازك، عليك تحديد ما إذا كنت تريد الربط بالجهاز باستخدام كابل USB أو شبكة Wi-Fi. بعد ذلك، يُرجى اتّباع الخطوات التالية:

1. على الجهاز، افتح تطبيق الإعدادات، واختَر خيارات المطوّرين، ثمَّ فعِّل تصحيح أخطاء USB (إن أمكن).

2. اضبط إعدادات النظام لرصد جهازك.

   • ChromeOS: لا يلزم إجراء أي إعدادات إضافية.
   • macOS: لا يلزم إجراء أيّ إعدادات إضافية.
   • نظام التشغيل Windows: ثبِّت برنامج تشغيل USB لـ ADB (إذا كان ذلك منطبقًا). للاطّلاع على دليل التثبيت والرابط إلى برامج تشغيل المصنّعين الأصليين للأجهزة، يُرجى مراجعة تثبيت برامج تشغيل USB من المصنّع الأصلي للجهاز.

   • Ubuntu Linux: عليك إعداد ما يلي:

     • يجب أن يكون كل مستخدم يريد استخدام ADB في مجموعة plugdev. إذا ظهرت لك رسالة خطأ تفيد بأنّك لست في مجموعة plugdev، أضِف نفسك إليها باستخدام الأمر التالي:

     sudo usermod -aG plugdev $LOGNAME
     

     لا يتم تعديل المجموعات إلا عند تسجيل الدخول، لذا عليك تسجيل الخروج لكي يتم تطبيق هذا التغيير. عند إعادة تسجيل الدخول، يمكنك استخدام id للتأكّد من أنّك عضو في مجموعة plugdev.

     • يجب أن يكون لدى النظام udev قاعدة مثبّتة تغطي الجهاز. تحتوي حزمة android-sdk-platform-tools-common على مجموعة تلقائية من قواعد udev تديرها المنتدى لأجهزة Android. لتثبيته، استخدِم الأمر التالي:

     apt-get install android-sdk-platform-tools-common
     

الاتصال بجهازك باستخدام USB

بعد الانتهاء من الإعداد وربط الجهاز عبر USB، انقر على تشغيل في Android Studio لإنشاء تطبيقك وتشغيله على الجهاز.

يمكنك أيضًا استخدام adb لإصدار الأوامر، على النحو التالي:

• تأكَّد من اتصال جهازك بالجهاز الآخر من خلال تنفيذ الأمر adb devices من دليل android_sdk/platform-tools/. إذا كان الجهاز متصلاً، سيظهر لك الجهاز مدرجًا.
• أصدر أي أمر adb باستخدام العلامة -d لاستهداف جهازك.

الاتصال بجهازك باستخدام Wi-Fi

يتيح الإصدار 11 من نظام التشغيل Android والإصدارات الأحدث نشر تطبيقك وتصحيح أخطاءه لاسلكيًا من محطة العمل عبر أداة Android Debug Bridge (ADB). على سبيل المثال، يمكنك نشر تطبيقك القابل لتصحيح الأخطاء على أجهزة عن بُعد متعددة بدون توصيل جهازك عبر USB والتعامل مع المشاكل الشائعة في اتصال USB، مثل تثبيت برنامج التشغيل.

لاستخدام ميزة "تصحيح الأخطاء اللاسلكي"، يجب إقران جهازك بمحطة العمل باستخدام رمز إقران. للبدء، يُرجى إكمال الخطوات التالية:

1. تأكَّد من أنّ محطة العمل والجهاز متّصلان بالشبكة اللاسلكية نفسها.
2. تأكَّد من أنّ جهازك يعمل بنظام التشغيل Android 11 أو إصدار أحدث. لمزيد من المعلومات، يُرجى الاطّلاع على المقالة التحقّق من إصدار Android وتحديثه.
3. تأكَّد من تثبيت أحدث إصدار من Android Studio. يمكنك تنزيله من هنا.
4. على محطة العمل، ثبِّت أحدث إصدار من أدوات حزمة تطوير البرامج (SDK).

للاتصال بجهازك، اتّبِع الخطوات التالية:

1. افتح Android Studio واختَر إقران الأجهزة باستخدام Wi-Fi من قائمة الإعدادات.

   

   
   
   سيظهر مربع الحوار إقران الأجهزة عبر Wi-Fi، كما هو موضَّح في الشكل 2.

   

2. فعّل خيارات المطوّرين على جهازك
3. فعِّل تصحيح الأخطاء عبر فاقِد سرعة Wi-Fi على جهازك.

   

4. انقر على تصحيح الأخطاء اللاسلكي وأقران جهازك:
   1. لإقران جهازك باستخدام رمز استجابة سريعة، انقر على إقران الجهاز باستخدام رمز استجابة سريعة وامسح ضوئيًا رمز الاستجابة السريعة الموضح في الشكل 2.
   2. لإقران جهازك باستخدام رمز إقران، اختَر إقران الجهاز باستخدام رمز الإقران من مربّع الحوار إقران الأجهزة الجديدة عبر شبكة Wi-Fi. على الجهاز، اختَر الإقران باستخدام رمز الإقران. سيظهر رمز مكوّن من ستة أرقام. بعد ظهور جهازك في نافذة إقران الأجهزة عبر Wi-Fi، أدخِل الرمز المكوّن من ستة أرقام الذي يظهر على جهازك وانقر على إقران .

      

5. بعد الإقران، يمكنك محاولة نشر تطبيقك على جهازك.

لإقران جهاز مختلف أو حذف بيانات هذا الجهاز على محطة العمل:

1. انتقِل إلى تصحيح الأخطاء اللاسلكي على جهازك.
2. انقر على اسم محطة العمل ضمن الأجهزة المقترنة.
3. انقر على حذف.

النسخ المطابق للجهاز

يمكنك إجراء نسخ مطابق لمحتوى جهازك في نافذة الأجهزة قيد التشغيل في "استوديو Android". من خلال بث شاشة جهازك مباشرةً إلى Android Studio، يمكنك استخدام IDE في Studio نفسه لتنفيذ الإجراءات الشائعة، مثل تشغيل التطبيقات والتفاعل معها وتدوير الشاشة وطي الهاتف وفتحه وتغيير مستوى الصوت.

تتوفّر ميزة "إقران الأجهزة" دائمًا عندما تكون هناك أجهزة متصلة بالكمبيوتر ويكون تصحيح أخطاء USB أو تصحيح أخطاء الربط اللاسلكي مفعّلاً عليها. يمكنك بدء النسخ المطابق وإيقافه باستخدام نافذة الأجهزة قيد التشغيل أو مدير الجهاز (عرض > أداة Windows > مدير الأجهزة). يمكنك أيضًا تخصيص وقت تفعيل ميزة عكس الشاشة في إعدادات الجهاز (الإعدادات > الأدوات > عكس الشاشة).

إعادة توجيه الصوت

عند استخدام ميزة "نسخ شاشة الجهاز"، يمكنك إعادة توجيه الصوت من الأجهزة المادية المتصلة إلى مكبّرات صوت الكمبيوتر أو سماعات الرأس. باستخدام ميزة إعادة توجيه الصوت، يمكنك إبقاء سماعات الرأس متصلة بالكمبيوتر والاستماع إلى كلٍّ من الكمبيوتر والهاتف المتصل بدون الحاجة إلى إعادة الاتصال يدويًا بأحد الجهازَين ثم بالآخر. لتفعيل إعادة توجيه الصوت، انتقِل إلى File (ملف) (Android Studio على جهاز macOS) > الإعدادات > الأدوات > المزامنة على الجهاز وفي السحابة الإلكترونية واختَر إعادة توجيه الصوت من الأجهزة المحلية. تجدر الإشارة إلى أنّه تتم إعادة توجيه الصوت دائمًا، بغض النظر عن الإعدادات، على أجهزة Firebase Test Lab التي تعمل بنظام التشغيل Android 12 أو الإصدارات الأحدث.

المشاكل المعروفة

قد لا تكون بعض الأجهزة قادرة على ترميز المحتوى بمعدّل نقل بيانات كافٍ لتفعيل ميزة "إقران الأجهزة". في هذه الحالات، قد يظهر لك خطأ في نافذة الأجهزة التي تعمل بالإضافة إلى سجلّات مشابهة لما يلي.

2023-06-01 15:32:22,675 [  56094]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - Too many video encoder errors:
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - encoder: c2.android.vp8.encoder
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - mime type: video/x-vnd.on2.vp8
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max resolution: 640x640
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - min resolution: 2x2
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - alignment: 2x2
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max frame rate: 960
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max frame rate for 288x640: 960
2023-06-01 15:32:22,870 [  56289]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max bitrate: 20000000
2023-06-01 15:32:22,871 [  56290]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - terminated with code 1

إشعار الخصوصية

استنادًا إلى إعدادات ميزة "إقران الجهاز"، يمكن أن يبدأ Android Studio تلقائيًا إقران الجهاز لأي جهاز متصل ومقترن. وقد يؤدي ذلك إلى إفصاح عن معلومات للأجهزة المتصلة باستخدام الأمر adb tcpip لأنّه يتم نقل معلومات النسخ المطابق والأوامر عبر قناة غير مشفَّرة. بالإضافة إلى ذلك، يستخدم Android Studio قناة غير مشفَّرة للتواصل مع خادم adb، لذا يمكن للمستخدمين الآخرين intercepting رصد معلومات النسخ المطابق على جهازك المضيف.

تحديد مشاكل الاتصال بالجهاز وحلّها

إذا لم يكن جهازك متصلاً بتطبيق Android Studio، جرِّب الخطوات التالية لمحاولة حلّ المشكلة:

تحديد المشاكل وحلّها باستخدام "مساعد الربط"

يوفر مساعد الاتصال تعليمات خطوة بخطوة لمساعدتك في إعداد جهاز واستخدامه عبر اتصال ADB.

لبدء المساعد، اختَر الأدوات > تحديد المشاكل وحلّها في عمليات ربط الأجهزة.

يوفّر "مساعِد الربط" تعليمات وعناصر تحكّم في السياق وقائمة بالأجهزة المقترَنة في سلسلة من الصفحات في لوحة مساعد Google. استخدِم زرَّي التالي والسابق في أسفل لوحة مساعد Google للعمل على مراجعة الصفحات حسب الحاجة:

• توصيل جهازك عبر USB: يطلب منك "مساعِد الربط" أولاً توصيل جهازك عبر USB ويوفّر زر إعادة فحص أجهزة USB يمكنك من خلاله بدء عملية فحص جديدة للأجهزة المتصلة.
• تفعيل تصحيح أخطاء الجهاز عبر USB: يخبرك مساعد الاتصال بعد ذلك بكيفية تفعيل تصحيح أخطاء USB في خيارات المطوّرين على الجهاز.
• إعادة تشغيل خادم ADB: إذا لم يظهر جهازك في قائمة الأجهزة المتاحة، استخدِم الزر إعادة تشغيل خادم ADB في الصفحة الأخيرة من "مساعِد الاتصال". تؤدي إعادة تشغيل خادم ADB أيضًا إلى فحص ADB للأجهزة مرة أخرى. إذا لم يظهر جهازك في قائمة الأجهزة المتاحة، جرِّب خطوات تحديد المشاكل وحلّها في القسم التالي.

حلّ المشاكل المتعلقة باتصال USB

إذا لم يرصد "مساعِد الاتصال" جهازك عبر USB، جرِّب الخطوات التالية لتحديد المشاكل وحلّها:

التأكّد من اتصال "استوديو Android" بمحاكي Android

للتحقّق مما إذا كانت المشكلة ناتجة عن مشكلة في الاتصال بين Android Studio ومحاكي Android، اتّبِع الخطوات التالية:

1. افتح مدير الأجهزة.
2. أنشئ جهاز افتراضي Android جديدًا إذا لم يكن لديك جهاز.
3. ويمكنك تشغيل المحاكي باستخدام متوسّط مدة المشاهدة.
4. نفِّذ أيًا مما يلي:
   • إذا تعذّر على "استوديو Android" الاتصال بالمحاكي، نزِّل أحدث إصدار من أدوات حزمة تطوير البرامج (SDK) ثم أعِد المحاولة.
   • إذا بدأ المحاكي بنجاح، تحقّق من كابل USB كما هو موضّح في القسم التالي.

التحقّق من كابل USB

للتحقّق مما إذا كانت المشكلة ناتجة عن كابل USB تالف، اتّبِع الخطوات الواردة في هذا القسم.

إذا كان لديك كابل USB آخر:

1. عليك توصيل الجهاز باستخدام الكابل الثانوي.
2. تحقَّق مما إذا كان بإمكان "مساعد الاتصال" الآن اكتشاف الجهاز.
3. إذا لم يتم رصد الجهاز، جرِّب استخدام الكابل الأساسي مرة أخرى.
4. إذا لم يتم رصد الجهاز حتى الآن، لِنفترض أنّ المشكلة متعلقة بالجهاز وتحقّق مما إذا كان الجهاز في مرحلة التطوير كما هو موضّح في القسم التالي.

إذا لم يكن لديك كابل USB آخر ولكن لديك جهاز Android آخر:

1. وصِّل الجهاز الثانوي بجهاز الكمبيوتر.

2. إذا تمكّن "مساعِد الربط" من رصد الجهاز الثانوي، افترض أنّه توجد مشكلة في الجهاز الأساسي، وتحقَّق مما إذا كان الجهاز مُعدًّا للتطوير.

   إذا لم يتم رصد الجهاز الثانوي، قد تكون المشكلة في كابل USB.

التحقّق مما إذا كان الجهاز قد تم إعداده للتطوير

للتحقّق مما إذا كانت المشكلة ناتجة عن الإعدادات على الجهاز، اتّبِع الخطوات التالية:

1. اتّبِع الخطوات الواردة في القسم إعداد جهاز للتطوير.
2. إذا لم يؤدّ ذلك إلى حلّ المشكلة، يُرجى التواصل مع فريق دعم عملاء المصنّع الأصلي للجهاز للحصول على المساعدة. أطلِع ممثّل دعم العملاء على أنّه لا يمكن توصيل الجهاز بـ "استوديو Android" باستخدام ADB.

حلّ مشاكل الاتصال اللاسلكي

إذا كنت تواجه مشاكل في الاتصال بجهازك لاسلكيًا، يمكنك تجربة الخطوات التالية لتحديد المشاكل وحلّها:

التحقق مما إذا كانت محطة العمل والجهاز يلبيان المتطلبات الأساسية

لاستيفاء المتطلبات الأساسية لتصحيح الأخطاء اللاسلكي، تأكَّد مما يلي:

• يجب أن تكون محطة العمل والجهاز متصلَين بالشبكة اللاسلكية نفسها.
• أن يعمل جهازك بالإصدار 11 من نظام التشغيل Android أو إصدار أحدث لمزيد من المعلومات، يُرجى الاطّلاع على مقالة التحقّق من إصدار Android على جهازك وتحديثه.
• لديك أحدث إصدار من "استوديو Android". يمكنك تنزيله من صفحة Android Studio الرئيسية.
• توفُّر أحدث إصدار من أدوات منصّة حزمة تطوير البرامج (SDK) على محطة العمل

التحقّق من المشاكل الأخرى المعروفة

في ما يلي قائمة بالمشاكل المعروفة حاليًا في تصحيح الأخطاء اللاسلكي في IDE Android Studio وكيفية حلّها:

• تعذُّر الاتصال بشبكة Wi-Fi: قد تحظر بعض شبكات Wi-Fi، مثل الشبكات المخصّصة للشركات، اتصالات p2p ولا تسمح لك بالاتصال عبر Wi-Fi. جرِّب الاتصال باستخدام كابل أو شبكة Wi-Fi أخرى.
• إيقاف ADB عبر Wi-Fi تلقائيًا في بعض الأحيان: يمكن أن يحدث ذلك إذا كان الجهاز يبدّل شبكات Wi-Fi أو يقطع الاتصال بالشبكة.

مفتاح أمان RSA

عند توصيل جهاز يعمل بالإصدار 4.2.2 من نظام التشغيل Android (المستوى 17 لواجهة برمجة التطبيقات) أو إصدار أحدث بجهاز الكمبيوتر، يعرض النظام مربّع حوار يسألك ما إذا كنت تريد قبول مفتاح RSA الذي يسمح بإجراء تصحيح الأخطاء من خلال هذا الكمبيوتر. تحمي آلية الأمان هذه أجهزة المستخدمين لأنّه لا يمكن تنفيذ debugging (تصحيح أخطاء) USB وأوامر adb الأخرى ما لم تتمكّن من فتح قفل الجهاز والموافقة على مربّع الحوار.