Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Halaman ini diterjemahkan oleh Cloud Translation API.

Panduan ACTS lanjutan

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

Mendapatkan kode

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

Untuk detail tentang cara menyinkronkan kode, lihat Mendownload sumber dan Codelab Developer Android. Saat menyinkronkan kode, sinkronkan cabang utama. Jangan sinkronkan build yang diberi tag.

Perhatikan bahwa saat mendownload 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 bagian <repo>/tools/test/connectivity/acts/.

Penyiapan lingkungan

Guna 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 ada di <repo>/tools/test/connectivity/acts/framework akan menginstal sisa dependensi dan ACTS itu sendiri.

Untuk pengembangan berkelanjutan di 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 penginstalan

Setelah penyiapan, pastikan Anda dapat menggunakan act.py di terminal, lalu impor modul ACTS di Python. 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()

Jalankan tanpa menginstal

Pengguna dapat menjalankan ACTS tanpa menginstal paket secara langsung. Satu-satunya langkah yang harus dilakukan adalah mengubah jalur Python yang akan diimpor 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 di komputer 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 menghasilkan pesan yang meminta tanda -c dan -tc. Untuk informasi selengkapnya, lihat Mengonfigurasi Pengujian ACTS.

Menyiapkan ACTS di lingkungan virtual

Untuk mengisolasi penginstalan ACTS dari penginstalan 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 sumber.

Dapatkan TINDAKAN.

Build dipublikasikan. Untuk mengetahui informasi selengkapnya, lihat Android Continuous Integration. Anda dapat menarik file zip dari build di ci.android.com. Cari target test_suites_x86_64.

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

Jika Anda memiliki akses ke kode sumber, Anda dapat menggunakannya.
Instal virtualenv di komputer Anda.

Jika belum memilikinya, Anda dapat menginstal virtualenv menggunakan:
```
python3 -m pip install -U --user virtualenv
```
Buat dan aktifkan lingkungan virtual (misalnya dalam /tmp/my_virtualenv). Hal ini memastikan bahwa paket baru diinstal di direktori virtualenv.
```
python3 -m virtualenv /tmp/my_virtualenv
source /tmp/my_virtualenv/bin/activate
```

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 proses ekstrak:

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

Jalankan TINDAKAN dari mana saja.
```
act.py -c <config> ...
```
Keluar dari lingkungan virtual setelah selesai menjalankan pengujian.
```
deactivate
```

Mem-flash perangkat Android (opsional)

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

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

Menginstal SL4A (opsional, direkomendasikan)

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

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

Untuk mendapatkan APK SL4A, ikuti petunjuk di Lapisan Skrip untuk Android.