OmniLab ATS هي أداة اختبار يمكن لمطوّري برامج Android ومهندسي الاختبار استخدامها لاستخدام واجهة مستخدم لتشغيل مجموعات اختبار Android العادية، مثل مجموعة اختبار التوافق مع Android (CTS) هذه الأداة وتعمل كواجهة ويب لمختلف أطر الاختبار، مثل الاتحاد التجاري (TF) Google Mobly، الذي يتيح لك تشغيل CTS إجراء اختبارات متعدّدة الأجهزة على مجموعة من الأجهزة الاختبارية بأقلّ قدر من الإعداد، بالإضافة إلى وضع جدول زمني لإجراء الاختبارات باستمرار.
ضبط إعدادات OmniLab ATS
يشرح هذا القسم كيفية تثبيت OmniLab ATS وإعداده.
يستخدم OmniLab ATS رمز المصدر من المواقع الجغرافية التالية:
- نظام إدارة التسويق الشامل (ATS) لتطبيق OmniLab رمز المصدر
- رمز المصدر TradeFed Cluster
تثبيت OmniLab ATS
اتّبِع أي متطلبات للأجهزة والبرامج الخاصة بمجموعات الاختبارات التي تجريها.
يمكن العثور على متطلبات CTS على source.android.com.
ما مِن متطلبات إضافية للأجهزة لاستخدام OmniLab ATS، ولكنّنا ننصحك باستخدام متطلبات مضيف CTS كنقطة بداية.
هناك طريقتان لتثبيت OmniLab ATS:
- شغِّل برنامج أداة التثبيت.
- تثبيته يدويًا، وهو ما يتطلب تثبيت عدة تطبيقات البرامج والموارد.
التثبيت باستخدام برنامج التثبيت
في الإصدار Ubuntu 20.04 أو الإصدارات الأحدث، يقوم برنامج التثبيت بتثبيت جميع البرامج وإعدادها والموارد اللازمة لتشغيل نظام OmniLab ATS.
لاستخدام برنامج التثبيت:
شغِّل برنامج أداة التثبيت:
curl https://storage.googleapis.com/android-mtt.appspot.com/prod/install.sh | bash
شغِّل
mtt versionللتحقّق من الإصدار المثبّت من OmniLab ATS CLI.
التثبيت يدويًّا
تثبيت Docker
اتّبِع تعليمات تثبيت Docker Community Edition (CE) على جهازك الذي يعمل بنظام التشغيل Linux.
قد تحتاج إلى إعادة تشغيل نافذة المحطة الطرفية أو تسجيل الخروج ثم تسجيل الدخول مرة أخرى. لتدخل تغييرات الأذونات إلى حيز التنفيذ.
تثبيت Python 3
يتم التحقق من واجهة برمجة التطبيقات OmniLab ATS CLI وفقًا للإصدارات 3.7 إلى 3.11 من Python.
في نظام التشغيل Ubuntu 16.04 أو الإصدارات الأقدم، أضِف أولاً مستودع Python 3 من خلال تنفيذ أحدها ما يلي:
نفِّذ الأمر التالي:
sudo add-apt-repository ppa:deadsnakes/ppa
أنشئ المستودع وثبِّته من المصدر.
لتثبيت بايثون 3، شغّل الأوامر التالية:
sudo apt-get updatesudo apt install python3 python3-distutils
لتثبيت إصدار محدّد من Python 3 (على سبيل المثال، 3.10)، نفِّذ هذه الأوامر بدلاً من ذلك:
sudo apt-get updatesudo apt install python3.10 python3.10-distutils
الحصول على واجهة سطر الأوامر بنظام OmniLab ATS
يمكنك تنزيل حزمة واجهة سطر الأوامر (CLI) من هنا.
بدء OmniLab ATS
ابدأ OmniLab ATS باستخدام الأمر التالي:
mtt start
قد يستغرق ظهور واجهة المستخدم بضع دقائق عند بدء تشغيل الواجهة لأول مرة. واجهة سطر الأوامر
عرض عنوان URL للويب للوصول إلى واجهة المستخدم في المتصفح. يكون عنوان URL للويب تلقائيًا هو
localhost:8000. إذا لزم الأمر، يمكنك تغيير المنفذ الافتراضي عند بدء التشغيل من خلال
العلامة --port.
في حال توفّر إصدار أحدث، يمكنك التحديث إلى الإصدار الحالي. يمكنك راجِع ملاحظات الإصدار لأحدث الإصدارات.
للتحديث إلى الإصدار الحالي، شغِّل:
mtt start --force_update
لإيقاف التطبيق، شغِّل:
mtt stop
لعرض قائمة بالطلبات الأخرى، استخدِم:
mtt --help
الاحتفاظ بنسخة احتياطية من قاعدة البيانات واستعادتها
لعمل نسخة احتياطية من قاعدة بيانات OmniLab ATS، أوقِف التطبيق ونفِّذ الأمر التالي،
الذي يُنشئ نسخة احتياطية من قاعدة البيانات الحالية في ملف TAR باسم mtt-backup.tar في
الدليل الرئيسي:
docker run --rm --mount source=mtt-data,target=/data -v ~:/out ubuntu bash -c "cd /data && tar cvf /out/mtt-backup.tar ."
لاستعادة البيانات، شغِّل الأمر التالي قبل بدء تشغيل التطبيق:
docker run --rm --mount source=mtt-data,target=/data -v ~:/out ubuntu bash -c "cd /data && tar xvf /out/mtt-backup.tar"
معالج الإعداد
بعد تثبيت وتشغيل OmniLab ATS للمرة الأولى، يستغرق "معالج الإعداد" عبر بعض الخطوات لمساعدتك في تخصيص الأداة لبيئتك أي تقييم يمكن إعادة ضبط التغييرات التي تجريها هنا لاحقًا من خلال صفحة "الإعدادات".
استعادة نسخة احتياطية للإعدادات
إذا كان لديك ملف إعدادات تم الاحتفاظ بنسخة احتياطية منه من مضيف OmniLab ATS آخر، يمكنك تحميل الملف لنسخ أي إعدادات تم تعديلها من ذلك المضيف من خلال النقر على الزر تحميل ملف.
الشكل 1. استعادة نسخة احتياطية من الإعدادات
ضبط حساب الخدمة التلقائي
يمكنك إعداد حساب خدمة. التي يستخدمها OmniLab ATS تلقائيًا عند الوصول إلى الموارد (على سبيل المثال، Google Cloud Storage وGoogle Drive). لمصادقة حساب الخدمة، انقر على تحميل مفتاح حساب الخدمة واختيار ملف مفتاح JSON لحساب الخدمة
الشكل 2: جارٍ إعداد حساب الخدمة.
عندما تتم مصادقة حساب الخدمة بنجاح، يصبح البريد الإلكتروني للحساب في الجانب العلوي الأيسر من الصفحة. لتغيير الخدمة ثم انقر على اسم الحساب، وأزِل الحساب الافتراضي الحالي، وحمّل مفتاح حساب خدمة جديد.
الشكل 3. تغيير حساب الخدمة
استيراد مجموعات الضبط
مجموعة الضبط هي حزمة من الإعدادات لتشغيل مجموعات الاختبار، بما في ذلك التطبيقات ذات الصلة إجراءات الجهاز وإنشاء قنوات. تتم استضافة مجموعات الضبط في مجموعة محدّدة من حسابات Google. حزمة Cloud Storage (GCS). بعد مصادقة فريق GCS، يمكنك إنشاء قناة باستخدام حساب Google، ستظهر لك قائمة بجميع مجموعات الإعدادات المتاحة لك.
حدد أي مجموعات تكوين ترغب في إضافتها إلى مضيف محطة الاختبار وانقر على استيراد محدّد.
الشكل 4. استيراد مجموعة ضبط.
تضمين إعدادات Wi-Fi
تتطلّب بعض اختبارات CTS أن يكون جهازك متصلاً بنقطة اتصال Wi-Fi. لاختيار شبكة Wi-Fi، أدخِل WiFi SSID وانقر على WiFi PSK الاختياري.
الشكل 5. إعدادات نقطة اتصال Wi-Fi.
بعد إكمال "معالج الإعداد"، تتم إعادة تحميل الصفحة باستخدام الإعدادات الجديدة. المنهجية.
ربط جهاز
يجب تفعيل خيار "تصحيح أخطاء الجهاز عبر USB" لاستخدام جهاز للاختبار. لتفعيل تصحيح الأخطاء:
اتّبِع التعليمات الواردة في تمكين خيارات المطورين تصحيح الأخطاء.
إذا كنت تخطط لاستخدام إصدار Android تجريبي محمل مسبقًا بمفاتيح ADB مخصصة، ضع ملفات
.adb_keyالمخصصة ضمن الدليل~/.android/.يتم تحميل الملفات تلقائيًا وتمريرها إلى ADB لتفعيل USB تلقائيًا. تصحيح الأخطاء بعد وميض الجهاز للأجهزة التي تعمل بهذه الإصدارات.
وصِّل الجهاز بالجهاز المضيف باستخدام USB.
يظهر الجهاز في علامة التبويب "أجهزة OmniLab ATS" في غضون دقيقة واحدة وتحديث واجهة الويب. يمكنك أيضًا الاطّلاع على حالة الأجهزة في هذه علامة التبويب.
الشكل 6: جارٍ توصيل جهاز.
حالات الجهاز المختلفة هي:
- متاح: الجهاز متصل وجاهز لإجراء اختبار.
- مخصَّصة: الجهاز متصل ويجري اختبارًا. على كل الجهاز إجراء اختبار واحد فقط في كل مرة، لذا يجب أن يُكمل الجهاز الاختبار الحالي قبل إجراء اختبار جديد.
إجراء اختبار
اختيار اختبار
تأتي أداة OmniLab ATS مع مجموعة من إعدادات CTS المجمّعة مسبقًا. لتشغيل أحد هذه الاختبارات، انتقِل إلى علامة التبويب "مجموعات الاختبار" وانقر على تشغيل الاختبار اختباره.
الشكل 7: اختيار الاختبار
لتعديل اختبارات جديدة أو إضافتها، يمكنك الاطّلاع على إضافة اختبارات.
ضبط إجراء الاختبار
عدِّل المَعلمات المطلوب استخدامها لإجراء الاختبار المحدّد هذا. معظم المعلمات تمت تعبئتها تلقائيًا بالقيم المحدّدة في إعدادات الاختبار المحدّدة.
يمكن إكمال هذه الخطوة باستخدام القيم التلقائية، ولكن يمكنك تغيير أيٍّ من المعلَمات، مثل Max Redirect وCommand لتناسب احتياجاتك.
الشكل 8. جارٍ ضبط إعدادات إجراء اختبار.
مَعلمات إجراء الاختبار هي:
- الاسم: اسم مجموعة الاختبار المُراد تشغيلها.
- عدد عمليات التشغيل: عدد مرّات تنفيذ هذا الاختبار مجدول. تتم جدولة عمليات تشغيل الاختبار باستخدام اتحاد تجاري يضم ما يصل إلى 20 شخصًا إجراء الاختبارات بالتوازي إذا كانت هناك قدرة على القيام بذلك.
- الحد الأقصى لإعادة المحاولة: الحد الأقصى لعدد مرات إعادة محاولة إجراء اختبار إذا كان مرة واحدة على الأقل فشل الاختبار. يتم ضبط ذلك عادةً من 4 إلى 6 عمليات إعادة محاولة لإكمال عملية اختبار CTS بشكل كامل. للتعامل مع الاختبارات غير المستقرة.
- مهلة قائمة الانتظار: إذا بقي الأمر في قائمة الانتظار لفترة طويلة جدًا، فسيتم إلغاءه تلقائيًا. حدد مقدار الوقت الذي يجب الانتظار قبله الإلغاء هنا. القيمة التلقائية هي 24 ساعة.
Command: الأمر لتشغيل مجموعة الاختبار يمكنك إدخال وسيطات سطر أوامر إضافية هنا. على سبيل المثال، يمكنك تشغيل وحدة معيّنة في الإصدار 8.1 من CTS. عبر:
cts-suite -m ShortModuleNameأمر إعادة المحاولة: الأمر الخاص بإعادة محاولة مجموعة تجريبية. يمكنك إضافة وسيطات سطر أوامر إضافية هنا. على سبيل المثال، لإعادة محاولة استخدام محددة في CTS 8.1، استخدم:
cts --retry 0 -m ShortModuleNameقد تختلف وسيطات إعادة المحاولة عن تلك المتاحة في الأمر الأولي، لذا تحقق من المعلمات المتوافقة على الموقع الرسمي للاختبار المحدد جناح.
إجراء الاختبار السابق: إذا أردت إعادة إجراء اختبار سابق:
محلي - إذا بدأ التشغيل على المضيف الحالي، أدخِل تشغيل الاختبار رقم التعريف الذي يظهر عند عرض تفاصيل إجراء الاختبار
الشكل 9. إجراء اختبار محلي سابق
عن بُعد: إذا بدأ التشغيل على مضيف مختلف، حمِّل الاختبار من خلال اختيار عن بُعد، والنقر على تحميل نتائج الاختبار ملف واختيار ملف من مساحة التخزين المحلية
الشكل 10. إجراء اختبار سابق عن بُعد
اختيار الأجهزة
انقر على مربّعات الاختيار لاختيار الأجهزة التي تريد تخصيصها لإجراء الاختبار. جناح. ينبغي أن يتغير عدد الأجزاء تلقائيًا ليتطابق مع عدد الأجهزة المحددة.
الشكل 11. جارٍ اختيار الأجهزة.
لاختيار الأجهزة حسب سمات أخرى غير السلاسل التسلسلية للأجهزة، يمكنك يدويًا أدخل "مواصفات الجهاز". على سبيل المثال، لاختيار 3 أجهزة يكون اسم منتجها "bramble"، أدخِل ما يلي:
product:bramble;product:bramble;product:bramble
في ما يلي السمات المتوافقة:
- معرّف_الإصدار
- رقم_الجهاز
- نوع_الجهاز
- اسم المضيف
- المنتج
- خيار_المنتج
- ولاية_sim
يجب أن تكون جميع الأجهزة المحدّدة بالحالة متاحة لتنفيذ الاختبار. ويتم تبديل جميع هذه التطبيقات إلى الحالة مخصَّصة عند تنفيذ الاختبار التجريبي. حاسمة أن يكون تشغيل الاختبار في حالة قائمة الانتظار أثناء انتظار أن تصبح الأجهزة المتوفرة.
إضافة إجراءات الجهاز
إجراءات الجهاز هي نصوص برمجية يمكن تنفيذها قبل كل عملية اختبار. بعض الإشعارات قد تمت تهيئة إجراءات الجهاز مسبقًا، مثل الفلاش وإعادة التشغيل. إلى إنشاء إجراءات جديدة على الجهاز، والاطّلاع على أنشئ إجراءً جديدًا على الجهاز.
الشكل 12: إجراءات الجهاز.
لإضافة إجراء جهاز إلى عملية اختبار، انقر على إضافة إجراء جديد، ثم اختَر مربّعات الاختيار للإجراءات التي ستتم إضافتها، ثم انقر على إضافة الإجراءات. إجراءات الجهاز يتم تنفيذها بشكل تسلسلي. يمكنك إعادة ترتيب الإجراءات عن طريق سحبها.
الشكل 13. إعادة ترتيب الإجراءات.
ضبط موارد الاختبار
موارد الاختبار هي ملفات مطلوبة لتنفيذ إجراء اختبار. على سبيل المثال، تشغيل
تتطلب CTS وجود ملف android-cts*.zip، ووميض جهاز يتطلب منك ما يلي:
تقديم صورة الإصدار.
يجب ضبط عنوان URL لتنزيل ملف ZIP لمجموعة الاختبار على Google Drive تلقائيًا. الروابط المقدمة للشركاء. يمكنك اختيار ملف مختلف من خلال النقر على التصفّح. في النافذة المنبثقة، يمكنك إدخال رابط تنزيل ملف، أو استخدام ملف من قناة إصدار تمت مصادقتها أو تحميل ملف لاستخدامه من مساحة التخزين المحلية.
الشكل 14. اختبار الموارد
في ما يلي النافذة المنبثقة لاختيار مورد اختبار من خلال عنوان URL على الويب. يمكنك إدخال رابط عنوان URL للتنزيل، والنقر على الزر اختيار لتأكيد الاختيار.
الشكل 15. أداة اختيار موارد الاختبار: عنوان URL على الويب
في حال تحميل موارد إلى Google Grive أو Google Cloud Storage (GCS) أو قنوات أخرى، يمكنك أيضًا الانتقال إلى علامة التبويب الخاصة بالقناة وتحديد والموارد هناك. فيما يلي مثال لاختيار مورد من google drive.
الشكل 16. اختبار أداة اختيار الموارد - Google Drive
بالإضافة إلى تحديد الملفات فقط، تتوفر أيضًا أحرف البدل في اسم الملف. يمكن العثور على الوثائق هنا.
الشكل 17. محدد موارد الاختبار - إتاحة نمط أحرف البدل
يمكنك أيضًا اختيار ملف من مساحة تخزين الملفات المحلية في OmniLab ATS. يمكنك تحميل من الملفات إلى مساحة التخزين هذه، أو واستخدام الملفات والأدلة على الجهاز مباشرةً
الشكل 18. أداة اختيار مورد الاختبار - مخزن الملفات المحلي
إضافة الإعدادات التي تمت إعادة تشغيلها
يمكنك جدولة عمليات إعادة تشغيل تبدأ بعد اكتمال عملية التشغيل الأساسية وتحميل نتائجها، ولكن يمكن أن تستخدم أجهزة أو إجراءات أو موارد مختلفة.
الشكل 19. جارٍ إضافة الإعدادات التي تمت إعادة تشغيلها.
بدء عملية اختبار
بعد إدخال المعلومات اللازمة لإجراء الاختبار، انقر على بدء الاختبار تشغيل. إذا كانت جميع المعلومات صالحة، يبدأ تشغيل الاختبار تتم إعادة توجيهه إلى الصفحة لعرض تفاصيل التنفيذ وإحراز تقدم في إجراء الاختبار.
الشكل 20: جارٍ بدء إجراء اختبار.
إنشاء خطة اختبار
تُستخدم خطط الاختبار لإنشاء عمليات اختبار وفقًا لجدول زمني دوري. على سبيل المثال، تشغيل CTS 9.0 كل يوم في الساعة 5 مساءً لإنشاء خطة اختبار جديدة، انقر على إنشاء خطة اختبار جديدة.
الشكل 21. إنشاء خطة اختبار.
إعداد خطة الاختبار
أدخِل اسم خطة الاختبار وأي تصنيفات تريد إضافتها. بعد ذلك، اختَر جدول زمني للاستخدام.
- يدوي: تنشئ خطة الاختبار عمليات تنفيذ اختبار فقط عندما ينقر المستخدم على الزر. تنفيذ خطة الاختبار في صفحة قائمة خطة الاختبار.
- دوري - تحدد خطة الاختبار تلقائيًا مواعيد إجراء الاختبارات في تحديد جدول دوري. على سبيل المثال، تؤدي جدولة تشغيل اختبار كل يوم في 5:00 مساءً.
- مخصَّص - تجدول خطة الاختبار بشكل تلقائي عمليات الاختبار استنادًا إلى
تم إدخال تعبير cron. على سبيل المثال:
لجدولة تشغيل اختبار كل يوم الساعة 5:00 مساءً، فإن تعبير cron هو
0 17 * * *
الشكل 22: جارٍ إعداد خطة اختبار.
إضافة مجموعات اختبار
أضف مجموعات الاختبارات التي تريد تحديد موعد لها من خلال خطة الاختبار عن طريق النقر على + إضافة اختبار تشغيل التهيئة. اختَر مجموعة اختبار من القائمة المنسدلة الاسم وانقر على الخطوة التالية: بعد ذلك، اختَر الأجهزة التي تريد إجراء الاختبار عليها وانقر على إضافة إعدادات. يمكنك إضافة إعدادات متعددة لكل خطة اختبار.
الشكل 23. جارٍ ضبط إعدادات إجراء اختبار.
إضافة إجراءات الجهاز
أضِف إجراءات الجهاز التي تريد تنفيذها قبل كل اختبار. راجع إضافة إجراءات الجهاز لمزيد من التفاصيل.
الشكل 24. جارٍ إضافة إجراءات الجهاز.
ضبط موارد الاختبار
إضافة موارد الاختبار إلى خطط الاختبار هي نفسها إضافتها إلى الاختبار الفردي يركض. راجع إعداد موارد الاختبار للحصول على مزيد من التفاصيل.
الشكل 25. ضبط موارد الاختبار
عرض عمليات الاختبار
قائمة عمليات اختبار التنفيذ
اطّلِع على قائمة عمليات الاختبار المجدوَلة في صفحة "عمليات الاختبار". انقر على عرض لاطلاع على مزيد من التفاصيل عن عملية الاختبار.
يمكنك أيضًا تصفية القائمة عن طريق إدخال سلسلة في شريط التصفية والضغط على مفتاح Enter. يمكنك استخدام فلاتر متعددة عن طريق فصلها مع والفاصلة. يعرض عامل التصفية جميع الصفوف التي تحتوي على النص المحدد (بدون سلسلة فرعية مطابقة) في أي عمود، باستثناء الحالة وتاريخ الإنشاء.
يؤدي عامل التصفية الفارغ إلى إرجاع جميع الصفوف. لا تتوفّر حاليًا طريقة للفلترة بحثًا عن الصفوف. ذات قيم فارغة.
الشكل 26. قائمة عمليات التنفيذ التجريبية
تفاصيل اختبار التنفيذ
يمكنك الاطّلاع على تفاصيل عملية الاختبار هنا، مثل الحالة والسجلّات والنتائج.
الشكل 27: تفاصيل التشغيل التجريبي
اختبار حالة التنفيذ
يظهر مستوى التقدّم في عملية إجراء الاختبار في قسم "الحالة". إذا كانت هناك علاقة مثل تقدم التنزيل أو سبب الإلغاء أو رسالة الخطأ، كما هو موضح هنا أيضًا.
الشكل 28. اختبار حالة التنفيذ
حالات تشغيل الاختبار هي:
- في انتظار المراجعة - يتم تنزيل الموارد المطلوبة.
- في قائمة الانتظار: الاختبار جاهز للتشغيل عندما يصبح الجهاز متاحًا.
- قيد التشغيل: يتم إجراء الاختبار على جهاز مخصّص.
- مكتمل: اكتمل الاختبار وتم الإبلاغ عن نتائجه.
- تم الإلغاء: تم إلغاء الاختبار من قِبل المستخدم أو انتهت المهلة أثناء محاولة العثور على الأجهزة المتاحة.
- خطأ: حدث خطأ أدّى إلى منع تشغيل الاختبار.
إلغاء عملية اختبار
إذا لم تكتمل عملية الاختبار، يمكنك إلغاؤه من خلال النقر على إلغاء ثم النقر على نعم في مربع حوار التأكيد. تكون عمليات الاختبار أيضًا تم إلغاؤها تلقائيًا إذا ظلت في حالة قائمة الانتظار أطول من queue_timeout_seconds. إلغاء إجراء اختبار عندما تكون في الحالة قيد التشغيل قد يستغرق تنفيذ الإجراء بضع دقائق.
الشكل 29. جارٍ إلغاء إجراء اختباري.
نتائج اختبار التنفيذ
بعد انتهاء إجراء الاختبار، يتم جمع النتائج وعرضها. يمكنك
لعرض تفاصيل إضافية من خلال النقر على السهم لكل تمرين. انقر على عرض الناتج.
Files للاطّلاع على عناصر الاختبار التي تم جمعها، مثل test_result.xml
test_result_failures.html
الشكل 30: اختبار نتائج التنفيذ
يمكنك الاطّلاع على المضيف المباشر وسجلات التجارة في علامة التبويب "السجلات".
الشكل 31. السجلات:
تتوفّر نتائج الوحدات الفردية في علامة التبويب "نتائج الاختبار".
الشكل 32: علامة التبويب "نتائج الاختبار".
يمكنك تنزيل الملفات المستخدَمة كموارد اختبار من خلال النقر على فتح في علامة التبويب "اختبار الموارد".
الشكل 33. علامة التبويب "اختبار الموارد".
للاطّلاع على تفاصيل إجراء الاختبار، مثل create_time، انتقِل إلى علامة التبويب "الإعداد".
الشكل 34. علامة التبويب "الإعداد".
الميزات المتقدّمة
إدارة ملفات الإعداد
يستخدم OmniLab ATS ملفات الإعدادات المكتوبة بلغة YAML لتحميل الخيارات المحدّدة مسبقًا، مثل الاختبارات وقنوات الإنشاء وإجراءات الأجهزة. في ما يلي مثال على ملف الإعداد:
// example_file.yaml
tests:
- id : android.cts.9_0.arm
name: CTS 9.0 (ARM)
test_resource_defs:
- name: android-cts.zip
default_download_url: https://dl.google.com/dl/android/cts/android-cts-9.0_r7-linux_x86-arm.zip
test_resource_type: TEST_PACKAGE
command: cts
env_vars:
- name: TF_PATH
value: ${TF_WORK_DIR}/android-cts/tools:${TF_WORK_DIR}/android-cts/testcases
- name: LD_LIBRARY_PATH
value: ${TF_WORK_DIR}/android-cts/lib:${TF_WORK_DIR}/android-cts/lib64
setup_scripts:
output_file_patterns:
- android-cts/logs/latest/.*
- android-cts/results/latest/.*\.html
- android-cts/results/latest/compatibility_result\..*
- android-cts/results/latest/logo.png
- android-cts/results/latest/test_result.xml
result_file: test_result.xml
java_properties:
- name: CTS_ROOT
value: ${TF_WORK_DIR}
context_file_dir: android-cts/results/
context_file_pattern: '[\d_\.]+\.zip'
retry_command_line: retry --retry 0
runner_sharding_args: --shard-count ${TF_SHARD_COUNT}
build_channels:
- id: google_drive
name: Google Drive
provider_name: Google Drive
device_actions:
- id: flash
name: Flash
test_resource_defs:
- name: bootloader.img
test_resource_type: DEVICE_IMAGE
- name: radio.img
test_resource_type: DEVICE_IMAGE
- name: img.zip
test_resource_type: DEVICE_IMAGE
tradefed_target_preparers:
- class_name: com.android.tradefed.targetprep.RunHostCommandTargetPreparer
option_values:
- name: work-dir
values:
- ${TF_WORK_DIR}
- name: host-setup-command
values:
- adb -s $SERIAL reboot-bootloader
- fastboot -s $SERIAL flash bootloader bootloader.img
- fastboot -s $SERIAL flash radio radio.img
- fastboot -s $SERIAL reboot-bootloader
- fastboot -s $SERIAL -w update img.zip
- adb -s $SERIAL wait-for-device
- name: host-cmd-timeout
values:
- 10m
عند إعداد مثيل OmniLab ATS، يمكنك مشاركة الإعدادات مع المستخدمين الآخرين من خلال تصديرها كملف. لإجراء ذلك، انتقِل إلى صفحة "الإعدادات" ثم انقر على تصدير في أعلى يسار الصفحة.
الشكل 35. إدارة ملفات الضبط
وبعد تنزيل ملف الإعداد، شاركه مع المستخدمين الآخرين. يمكنه إضافة ملف الإعداد إلى مثيل OmniLab ATS من خلال النقر على استيراد واختيار ملف الإعداد.
إنشاء إجراء جديد على الجهاز
تُستخدَم إجراءات الجهاز لبرمجة عملية إعداد الجهاز. الإجراءات هي النصوص البرمجية المنفّذة على كل جهاز يتم تشغيل الاختبار عليه قبل كل تشغيل اختبار، بما في ذلك قبل إعادة المحاولة. للاطّلاع على قائمة بالإجراءات المتاحة للأجهزة، انتقِل إلى الإعدادات وانقر على علامة التبويب "إجراءات الجهاز". تأتي العديد من إجراءات الجهاز التي تمت تهيئتها بالفعل، مثل إعادة التشغيل والوميض.
الشكل 36. علامة التبويب "إجراءات الجهاز"
إضافة إجراء جديد للجهاز
انقر على إجراء جهاز جديد.
الشكل 37. زر الإجراء الخاص بالجهاز الجديد
أدخِل اسمًا ووصفًا.
الشكل 38. اسم إجراء الجهاز.
انقر على إضافة أداة التجهيز المستهدفة.
إدخال هدف الاتحاد التجاري اسم الصف الكامل للمؤهِّل، على سبيل المثال،
com.android.tradefed.targetprep.RunHostCommandTargetPreparer
الشكل 39. إضافة أداة إعداد مستهدفة.
يمكن العثور على قائمة بأدوات إعداد الاستهداف المتاحة في com.android.tradefed.targetprep المرجع.
الشكل 40. قائمة التجهيزات المستهدفة.
أضِف أي خيارات لاستخدامها مع أداة إعداد الهدف. للاطّلاع على الخيارات المتاحة، يُرجى اتّباع الخطوات التالية: وضع علامة في المربّع targetprep لرمز المصدر لكل أداة إعداد هدف في AOSP:
الشكل 41. مثال على خيار الإجراء
لإضافة خيار، انقر على إضافة خيار التجهيز المستهدَف وأدخِل والقيم المطلوبة.
الشكل 42. مثال على أمر الإجراء
تحديد موارد الاختبار اللازمة لتنفيذ إجراء الجهاز، مثلاً، قم بإنشاء صور للوميض. لإضافة تعريف مورد، انقر على أضِف مورد اختبار واملأ الحقول المطلوبة. إذا كنت تعرف أين مكان ملفاتك، يمكنك تقديم عنوان URL افتراضي للتنزيل بالنقر فوق التصفّح. إذا كان المُعدّون المستهدَفون يقبلون استخدام الدليل كمصدر اختبار، اختَر إزالة الضغط. بعد ذلك، حدِّد دليل الوجهة النسبي. ضمن دليل العمل المؤقت وأسماء الملفات وفك ضغطها. إذا لم يتم تقديم أي أسماء ملفات، سيتم فك ضغط جميع الملفات من مورد الاختبار.
الشكل 43. موارد اختبار الإجراءات.
انقر على تعديل.
الشكل 44: التغييرات في حفظ الإجراءات
إدارة الاختبارات
تعديل اختبار
لتعديل اختبار محفوظ، انتقل إلى صفحة "الاختبارات" وانقر على تعديل في صف الاختبار الذي تريد تعديله. بعد تغيير إعدادات الاختبار، انقر على تعديل:
الشكل 45. تعديل الاختبار:
إضافة اختبار جديد
لإضافة اختبار جديد، انتقِل إلى صفحة "الاختبارات" وانقر على إنشاء اختبار جديد. الدخول المعلومات المناسبة وانقر على إنشاء.
الشكل 46. إنشاء الاختبار:
الشكل 47: جارٍ نسخ الاختبار
تصدير إعدادات المضيف
بعد تهيئة مضيف، يمكنك تصدير عمليات تهيئة المضيف إلى ملف. يمكنك تحميل هذا الملف إلى مضيفين آخرين لنسخ الإعدادات المحفوظة.
لتصدير تكوينات المضيف، انتقل إلى صفحة الإعدادات وانقر على تصدير في أعلى الجانب الأيسر.
الشكل 48. تصدير إعدادات المضيف.
لاستيراد ملف إعدادات مضيف، انتقِل إلى صفحة "الإعدادات" وانقر على استيراد في أعلى يسار الصفحة.
الشكل 49. استيراد إعدادات المضيف
استخدام الملفات والأدلة على الجهاز
بدءًا من الإصدار R11، يمكن الوصول
تلقائيًا إلى الملفات في الدليل $HOME/.ats_storage في OmniLab ATS. انسخ ملفًا أو انقل ملفًا إلى هذا
الدليل، ثم يمكنك اختياره من علامة التبويب ملف محلي عند جدولة
إجراء اختبار.
cp /path/to/file $HOME/.ats_storage
الشكل 50. اختيار ملف من دليل $HOME/.ats_storage
يمكنك تحميل أدلة إضافية في مخزن الملفات المحلي باستخدام
علم واحد (--mount_local_path)
mtt start --mount_local_path=/path/to/dir1 --mount_local_path=/path/to/dir2:renamed_dir2
الشكل 51. أدلة إضافية يتم تثبيتها في مخزن الملفات المحلي
تفعيل وضع المضيفين المتعدّدين
باستخدام وضع "المضيفون المتعدّدون"، يمكن للمستخدمين استخدام مضيف واحد لوحدة التحكّم في ATS لإدارة الأجهزة والاختبارات على مضيفي عامل ATS المتعدّدين.
الشكل 52. بنية وضع المضيف المتعدد.
لتشغيل وحدة التحكم في ATS، استخدم الأمر التالي:
mtt start --operation_mode=ON_PREMISEيمكن الوصول إلى وحدة التحكُّم في عملية التحقّق من خلال
http://${CONTROLLER_HOSTNAME}:8000.لبدء تشغيل المشغِّلين، استخدِم الأمر التالي:
mtt start --control_server_url=http://CONTROLLER_HOSTNAME:8000 --operation_mode=ON_PREMISE
فإذا كانت الشبكة لا تسمح للمضيفين بالاتصال ببعضهم البعض، يجب اتّباع تعليمات الإعداد الأكثر تقدّمًا الواردة أدناه على عامل تشغيل ATS
ربط المضيفين باستخدام أنفاق بروتوكول النقل الآمن. حدد المنافذ المنافذ الأساسية ومنفذ خادم الملفات، على سبيل المثال، 9000 و9006.
ssh -L ATS_PORT:localhost:8000 -L FS_PORT:localhost:8006 CONTROLLER_HOSTNAMEاضبط ميزة "التسويف الذكي للإعلانات" وابدأ استخدامها.
DOCKER_GATEWAY_IP_ADDRESS=$(ip -4 addr show dev docker0 | grep -Eo 'inet [.0-9]+/' | grep -Eo '[.0-9]+')socat tcp-listen:ATS_PORT,bind="${DOCKER_GATEWAY_IP_ADDRESS}",reuseaddr,fork tcp-connect:127.0.0.1:ATS_PORT &socat tcp-listen:FS_PORT,bind="${DOCKER_GATEWAY_IP_ADDRESS}",reuseaddr,fork tcp-connect:127.0.0.1:FS_PORT &mtt start --control_server_url=http://${DOCKER_GATEWAY_IP_ADDRESS}:ATS_PORT \ --control_file_server_url=http://${DOCKER_GATEWAY_IP_ADDRESS}:FS_PORT \ --operation_mode=ON_PREMISE
أداة تنظيف الملفات
منظف الملفات عبارة عن مهمة cron تعمل كل ساعة لتنظيف الملفات استنادًا إلى المحددة من قِبل المستخدم. لدى ATS إعدادان تلقائيان لأرشفة الاختبار وتنفيذ النتائج وحذف الملفات المؤقتة. يشرح هذا الدليل كيفية تخصيص السياسات والإعدادات لإدارة ملفاتك بفعالية.
السياسات
تحدد السياسة العملية التي سيتم تنفيذها على الملفات أو الأدلة، معايير لتحديد الأهداف. يتم عرض العمليات المتاحة في الجدول:
| نوع العملية | المعلمات |
|---|---|
ARCHIVE | remove_file: في حال true، أزِل الملف بعد الأرشفة. |
DELETE |
تستند المعايير إلى سمات الملفات ومعلومات النظام. متوفّر يتم عرض المعايير في الجدول:
| نوع المعيار | الوصف | المعلمات |
|---|---|---|
LAST_MODIFIED_TIME | فلترة الملفات حسب تاريخ ووقت آخر تعديل | ttl: تتوفّر أنواع مختلفة من تعبيرات الوقت، مثل 10m و2h و7 days و4w. يُرجى الاطّلاع على pytimeparse للاطّلاع على التنسيقات المتوافقة. |
LAST_ACCESS_TIME | فلترة الملفات استنادًا إلى تاريخ ووقت آخر وصول إليها | هذه القيمة هي نفسها للسمة LAST_MODIFIED_TIME. |
NAME_MATCH | فلترة الملفات حسب اسمها باستخدام التعبير العادي | pattern: تعبير عادي، على سبيل المثال، [a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}\.zip لمطابقة رموز منطقة النتائج. |
SYSTEM_AVAILABLE_SPACE | يمكنك تنفيذ الإجراءات بناءً على المساحة المتاحة في النظام. | threshold: يتم تنفيذ الإجراء عندما تكون المساحة المتوفّرة أقل من الحدّ الأدنى، على سبيل المثال، 200(B) أو 200KB أو 200MB أو 200GB أو 2TB. |
الشكل 53. إضافة سياسة جديدة لأداة تنظيف الملفات
الإعدادات
تجمع الإعدادات بين سياسة واحدة أو أكثر وأدلة محدّدة. الملفات الموجودة داخل الأدلة المحددة بناءً على سياسات محددة. يتم تطبيق السياسات بالترتيب الذي تظهر به في الإعدادات.
يجب وضع جميع الأدلة الهدف ضمن الدليل /data. إذا كان
تحدد config الدليل الهدف على أنّه logs، ويتم تفسيره على أنّه
/data/logs
الشكل 54: تعديل إعدادات أداة تنظيف الملفات
إعادة الضبط
يؤدي النقر على إعادة ضبط الإعدادات إلى إعادة ضبط أداة تنظيف الملفات إلى الحالة الافتراضية. يؤدي هذا الإجراء إلى محو جميع العناصر المخصّصة.
الشكل 55. إعادة ضبط إعدادات أداة تنظيف الملفات
الدعم
تقارير الأخطاء
تساعد مساهمتك من خلال OmniLab ATS في تحسين تطوير الأداة يهمّنا معرفة رأيك. اطّلِع على ملاحظات إصدار OmniLab ATS للحصول على تفاصيل عن أحدث إصدار. للإبلاغ عن الأخطاء أو تقديم الاقتراحات، تقديم تقرير خطأ يجب على الشركاء الإبلاغ عن الأخطاء أو الاقتراحات باستخدام قنوات الشركاء.