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

اختبر تطبيق 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 Platform.

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

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

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

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

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

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

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

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

واجهة مستخدم الأجهزة قيد التشغيل

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

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

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. استخدم زرَّي Next (التالي) وPrevious (السابق) في أسفل لوحة مساعد Google للتنقّل في الصفحات حسب الحاجة:

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

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

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

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

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

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

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

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

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

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

إذا لم يكن لديك كابل USB آخر ولكن لديك جهاز Android آخر، اتّبِع الخطوات التالية:

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

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

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

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

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

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

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

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

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

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

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

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

مفتاح أمان RSA

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