دليل ACTS المتقدِّم

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

  1. الحصول على ACTS

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

    يتوفّر ملف acts_test.zip ضمن علامة التبويب "العناصر". في هذا المثال، لنفترض أنّه تم تنزيل 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. تثبيت 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

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

    act.py -c <config> ...

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

    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.