إليك هذا الدليل حول كيفية إجراء اختبارات حزمة اختبار مجموعة خدمات الاتصال (ACTS) من Android.
حصول على الرمز
يمكن العثور على أحدث إصدار من نظام ACTS في مستودع Gerrit ضمن "مشروع مفتوح المصدر لنظام Android" (AOSP) في
/platform/tools/test/connectivity/
.
لمعرفة تفاصيل حول كيفية مزامنة الرمز، يمكنك الاطّلاع على تنزيل المصدر والدرس التطبيقي حول ترميز مطوّر برامج Android. عند مزامنة التعليمات البرمجية، قم بمزامنة الفرع الرئيسي. عدم مزامنة إصدار تم وضع علامة عليه
يُرجى العلم أنّه عند تنزيل تنسيق ACTS، لن تحتاج إلى مزامنة مستودع Android بالكامل. لمزامنة ACTS فقط، بعد تشغيل الأمر repo init
، شغِّل:
repo sync platform/tools/test/connectivity
يمكن العثور على أداة ACTS ضمن "<repo>/tools/test/connectivity/acts/
".
إعداد البيئة
للتأكد من أن ACTS تتضمن التبعيات المطلوبة للإعداد، ثبِّت أدوات إعداد Python 3 التالية:
sudo apt-get install python3-setuptools
sudo apt-get install python3-pip
sudo apt-get install adb fastboot
sudo pip3 install --upgrade pip setuptools # Needed due to an on-going bug.
sudo apt-get install protobuf-compiler
تثبيت ACTS
يثبّت نص setup.py
الموجود في <repo>/tools/test/connectivity/acts/framework
بقية العناصر التابعة
ودليل ACTS نفسه.
للتطوير المستمر على ACTS أو باستخدامها، شغِّل الأمر التالي:
cd <repo>/tools/test/connectivity/acts/framework/
sudo python3 setup.py develop
cd -
إذا كنت تريد إجراء اختبارات فقط، شغِّل الأمر التالي بدلاً من ذلك:
cd <repo>/tools/test/connectivity/acts/framework/
sudo python3 setup.py install
cd -
التحقق من التثبيت
بعد الإعداد، تأكَّد من إمكانية استخدام act.py
في الوحدة الطرفية واستيراد وحدات ACTS في Python. على سبيل المثال:
act.py -h usage: act.py [-h] -c <PATH> [--test_args Arg1 Arg2 ... ]
python3 >>> from acts.controllers import android_device >>> device_list = android_device.get_all_instances()
التشغيل بدون تثبيت
يمكن للمستخدمين تشغيل التفاعل بتنسيق ACTS بدون تثبيت الحزمة مباشرةً. الخطوة الوحيدة التي يجب
تنفيذها هي تعديل مسار بايثون للاستيراد من
<repo>/tools/test/connectivity/acts/framework
. قبل تشغيل ACTS،
شغِّل setup.py install_deps
لتثبيت جميع التبعيات المطلوبة من خلال ACTS بدون
تثبيت ACTS. إذا كان هناك إصدار حالي من ACTS على جهازك، شغِّل
sudo setup.py uninstall
.
لتشغيل ACTS، استخدم أحد الأوامر التالية:
cd <repo>/tools/test/connectivity/acts/framework; acts/bin/act.py
export PYTHONPATH=<repo>/tools/test/connectivity/acts/framework; acts/bin/act.py
يؤدي تفعيل ACTS إلى إخراج الرسائل التي تطلب علامتَي -c
و-tc
. لمزيد من المعلومات، راجِع ضبط اختبارات ACTS.
إعداد ACTS في بيئة افتراضية
لعزل التثبيت عن عمليات تثبيت ACTS الأخرى، عليك تثبيت ACTS في بيئة افتراضية. تفترض الخطوات التالية أن لديك
acts_test.zip
من aosp-main
على
ci.android.com أو لديك إمكانية وصول مباشر إلى
المصدر.
الحصول على ACTS
تم نشر الإصدارات. للحصول على مزيد من المعلومات، يُرجى الاطّلاع على الدمج المستمر لنظام Android. يمكنك سحب ملفات ZIP من إصدار على ci.android.com. ابحث عن هدف
test_suites_x86_64
.يتوفّر ملف
acts_test.zip
ضمن علامة التبويب "العناصر". في هذا المثال، لنفترض أنّه تم تنزيلacts_test.zip
إلى/tmp/acts_test.zip
.إذا كان بإمكانك الوصول إلى رمز المصدر، يمكنك استخدامه بدلاً من ذلك.
ثبِّت "
virtualenv
" على جهازك.يمكنك تثبيت
virtualenv
إذا لم يكن متوفّرًا لديك حاليًا باستخدام:python3 -m pip install -U --user virtualenv
يمكنك إنشاء البيئة الافتراضية وتفعيلها (في
/tmp/my_virtualenv
للاطّلاع على هذا المثال). يضمن هذا الإجراء تثبيت الحِزم الجديدة في دليلvirtualenv
.python3 -m virtualenv /tmp/my_virtualenv
source /tmp/my_virtualenv/bin/activate
تثبيت ACTS شغِّل الأمر التالي.
unzip /tmp/acts_test.zip -d /tmp/my_virtualenv/acts
cd /tmp/my_virtualenv/acts/tools/test/connectivity/acts/framework/
python3 setup.py install
إذا كان بإمكانك الوصول إلى الرمز مباشرةً، يمكنك تخطّي عملية فكّ الضغط:
cd /path/to/acts/framework
python3 setup.py install
تشغيل ACTS من أي مكان
act.py -c <config> ...
يجب مغادرة البيئة الافتراضية عند الانتهاء من إجراء الاختبارات.
deactivate
وميض جهاز Android (اختياري)
إذا كنت تريد الحصول على إذن تحكُّم خاص للنظام في الجهاز،
عليك تثبيت إصدار userdebug
من الجهاز.
لتشغيل الفلاش على الجهاز، استخدم أداة Android Flash Tool (flash.android.com/). للحصول على مزيد من التفاصيل، يمكنك الاطّلاع على المستندات على أداة Android Flash.
تثبيت SL4A (اختياري، يُنصح به)
إذا كنت تستخدم جهازًا يعمل بالإصدار userdebug
، يمكنك التحكّم في امتيازات النظام في جهازك باستخدام SL4A. إذا لم يستخدم الاختبار SL4A على الجهاز، يمكنك ضبط العلامة skip_sl4a
ضمن إعدادات ACTS لإيقاف الميزة.
"AndroidDevice": [{"serial": "standardized serial number reference", "skip_sl4a": true}, ...]
للحصول على حزمة SL4A APK، يمكنك اتباع التعليمات الواردة في طبقة البرمجة النصية لنظام التشغيل Android.