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

اختبِر تطبيق 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. تأكَّد من أنّ جهازك يعمل بنظام التشغيل Android 11 أو إصدار أحدث. لمزيد من المعلومات، المعلومات، فراجع عمليات التحقق تحديث Android الإصدار.
3. تأكَّد من تثبيت أحدث إصدار من "استوديو Android". يمكنك تنزيله من هنا.
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. استوديو YouTube. من خلال بث محتوى شاشة جهازك مباشرةً إلى "استوديو Android"، يمكنك: استخدام بيئة التطوير المتكاملة في "استوديو YouTube" نفسها لتنفيذ الإجراءات الشائعة، مثل بدء تشغيل التطبيقات والتفاعل معها، وتدوير الشاشة، وطي الهاتف وفتحه، وتغيير مستوى الصوت.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. افتح مدير الأجهزة.
2. أنشئ جهاز افتراضي جديدًا إذا لم يكن لديك جهاز.
3. شغِّل المحاكي باستخدام جهاز AVD.
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) على محطة العمل.

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

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

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

مفتاح أمان RSA

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