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

احرص دائمًا على اختبار تطبيق 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" لإنشاء تطبيقك وتشغيله على الجهاز.

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

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

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

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

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

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

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

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

   

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

   

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

   

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

      

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

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

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

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

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

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

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

عند استخدام النسخ المطابق للجهاز، يمكنك إعادة توجيه الصوت من الأجهزة المادية المتصلة إلى مكبّرات الصوت أو سماعات الكمبيوتر في جهاز الكمبيوتر. فباستخدام ميزة إعادة توجيه الصوت، أبقِ سماعات الرأس متصلة بجهاز الكمبيوتر واستمع إلى كل من الكمبيوتر والهاتف المتصل بدون الحاجة إلى إعادة الاتصال يدويًا بجهاز ثم آخر. لتفعيل إعادة توجيه الصوت، انتقِل إلى File (ملف) (Android Studio على نظام التشغيل macOS) > الإعدادات > الأدوات > المزامنة على الجهاز وفي السحابة الإلكترونية واختَر إعادة توجيه الصوت من الأجهزة المحلية. يُرجى العِلم أنّه تتم دائمًا إعادة توجيه الصوت، بغض النظر عن الإعدادات، لأجهزة 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. استخدِم زرَّي التالي والسابق في أسفل لوحة مساعد Google للعمل على مراجعة الصفحات حسب الحاجة:

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

حلّ مشاكل اتصال USB

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

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

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

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

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

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

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

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

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

1. عليك ربط الجهاز الثانوي بجهاز الكمبيوتر.

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

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

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

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

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

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

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

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

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

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

البحث عن المشاكل المعروفة الأخرى

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

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

مفتاح أمان RSA

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