Panduan ACTS Tingkat Lanjut

Ini adalah panduan tentang cara menjalankan pengujian Android Comms Test Suite (ACTS) .

Mendapatkan kode

Versi ACTS terbaru dapat ditemukan di repositori Gerrit Android Open Source Project (AOSP) di /platform/tools/test/connectivity/ .

Untuk detail tentang cara menyinkronkan kode, lihat Mengunduh Sumber dan Codelab Pengembang Android . Saat menyinkronkan kode, sinkronkan cabang master. Jangan sinkronkan build yang diberi tag.

Perhatikan bahwa saat mengunduh ACTS, Anda tidak perlu menyinkronkan seluruh repositori Android. Untuk menyinkronkan ACTS saja, setelah menjalankan perintah repo init , jalankan:

repo sync platform/tools/test/connectivity

ACTS dapat ditemukan di <repo>/tools/test/connectivity/acts/ .

Pengaturan lingkungan

Untuk memastikan bahwa ACTS memiliki dependensi yang diperlukan untuk penyiapan, instal alat penyiapan Python 3 berikut:

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

Memasang ACTS

Skrip setup.py yang ditemukan di <repo>/tools/test/connectivity/acts/framework menginstal sisa dependensi dan ACTS itu sendiri.

Untuk pengembangan berkelanjutan pada atau dengan ACTS, jalankan perintah berikut:

cd <repo>/tools/test/connectivity/acts/framework/
sudo python3 setup.py develop
cd -

Jika Anda hanya ingin menjalankan tes, jalankan perintah ini sebagai gantinya:

cd <repo>/tools/test/connectivity/acts/framework/
sudo python3 setup.py install
cd -

Memverifikasi instalasi

Setelah penyiapan, pastikan Anda dapat menggunakan act.py di terminal Anda, dan mengimpor modul ACTS dengan Python. Sebagai contoh:

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()

Berjalan tanpa menginstal

Pengguna dapat menjalankan ACTS tanpa menginstal paket secara langsung. Satu-satunya langkah yang harus dilakukan adalah memodifikasi jalur Python untuk mengimpor dari <repo>/tools/test/connectivity/acts/framework . Sebelum menjalankan ACTS, jalankan setup.py install_deps untuk menginstal semua dependensi yang diperlukan oleh ACTS tanpa menginstal ACTS. Jika versi ACTS yang ada ada di mesin Anda, jalankan sudo setup.py uninstall .

Untuk menjalankan ACTS, gunakan salah satu dari perintah berikut:

  • cd <repo>/tools/test/connectivity/acts/framework; acts/bin/act.py

  • export PYTHONPATH=<repo>/tools/test/connectivity/acts/framework; acts/bin/act.py

ACTS mengeluarkan pesan yang meminta flag -c dan -tc . Untuk informasi lebih lanjut, lihat Mengonfigurasi Tes ACTS .

Menyiapkan ACTS di lingkungan virtual

Untuk mengisolasi penginstalan Anda dari penginstalan ACTS lainnya, Anda harus menginstal ACTS di lingkungan virtual. Langkah-langkah berikut mengasumsikan bahwa Anda memiliki acts_test.zip dari aosp-master di ci.android.com atau memiliki akses langsung ke sumbernya.

  1. Dapatkan ACTS.

    Build diterbitkan. Untuk informasi selengkapnya, lihat Integrasi Berkelanjutan Android . Anda dapat menarik file zip dari build di ci.android.com . Cari target test_suites_x86_64 .

    File acts_test.zip berada di bawah tab Artefak. Untuk contoh ini, asumsikan acts_test.zip telah diunduh ke /tmp/acts_test.zip .

    Jika Anda memiliki akses ke kode sumber, Anda dapat menggunakannya sebagai gantinya.

  2. Instal virtualenv di mesin Anda.

    Jika Anda belum memilikinya, Anda dapat menginstal virtualenv menggunakan:

    python3 -m pip install -U --user virtualenv

  3. Buat dan aktifkan lingkungan virtual (dalam /tmp/my_virtualenv untuk contoh ini). Ini memastikan bahwa paket baru diinstal di direktori virtualenv .

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

  4. Instal ACTS. Jalankan perintah berikut.

    unzip /tmp/acts_test.zip -d /tmp/my_virtualenv/acts
cd /tmp/my_virtualenv/acts/tools/test/connectivity/acts/framework/
python3 setup.py install

    Jika Anda memiliki akses ke kode secara langsung, Anda dapat melewati unzip:

    cd /path/to/acts/framework
python3 setup.py install

  5. Jalankan ACTS dari mana saja.

    act.py -c <config> ...

  6. Tinggalkan lingkungan virtual setelah selesai menjalankan tes.

    deactivate

Mem-flash perangkat Android (opsional)

Jika Anda ingin mendapatkan kontrol hak istimewa sistem perangkat, flash perangkat dengan build userdebug .

Untuk mem-flash perangkat, gunakan Android Flash Tool (flash.android.com/) . Untuk detail selengkapnya, lihat dokumentasi di Android Flash Tool .

Menginstal SL4A (opsional, disarankan)

Jika Anda menggunakan perangkat dengan build userdebug , Anda memiliki opsi untuk mendapatkan kontrol hak istimewa sistem perangkat Anda menggunakan SL4A. Jika pengujian Anda tidak menggunakan SL4A pada perangkat, Anda dapat mengatur flag skip_sl4a di konfigurasi ACTS untuk menonaktifkan fitur tersebut.

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

Untuk mendapatkan APK SL4A, ikuti petunjuk di Scripting Layer untuk Android .