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

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

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

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

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

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

   ملاحظة: إذا لم يظهر لك خيارات المطوّرين، اتّبِع التعليمات لتفعيل خيارات المطوّرين.

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

   • ChromeOS: لا يلزم إجراء أي إعدادات إضافية.
   • macOS: لا يلزم إجراء أي إعدادات إضافية.
   • نظام التشغيل Windows: ثبِّت برنامج تشغيل USB لأداة تصحيح أخطاء Android (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، الإصدار 2.0 من ميزة "تصحيح أخطاء adb عبر شبكة Wi-Fi" الذي يحلّ العديد من مشاكل قابلية الاستخدام في الإصدار السابق. والجدير بالذكر أنّ الجهاز سيتصل تلقائيًا بمحطة العمل عند اتصاله بشبكة موثوق بها لتصحيح الأخطاء لاسلكيًا.

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

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

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

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

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

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

   

   الشكل 1. طلب تصحيح الأخطاء لاسلكيًا على هاتف Google Pixel

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

   

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

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

   

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

   
   

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 Studio. من خلال بث شاشة جهازك مباشرةً إلى "استوديو Android"، يمكنك استخدام بيئة التطوير المتكاملة (IDE) في "استوديو Android" لتنفيذ الإجراءات الشائعة، مثل بدء التطبيقات والتفاعل معها وتدوير الشاشة وطي الهاتف وفتحه وتغيير مستوى الصوت.

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

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

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

عند استخدام ميزة "النسخ المطابق للجهاز"، يمكنك إعادة توجيه الصوت من الأجهزة المادية المتصلة إلى مكبّرات صوت الكمبيوتر أو سمّاعات الرأس. باستخدام ميزة إعادة توجيه الصوت، يمكنك إبقاء سماعات الرأس متصلة بالكمبيوتر والاستماع إلى الصوت من الكمبيوتر والهاتف المتصل بدون الحاجة إلى إعادة الاتصال يدويًا بجهاز تلو الآخر. لتفعيل ميزة إعادة توجيه الصوت، انتقِل إلى ملف (File) (استوديو Android (Android Studio) على نظام التشغيل macOS) > الإعدادات (Settings) > الأدوات (Tools) > ميزة "عرض الجهاز على شاشة أخرى" (Device Mirroring)، ثم انقر على إعادة توجيه الصوت من الأجهزة المحلية (Redirect audio from local devices). يُرجى العِلم أنّه تتم إعادة توجيه الصوت دائمًا، بغض النظر عن الإعدادات، لأجهزة Firebase Test Lab التي تعمل بالإصدار 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.

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

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

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

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

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

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

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

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

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

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

في حال توفّر كابل USB آخر:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مفتاح أمان RSA

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