Panduan ACTS tingkat lanjut

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

Mendapatkan kodenya

Versi ACTS terbaru dapat ditemukan di repositori Gerrit Proyek Sumber Terbuka Android (AOSP) di /platform/tools/test/connectivity/ .

Untuk mengetahui detail tentang cara menyinkronkan kode, lihat Mengunduh Sumber dan Codelab Developer Android . Saat menyinkronkan kode, sinkronkan cabang utama. 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

Menginstal ACTS

Skrip setup.py yang ditemukan di <repo>/tools/test/connectivity/acts/framework menginstal dependensi lainnya 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 pengujian, jalankan perintah ini:

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. Misalnya:

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 instalasi

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 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 tanda -c dan -tc . Untuk informasi lebih lanjut, lihat Mengonfigurasi Tes ACTS .

Menyiapkan ACTS di lingkungan virtual

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

  1. Dapatkan ACT.

    Bangunan 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 bahwa acts_test.zip telah diunduh ke /tmp/acts_test.zip .

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

  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 (di /tmp/my_virtualenv untuk contoh ini). Ini memastikan bahwa paket-paket baru diinstal di direktori virtualenv .

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

  4. Instal ACT. 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 proses 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 pengujian.

    deactivate

Mem-flash perangkat Android (opsional)

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

Untuk mem-flash perangkat, gunakan Alat Flash Android (flash.android.com/) . Untuk lebih jelasnya 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 pada perangkat Anda menggunakan SL4A. Jika pengujian Anda tidak menggunakan SL4A pada perangkat, Anda dapat menyetel tanda skip_sl4a di konfigurasi ACTS untuk menonaktifkan fitur tersebut.

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

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