راهنمای ACTS پیشرفته

این راهنمای نحوه اجرای تست‌های Android Comms Test Suite (ACTS) است.

دریافت کد

به‌روزترین نسخه ACTS را می‌توانید در مخزن Gerrit پروژه منبع باز Android (AOSP) در /platform/tools/test/connectivity/ پیدا کنید.

برای جزئیات در مورد نحوه همگام‌سازی کد، به دانلود منبع و Codelab برنامه‌نویس Android مراجعه کنید. هنگام همگام سازی کد، شاخه اصلی را همگام کنید. یک ساخت تگ شده را همگام نکنید.

توجه داشته باشید که هنگام دانلود ACTS، نیازی به همگام سازی کل مخزن اندروید ندارید. برای همگام سازی فقط ACTS، پس از اجرای دستور repo init ، اجرا کنید:

repo sync platform/tools/test/connectivity

ACTS را می توان در <repo>/tools/test/connectivity/acts/ یافت.

راه اندازی محیط

برای اطمینان از اینکه ACTS وابستگی های لازم برای راه اندازی را دارد، ابزارهای راه اندازی پایتون 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 را در پایتون وارد کنید. مثلا:

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 مراجعه کنید. می توانید فایل های فشرده را از یک بیلد در 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. 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
   

فلش کردن دستگاه اندروید (اختیاری)

اگر می‌خواهید کنترل ممتاز دستگاه را از طریق سیستم دریافت کنید، دستگاه را با ساختار 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 for Android را دنبال کنید.