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

احرص دائمًا على اختبار تطبيق 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"، جرِّب الخطوات التالية لحل المشكلة:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • اتصال 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 الأخرى ما لم تتمكن من فتح قفل الجهاز والتعرف على مربّع الحوار.