دليل الأفعال المتقدمة

هذا دليل حول كيفية تشغيل اختبارات 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 أو أن لديك إمكانية الوصول المباشر إلى المصدر.

1. احصل على الأفعال.

   يتم نشر البنيات. لمزيد من المعلومات، راجع التكامل المستمر لنظام Android . يمكنك سحب الملفات المضغوطة من الإصدار الموجود على ci.android.com . ابحث عن الهدف test_suites_x86_64 .

   يوجد الملف acts_test.zip ضمن علامة التبويب Artifacts. في هذا المثال، افترض أنه تم تنزيل acts_test.zip إلى /tmp/acts_test.zip .

   إذا كان لديك حق الوصول إلى الكود المصدري، فيمكنك استخدامه بدلاً من ذلك.

2. قم بتثبيت virtualenv على جهازك.

   إذا لم يكن لديك بالفعل، يمكنك تثبيت virtualenv باستخدام:

   python3 -m pip install -U --user virtualenv
   

3. قم بإنشاء وتنشيط البيئة الافتراضية (في /tmp/my_virtualenv لهذا المثال). وهذا يضمن تثبيت الحزم الجديدة في دليل virtualenv .

   python3 -m virtualenv /tmp/my_virtualenv
   source /tmp/my_virtualenv/bin/activate
   

4. قم بتثبيت الأفعال. قم بتشغيل الأمر التالي.

   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
   

5. تشغيل الأفعال من أي مكان.

   act.py -c <config> ...
   

6. اترك البيئة الافتراضية عند الانتهاء من إجراء الاختبارات.

   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 .