هذا دليل حول كيفية تشغيل اختبارات Android Comms Test Suite (ACTS) .
الحصول على الرمز
يمكن العثور على أحدث إصدار من ACTS في مستودع Gerrit لمشروع Android مفتوح المصدر (AOSP) في /platform/tools/test/connectivity/
.
للحصول على تفاصيل حول كيفية مزامنة التعليمات البرمجية، راجع تنزيل المصدر و Android Developer Codelab . عند مزامنة الكود، قم بمزامنة الفرع الرئيسي. لا تقم بمزامنة البنية ذات العلامات.
لاحظ أنه عند تنزيل 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
تثبيت الأفعال
يقوم البرنامج النصي 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 دون تثبيت الحزمة مباشرة. الخطوة الوحيدة التي يجب تنفيذها هي تعديل مسار Python للاستيراد من <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 أو أن لديك إمكانية الوصول المباشر إلى المصدر.
احصل على الأفعال.
يتم نشر البنيات. لمزيد من المعلومات، راجع التكامل المستمر لنظام Android . يمكنك سحب الملفات المضغوطة من الإصدار الموجود على ci.android.com . ابحث عن الهدف
test_suites_x86_64
.يوجد الملف
acts_test.zip
ضمن علامة التبويب Artifacts. في هذا المثال، افترض أنه تم تنزيل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
قم بتثبيت الأفعال. قم بتشغيل الأمر التالي.
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
تشغيل الأفعال من أي مكان.
act.py -c <config> ...
اترك البيئة الافتراضية عند الانتهاء من إجراء الاختبارات.
deactivate
وميض جهاز Android (اختياري)
إذا كنت ترغب في الحصول على تحكم مميز في النظام بالجهاز، فقم بتحديث الجهاز باستخدام إصدار userdebug
.
لتفليش الجهاز، استخدم أداة Android Flash Tool (flash.android.com/) . لمزيد من التفاصيل، راجع الوثائق في Android Flash Tool .
تثبيت SL4A (اختياري، موصى به)
إذا كنت تستخدم جهازًا مزودًا بإصدار userdebug
، فلديك خيار التحكم في امتيازات النظام لجهازك باستخدام SL4A. إذا كان اختبارك لا يستخدم SL4A على الجهاز، فيمكنك تعيين علامة skip_sl4a
في تكوين ACTS لتعطيل الميزة.
"AndroidDevice": [{"serial": "standardized serial number reference", "skip_sl4a": true}, ...]
للحصول على SL4A APK، اتبع الإرشادات الموجودة في Scripting Layer لنظام Android .