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

هذا دليل حول كيفية إجراء اختبارات مجموعة اختبارات الاتصالات في Android (ACTS).

حصول على الرمز

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

تثبيت SL4A (اختياري، ننصح به)

إذا كنت تستخدم جهازًا يعمل بالإصدار userdebug، يمكنك الحصول على إذن التحكّم في امتيازات النظام على جهازك باستخدام SL4A. إذا كان اختبارك لا يستخدم SL4A على الجهاز، يمكنك ضبط العلامة skip_sl4a في إعدادات ACTS بهدف تعطيل الميزة.

"AndroidDevice": [{"serial": "standardized serial number reference", "skip_sl4a": true}, ...]

للحصول على حزمة APK الخاصة بـ SL4A، اتّبِع التعليمات الواردة في مقالة Scripting Layer for Android.