اختبار تطبيق Android دائمًا على جهاز حقيقي قبل إطلاقه للمستخدمين. وتصف هذه الصفحة كيفية إعداد بيئة التطوير وجهاز Android للاختبار وتصحيح الأخطاء عبر اتصال Android Debug Bridge (ADB).
إعداد جهاز للتطوير
قبل أن تتمكّن من بدء تصحيح الأخطاء على جهازك، حدِّد ما إذا كنت تريد ربط إلى الجهاز باستخدام كابل USB أو شبكة Wi-Fi. بعد ذلك، يُرجى اتِّباع ما يلي:
افتح تطبيق الإعدادات على الجهاز واختَر خيارات المطوّرين. ثم فعِّل تصحيح أخطاء الجهاز عبر USB (إن أمكن).
يمكنك إعداد النظام لاكتشاف جهازك.
- نظام التشغيل 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
- يجب أن يكون كل مستخدم يريد استخدام ADB ضمن مجموعة
الاتصال بجهازك باستخدام USB
عند إعداد الجهاز وتوصيله بمنفذ USB، انقر على تشغيل.
في "استوديو Android"
أنشئ تطبيقك وشغِّله على الجهاز.
يمكنك أيضًا استخدام adb
لإصدار الطلبات
على النحو التالي:
- من خلال تنفيذ الأمر
adb devices
تأكَّد من أنّ جهازك متصل. من دليلandroid_sdk/platform-tools/
في حال حذف متصل، سيظهر لك الجهاز مدرجًا. - أصدر أي أمر
adb
في علامة-d
لاستهداف جهازك.
الاتصال بجهازك باستخدام Wi-Fi
يتيح نظام التشغيل Android 11 والإصدارات الأحدث نشر تطبيقك وتصحيح الأخطاء فيه لاسلكيًا. من محطة العمل عبر Android Debug Bridge (ADB). على سبيل المثال، يمكنك نشر تطبيقك الذي يمكن تصحيح الأخطاء فيه على أجهزة بعيدة متعددة بدون إجراء عمليات فعلية توصيل جهازك عبر USB والمشكلات الشائعة في اتصال USB، مثل تثبيت برنامج تشغيل.
لاستخدام ميزة "تصحيح الأخطاء اللاسلكي"، عليك إقران جهازك بمحطة العمل. باستخدام رمز إقران. للبدء، أكمِل الخطوات التالية:
- تأكَّد من اتصال محطة العمل والجهاز بالشبكة اللاسلكي نفسها. الشبكة.
- تأكَّد من أنّ جهازك يعمل بالإصدار 11 من نظام التشغيل Android أو بإصدار أحدث. لمزيد من المعلومات، المعلومات، فراجع عمليات التحقق تحديث Android الإصدار.
- تأكَّد من تثبيت أحدث إصدار من "استوديو Android". التنزيل من هنا
- في محطة العمل، يمكنك التحديث إلى أحدث إصدار من أدوات النظام الأساسي لحزمة تطوير البرامج (SDK):
للاتصال بجهازك، اتبع الخطوات التالية:
- افتح "استوديو Android" واختَر إقران الأجهزة باستخدام Wi-Fi من عملية التشغيل.
قائمة الإعدادات.
الشكل 1. تنفيذ الإعدادات القائمة.
الشكل 2. مربّع حوار للإقران الأجهزة التي تستخدم رمز الاستجابة السريعة أو رمز الإقران - تفعيل مطوّر البرامج الخيارات على جهازك.
- تمكين تصحيح الأخطاء خلال
شبكة Wi-Fi
على جهازك.
الشكل 3. تشير رسالة الأشكال البيانية إعداد تصحيح الأخطاء اللاسلكي على هاتف Google Pixel - انقر على تصحيح الأخطاء اللاسلكي وإقران جهازك:
- لإقران جهازك باستخدام رمز استجابة سريعة، انقر على إقران الجهاز باستخدام رمز استجابة سريعة. وامسح ضوئيًا رمز الاستجابة السريعة كما هو موضَّح في الشكل 2.
- لإقران جهازك باستخدام رمز إقران، اختَر إقران الجهاز مع
رمز الإقران من مربّع الحوار إقران الأجهزة الجديدة عبر شبكة Wi-Fi. على
جهاز، اختَر الإقران باستخدام رمز الإقران. رقم مؤلف من ستة أرقام
الرمز. بعد ظهور جهازك على
نافذة إقران الأجهزة عبر شبكة Wi-Fi، أدخِل الرقم المكوَّن من ستة أرقام.
الرمز المعروض على جهازك واختر إقران .
الشكل 4. مثال على ستة أرقام إدخال رمز الإقران
- بعد الإقران، يمكنك محاولة نشر تطبيقك على جهازك.
لإقران جهاز مختلف أو حذف بيانات هذا الجهاز على محطة العمل:
- انتقِل إلى تصحيح الأخطاء اللاسلكي على جهازك.
- انقر على اسم محطة العمل ضمن الأجهزة المقترنة.
- انقر على حذف.
النسخ المطابق للجهاز
يمكنك عكس شاشة جهازك الفعلي في نافذة الأجهزة قيد التشغيل في نظام 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" تلقائيًا
النسخ المطابق للجهاز لأي جهاز متصل أو مقترن. قد يؤدي هذا إلى
بيان الإفصاح عن المعلومات للأجهزة المرتبطة بالأمر adb tcpip
لأن معلومات النسخ المطابق والأوامر يتم تمريرها إلى ملفات غير مشفرة
. بالإضافة إلى ذلك، يستخدم "استوديو Android" قناة غير مشفّرة للتواصل
مع خادم adb، حتى يمكن اعتراض النسخ المطابق للمعلومات من قبل المستخدمين الآخرين
على جهازك المضيف.
تحديد مشاكل الاتصال بالأجهزة وحلّها
إذا لم يكن جهازك متصلاً بـ "استوديو Android"، جرِّب الخطوات التالية: لحل المشكلة:
تحديد المشاكل وحلّها باستخدام "مساعد الربط"
يوفّر "مساعد الربط" تعليمات مفصّلة لمساعدتك في إعداد الميزة. أحد الأجهزة واستخدامها من خلال اتصال ADB.
لبدء تشغيل المساعد، اختر الأدوات > تحديد مشاكل اتصالات الأجهزة وحلّها
يوفّر "مساعد الربط" تعليمات وعناصر تحكّم ضمن السياق وقائمة. من الأجهزة المتصلة في سلسلة من الصفحات في لوحة مساعد Google. يمكنك استخدام زرَّي التالي والسابق في أسفل لوحة مساعد Google من أجل في الصفحات حسب الحاجة:
- توصيل جهازك عبر USB: طلباتك الأولى في "مساعد الاتصال" توصيل جهازك عبر USB وتوفير إعادة فحص أجهزة USB يمكنك من خلاله بدء فحص جديد للأجهزة المتصلة.
- تفعيل تصحيح أخطاء الجهاز عبر USB: سيطلب منك "مساعد الاتصال" بعد ذلك إرشادات تفعيل تصحيح أخطاء USB ضمن خيارات المطوّرين على الجهاز.
- إعادة تشغيل خادم ADB: إذا كنت لا تزال لا ترى جهازك على بالأجهزة المتاحة، يمكنك استخدام الزر إعادة تشغيل خادم ADB في الصفحة الأخيرة من مساعد الاتصال. تؤدي إعادة تشغيل خادم ADB أيضًا إلى حدوث ADB للبحث عن الأجهزة مرة أخرى. إذا لم يظهر جهازك في القائمة بعد ذلك للأجهزة المتوفرة، جرِّب خطوات تحديد المشاكل وحلّها في القسم التالي.
حلّ مشاكل اتصال USB
إذا لم يرصد "مساعد الاتصال" جهازك عبر USB، جرِّب الخطوات التالية لتحديد المشاكل وحلّها:
التأكّد من اتصال "استوديو Android" بمحاكي Android
للتحقق مما إذا كانت المشكلة ناجمة عن مشكلة في الاتصال بين نظام التشغيل Android "استوديو YouTube" ومحاكي Android، اتّبِع الخطوات التالية:
- افتح مدير الجهاز.
- إنشاء متوسّط مدة مشاهدة جديدة إذا لم يسبق لك ذلك تمتلك واحدًا.
- ويمكنك تشغيل المحاكي باستخدام متوسّط مدة المشاهدة.
- نفِّذ أيًّا ممّا يلي:
- في حال تعذّر ربط "استوديو Android" بالمحاكي، يمكنك تنزيل أحدث إصدار منه. أدوات النظام الأساسي لحزمة تطوير البرامج (SDK) ثم أعِد المحاولة.
- إذا بدأ المحاكي بنجاح، تحقق من كابل USB كما هو موضح في القسم التالي.
التحقّق من كابل USB
للتحقق مما إذا كان سبب المشكلة عيب في كابل USB، اتبع الخطوات الواردة في هذا القسم.
في حال توفُّر كابل USB آخر:
- عليك توصيل الجهاز باستخدام الكابل الثانوي.
- تحقَّق مما إذا كان بإمكان "مساعد الاتصال" الآن اكتشاف الجهاز.
- إذا لم يتم رصد الجهاز، جرِّب استخدام الكابل الأساسي مرة أخرى.
- إذا لم يتم اكتشاف الجهاز إلى الآن، فيُفترض أن تكون المشكلة في جهاز، التحقّق مما إذا كان الجهاز في مرحلة التطوير كما هو موضح في القسم التالي.
إذا لم يكن لديك كابل USB آخر ولكن لديك جهاز Android آخر:
- عليك ربط الجهاز الثانوي بجهاز الكمبيوتر.
إذا كان بإمكان "مساعد الاتصال" رصد الجهاز الثانوي، على افتراض أنّ مشكلة في الجهاز الأساسي، التحقّق مما إذا كان الجهاز في مرحلة التطوير
إذا لم يتم رصد الجهاز الثانوي، قد تكون المشكلة في USB. الكابل.
التحقّق مما إذا كان الجهاز في مرحلة التطوير
للتحقق مما إذا كانت المشكلة ناتجة عن الإعدادات على الجهاز أم لا، اتبع الخطوات التالية الخطوات:
- اتّبِع الخطوات الواردة في مقالة إعداد جهاز لتطوير البرامج. .
- إذا لم يؤدِّ ذلك إلى حلّ المشكلة، يُرجى التواصل مع المصنّع الأصلي للجهاز دعم العملاء للحصول على المساعدة. أخبر ممثل دعم العملاء أن لا يتصل جهازك بـ "استوديو Android" باستخدام ADB.
حل مشاكل الاتصال اللاسلكي
إذا كنت تواجه مشاكل في الاتصال بجهازك لاسلكيًا، يمكنك تجربة الخطوات التالية لتحديد المشاكل وحلّها:
التحقق مما إذا كانت محطة العمل والجهاز يلبيان المتطلبات الأساسية
لاستيفاء المتطلّبات الأساسية لميزة "تصحيح الأخطاء اللاسلكي"، تأكَّد مما يلي:
- توصيل محطة العمل والجهاز بالشبكة اللاسلكية نفسها.
- يعمل جهازك بنظام التشغيل Android 11 أو إصدار أحدث. لمزيد من المعلومات، يُرجى مراجعة التحقق من تحديث Android الإصدار.
- لديك أحدث إصدار من "استوديو Android". يمكنك تنزيل من صفحة "استوديو Android" الرئيسية
- تم تثبيت أحدث إصدار من أدوات النظام الأساسي لحزمة تطوير البرامج (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
يسمح بتصحيح الأخطاء من خلال هذا الكمبيوتر. تحمي آلية الأمان هذه المستخدم
الأجهزة لأنّه لا يمكن تصحيح أخطاء USB وأوامر adb
الأخرى
ما لم تتمكن من فتح قفل الجهاز والموافقة على مربّع الحوار.