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

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

ملاحظة: استخدِم محاكي Android لاختبار تطبيقك على إصدارات مختلفة من منصة Android وأحجام شاشات مختلفة. ننصحك باستخدام مختبر Firebase الافتراضي لتشغيل تطبيقك على مجموعة كبيرة من الأجهزة الحقيقية المستضافة في بنية تحتية مستندة إلى السحابة الإلكترونية.

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

قبل البدء في تصحيح الأخطاء على جهازك، حدِّد ما إذا كنت تريد الاتصال بالجهاز باستخدام كابل 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" لـ إنشاء تطبيقك وتشغيله على الجهاز.

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

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

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

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

يقدّم الإصدار 17 من Android، بالإضافة إلى adb 37.0.0، الإصدار adb Wi-Fi 2.0 الذي يحلّ العديد من مشاكل سهولة الاستخدام في الإصدار السابق. على وجه الخصوص، سيتصل الجهاز تلقائيًا بمحطة العمل عندما يتصل بشبكة موثوق بها لتصحيح الأخطاء لاسلكيًا.

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

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

لإقران جهازك، اتّبِع الخطوات التالية:

ملاحظة: عليك إقران جهازك بمحطة العمل مرة واحدة فقط. سيظل الجهاز مقترنًا بمحطة العمل إلى أن تنساه بشكلٍ صريح أو تبطل أذونات تصحيح الأخطاء عبر adb على جهازك. سيتصل الجهاز ومحطة العمل تلقائيًا عندما يكونان على الشبكة نفسها.

1. فعِّل خيارات المطوّرين على جهازك.

2. على جهازك، انقر على تصحيح الأخطاء لاسلكيًا.

   

   الشكل 1. النافذة المنبثقة تصحيح الأخطاء لاسلكيًا على هاتف Google Pixel.

3. اسمح بتصحيح الأخطاء لاسلكيًا على شبكتك. يُرجى العِلم أنّ النقر على مربّع الاختيار السماح دائمًا على هذه الشبكة يجعل الشبكة شبكة موثوق بها لتصحيح الأخطاء لاسلكيًا. سيسمح جهازك دائمًا بتصحيح الأخطاء لاسلكيًا على هذه الشبكة فور اتصال الجهاز بالشبكة.

   

   الشكل 2. إعداد تصحيح الأخطاء لاسلكيًا على هاتف Google Pixel phone.

4. افتح "استوديو Android" وانقر على إقران الأجهزة باستخدام Wi-Fi من قائمة إعدادات التشغيل.

   

   الشكل 3. قائمة إعدادات التشغيل menu.

   
   

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

   

   الشكل 4. مربّع حوار لإقران الأجهزة عبر Wi-Fi.

   بدلاً من ذلك، يمكنك إقران الجهاز من أداة إدارة الأجهزة. على سبيل المثال، My Pixel

   

   الشكل 5. أداة إدارة الأجهزة مع جهاز متاح للإقران عبر Wi-Fi.

   
   

6. انقر على Pair على الجهاز الذي تريد إقرانه. يظهر مربّع حوار إقران الجهاز.

   1. لإقران جهازك باستخدام رمز استجابة سريعة، انقر على إقران الجهاز باستخدام رمز الاستجابة السريعة وامسح رمز الاستجابة السريعة ضوئيًا.

      

      الشكل 6. مربّع حوار لإقران الجهاز باستخدام رمز الاستجابة السريعة.

   2. لإقران جهازك باستخدام رمز الإقران، انقر على إقران الجهاز باستخدام رمز الإقران من مربّع الحوار إقران أجهزة جديدة عبر Wi-Fi. على جهازك، انقر على الإقران باستخدام رمز الإقران. يظهر رمز مكوّن من ستة أرقام. بعد ظهور جهازك في النافذة إقران الأجهزة عبر Wi-Fi ، أدخِل الرمز المكوّن من ستة أرقام المعروض على جهازك وانقر على إقران .

      

      الشكل 7. مثال على إدخال رمز الإقران المكوّن من ستة أرقام.

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

لإلغاء إقران محطة العمل، انتقِل إلى تصحيح الأخطاء لاسلكيًا على جهازك. انقر على اسم محطة العمل ضِمن الأجهزة المقترنة وانقر على حذف. بدلاً من ذلك، يمكنك النقر على إبطال أذونات تصحيح الأخطاء عبر adb في صفحة "الإعدادات" على جهازك لإلغاء إقران محطة العمل وجميع محطات العمل الأخرى التي تم إقرانها سابقًا.

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

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

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

ملاحظة: إذا كنت تستخدم أجهزة معيّنة، مثل Xiaomi Redmi K40 أو Poco F3 أو Mi 11X، مع الإصدار 12 من Android، عليك تفعيل إعدادَي تصحيح أخطاء الجهاز عبر USB و تصحيح أخطاء الجهاز عبر USB (إعدادات الأمان) ثم إعادة تشغيل الجهاز لتفعيل ميزة "النسخ المطابق للجهاز".

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

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

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

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

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" تلقائيًا عملية "النسخ المطابق للجهاز" لأي جهاز متصل وجهاز مقترِن. قد يؤدي ذلك إلى الكشف عن معلومات للأجهزة المتصلة باستخدام الأمر adb tcpip لأنّه يتم تمرير معلومات وأوامر النسخ المطابق عبر قناة غير مشفّرة. بالإضافة إلى ذلك، يستخدم "استوديو Android" قناة غير مشفّرة للتواصل مع خادم adb، لذا يمكن للمستخدمين الآخرين على جهازك المضيف اعتراض معلومات النسخ المطابق.

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

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

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

يقدّم "مساعد الاتصال" تعليمات مفصّلة لمساعدتك في إعداد جهاز واستخدامه من خلال اتصال ADB.

لبدء تشغيل "المساعد"، انقر على الأدوات > تحديد مشاكل اتصالات الجهاز وحلّها.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تأكَّد من أنّ محطة العمل والجهاز يستوفيان المتطلبات الأساسية .

الاطّلاع على دليل تحديد المشاكل وحلّها في adb

اتّبِع دليل تحديد المشاكل وحلّها في adb guide.

مفتاح الأمان RSA

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