Android Test Station adalah alat pengujian yang dapat digunakan oleh pengembang dan teknisi pengujian Android untuk menggunakan antarmuka pengguna guna menjalankan rangkaian pengujian Android standar, seperti Android Compatibility Test Suite (CTS) . Alat ini bertindak sebagai antarmuka web untuk Federasi Perdagangan (TF) , memungkinkan Anda menjalankan CTS dengan mudah pada serangkaian perangkat pengujian dengan pengaturan minimal, serta menetapkan jadwal untuk terus menjalankan pengujian.
Siapkan Stasiun Uji Android
Bagian ini menjelaskan cara memasang dan menyiapkan Android Test Station.
Android Test Station menggunakan kode sumber dari lokasi berikut:
- Kode sumber Stasiun Uji Android
- Kode sumber Klaster TradeFed
Instal Stasiun Uji Android
Ikuti semua persyaratan perangkat keras dan perangkat lunak untuk rangkaian pengujian yang Anda jalankan.
Persyaratan untuk CTS dapat ditemukan di source.android.com .
Tidak ada persyaratan perangkat keras tambahan untuk ATS, namun kami merekomendasikan penggunaan persyaratan host CTS sebagai titik awal.
Ada dua cara untuk menginstal Android Test Station:
- Jalankan program penginstal .
- Instal secara manual , yang memerlukan instalasi beberapa program dan sumber daya.
Instal dengan program penginstal
Di Ubuntu 20.04+, program penginstal menginstal dan mengonfigurasi semua program dan sumber daya yang diperlukan untuk menjalankan Android Test Station.
Untuk menggunakan program instalasi:
Jalankan program penginstal:
curl https://storage.googleapis.com/android-mtt.appspot.com/prod/install.sh | bash
Jalankan
mtt version
untuk memeriksa versi Android Test Station CLI yang terinstal.
Instal secara manual
Instal Docker
Ikuti instruksi untuk menginstal Docker Community Edition (CE) di mesin Linux Anda.
Ikuti langkah-langkah pasca instalasi untuk mengelola Docker sebagai pengguna non-root .
Anda mungkin perlu memulai ulang jendela terminal atau keluar lalu masuk lagi agar perubahan izin diterapkan.
Instal Python 3
CLI Android Test Station diverifikasi terhadap Python versi 3.7 hingga 3.10.
Untuk Ubuntu 16.04 atau versi lebih lama, pertama-tama tambahkan repositori untuk Python 3 dengan melakukan salah satu hal berikut:
Jalankan perintah ini:
sudo add-apt-repository ppa:deadsnakes/ppa
Bangun dan instal repositori dari sumbernya .
Untuk menginstal Python 3, jalankan perintah berikut:
sudo apt-get update
sudo apt install python3 python3-distutils
Untuk menginstal versi Python 3 tertentu (misalnya, 3.10), jalankan perintah berikut:
sudo apt-get update
sudo apt install python3.10 python3.10-distutils
Dapatkan CLI Stasiun Uji Android
Unduh paket antarmuka baris perintah (CLI) di sini.
Mulai Stasiun Uji Android
Mulai Android Test Station dengan perintah berikut:
mtt start
Saat pertama kali UI dimulai, mungkin diperlukan waktu beberapa menit untuk muncul. CLI menampilkan URL web untuk mengakses UI di browser. Secara default, URL webnya adalah localhost:8000
. Jika diperlukan, Anda dapat mengubah port default saat startup dengan flag --port
.
Jika versi yang lebih baru tersedia, Anda dapat memperbarui ke versi saat ini. Anda dapat memeriksa Catatan Rilis untuk rilis terbaru.
Untuk memperbarui ke versi saat ini, jalankan:
mtt start --force_update
Untuk menghentikan aplikasi, jalankan:
mtt stop
Untuk melihat daftar perintah lain, gunakan:
mtt --help
Cadangkan dan pulihkan database
Untuk mencadangkan database ATS, hentikan aplikasi dan jalankan perintah berikut, yang mencadangkan database saat ini ke dalam file TAR bernama mtt-backup.tar
di direktori home Anda:
docker run --rm --mount source=mtt-data,target=/data -v ~:/out ubuntu bash -c "cd /data && tar cvf /out/mtt-backup.tar ."
Untuk memulihkan, jalankan perintah berikut sebelum memulai aplikasi:
docker run --rm --mount source=mtt-data,target=/data -v ~:/out ubuntu bash -c "cd /data && tar xvf /out/mtt-backup.tar"
Petunjuk penggunaan
Setelah Anda menginstal dan menjalankan Android Test Station untuk pertama kalinya, Wizard Penyiapan akan memandu Anda melalui beberapa langkah untuk membantu Anda menyesuaikan alat untuk lingkungan Anda. Setiap perubahan yang Anda buat di sini dapat dikonfigurasi ulang nanti melalui halaman Pengaturan.
Pulihkan cadangan konfigurasi
Jika Anda memiliki file konfigurasi yang dicadangkan dari host Android Test Station lain, Anda dapat mengunggah file tersebut untuk menyalin konfigurasi apa pun yang diubah dari host tersebut dengan mengklik tombol Unggah File .
Gambar 1. Memulihkan Cadangan Konfigurasi.
Tetapkan akun layanan default
Anda dapat menyetel akun layanan yang digunakan Android Test Station secara default saat mengakses sumber daya Anda (misalnya, Google Cloud Storage, Google Drive). Untuk mengautentikasi akun layanan Anda, klik Unggah Kunci Akun Layanan dan pilih file kunci JSON akun layanan Anda.
Gambar 2. Mengatur akun layanan.
Ketika akun layanan berhasil diautentikasi, alamat email akun muncul di sudut kanan atas halaman. Untuk mengubah akun layanan, klik nama akun, hapus akun default saat ini, dan unggah kunci akun layanan baru.
Gambar 3. Mengubah akun layanan.
Impor set konfigurasi
Kumpulan konfigurasi adalah kumpulan konfigurasi untuk menjalankan rangkaian pengujian, termasuk tindakan perangkat terkait, dan saluran build. Kumpulan konfigurasi dihosting di bucket Google Cloud Storage (GCS) tertentu. Setelah mengautentikasi saluran build GCS dengan akun Google Anda, Anda akan melihat daftar semua kumpulan konfigurasi yang tersedia untuk Anda.
Pilih set konfigurasi apa pun yang ingin Anda tambahkan ke host Stasiun Uji Anda dan klik Impor yang Dipilih .
Gambar 4. Mengimpor Set Konfigurasi.
Sertakan pengaturan Wi-Fi
Beberapa tes CTS mengharuskan perangkat Anda terhubung ke hotspot Wi-Fi. Untuk memilih jaringan Wi-Fi Anda, masukkan SSID WiFi dan PSK WiFi opsional.
Gambar 5. Pengaturan hotspot Wi-Fi.
Setelah menyelesaikan Wizard Penyiapan, halaman dimuat ulang dengan penerapan pengaturan baru.
Hubungkan perangkat
USB debugging harus diaktifkan agar perangkat dapat digunakan untuk pengujian. Untuk mengaktifkan proses debug:
Ikuti instruksi di Aktifkan opsi pengembang dan debugging .
Jika Anda berencana menggunakan versi uji Android yang dimuat sebelumnya dengan kunci ADB khusus, letakkan file
.adb_key
khusus di bawah direktori~/.android/
.File-file tersebut dimuat secara otomatis dan diteruskan ke ADB untuk mengaktifkan USB debugging secara otomatis setelah perangkat di-flash untuk perangkat yang menjalankan build tersebut.
Hubungkan perangkat ke mesin host menggunakan USB.
Perangkat muncul di tab Perangkat Stasiun Uji Android dalam waktu satu menit setelah menyegarkan antarmuka web. Anda juga dapat melihat status perangkat di tab ini.
Gambar 6. Menghubungkan perangkat.
Status perangkat yang berbeda adalah:
- Tersedia - Perangkat terhubung dan siap menjalankan pengujian.
- Dialokasikan - Perangkat terhubung dan sedang menjalankan pengujian. Setiap perangkat hanya dapat menjalankan satu pengujian dalam satu waktu, sehingga perangkat harus menyelesaikan pengujian saat ini sebelum menjalankan pengujian baru.
Jalankan tes
Pilih tes
Android Test Station hadir dengan serangkaian konfigurasi CTS yang telah dipaketkan sebelumnya. Untuk menjalankan salah satu pengujian ini, buka tab Test Suites dan klik Jalankan pengujian untuk pengujian yang diinginkan.
Gambar 7. Memilih tes.
Untuk mengedit atau menambahkan tes baru, lihat Menambahkan tes .
Konfigurasikan uji coba
Edit parameter yang akan digunakan untuk uji coba khusus ini. Sebagian besar parameter sudah diisi sebelumnya dengan nilai yang ditentukan dalam konfigurasi pengujian yang dipilih.
Langkah ini dapat diselesaikan menggunakan nilai default, namun Anda dapat mengubah parameter mana pun, seperti Max Retry dan Command , agar sesuai dengan kebutuhan Anda.
Gambar 8. Mengonfigurasi uji coba.
Parameter uji coba adalah:
- Nama - Nama rangkaian pengujian yang ingin Anda jalankan.
- Run Count - Berapa kali uji coba ini harus dijalankan sesuai jadwal. Uji coba dijadwalkan menggunakan Trade Federation , yang menjalankan hingga 20 uji coba secara paralel jika ada kapasitas untuk melakukannya.
- Coba Ulang Maks - Jumlah maksimum percobaan ulang yang dijalankan jika setidaknya satu pengujian gagal. Ini biasanya diatur ke 4–6 percobaan ulang untuk menjalankan CTS penuh guna menangani pengujian yang tidak stabil.
- Batas Waktu Antrean - Jika uji coba tetap berada dalam status Antrian terlalu lama, uji coba dibatalkan secara otomatis. Tentukan jumlah waktu menunggu sebelum pembatalan di sini. Standarnya adalah 24 jam.
Command - Perintah untuk menjalankan rangkaian pengujian. Anda dapat memasukkan argumen baris perintah tambahan di sini. Misalnya, jalankan modul tertentu di CTS 8.1 dengan:
cts-suite -m ShortModuleName
Perintah Coba Lagi - Perintah untuk mencoba ulang rangkaian pengujian. Anda dapat menambahkan argumen baris perintah tambahan di sini. Misalnya, untuk mencoba kembali modul tertentu saja di CTS 8.1, gunakan:
cts --retry 0 -m ShortModuleName
Argumen percobaan ulang mungkin berbeda dari yang tersedia dengan perintah awal, jadi periksa parameter yang didukung di situs resmi untuk rangkaian pengujian yang dipilih.
Uji Coba Sebelumnya - Jika Anda ingin menjalankan ulang uji coba sebelumnya:
Lokal - Jika proses dimulai pada host saat ini, masukkan ID proses pengujian yang terlihat saat melihat rincian proses pengujian.
Gambar 9. Uji coba lokal sebelumnya.
Jarak Jauh - Jika proses dimulai pada host yang berbeda, unggah file hasil tes dengan memilih Remote , klik Upload Test Results File , dan pilih file dari penyimpanan lokal Anda.
Gambar 10. Uji coba jarak jauh sebelumnya.
Pilih perangkat
Klik kotak centang untuk memilih perangkat yang akan dialokasikan untuk menjalankan rangkaian pengujian. Jumlah pecahan akan otomatis berubah agar sesuai dengan jumlah perangkat yang dipilih.
Gambar 11. Memilih perangkat.
Untuk memilih perangkat berdasarkan atribut selain serial perangkat, Anda dapat memasukkan "Spesifikasi Perangkat" secara manual. Misalnya, untuk memilih 3 perangkat dengan nama produk "semak duri", masukkan yang berikut ini:
product:bramble;product:bramble;product:bramble
Atribut yang didukung adalah:
- build_id
- perangkat_serial
- tipe perangkat
- nama host
- produk
- varian_produk
- sim_state
Semua perangkat yang dipilih harus berada dalam status Tersedia untuk menjalankan uji coba, dan semuanya beralih ke status Dialokasikan saat uji coba dijalankan. Uji coba berada dalam status Antri sambil menunggu perangkat tersedia.
Tambahkan tindakan perangkat
Tindakan perangkat adalah skrip yang dapat dijalankan sebelum setiap pengujian dijalankan. Beberapa tindakan perangkat sudah dikonfigurasi, seperti mem-flash dan mem-boot ulang. Untuk membuat tindakan perangkat baru, lihat Tindakan membuat perangkat baru .
Gambar 12. Tindakan perangkat.
Untuk menambahkan tindakan perangkat ke pengujian yang dijalankan, klik Tambahkan tindakan baru , pilih kotak centang untuk tindakan yang akan ditambahkan, dan klik Tambahkan Tindakan . Tindakan perangkat dilakukan secara berurutan. Anda dapat menyusun ulang tindakan dengan menyeretnya.
Gambar 13. Tindakan penataan ulang.
Tetapkan sumber daya pengujian
Sumber daya pengujian adalah file yang diperlukan untuk menjalankan pengujian. Misalnya, menjalankan CTS memerlukan file android-cts*.zip
, dan mem-flash perangkat mengharuskan Anda menyediakan image build.
URL unduhan untuk file zip test suite harus default ke tautan Google Drive yang diberikan kepada mitra. Anda dapat memilih file lain dengan mengeklik telusuri . Di jendela popup, Anda dapat memasukkan link download file, menggunakan file dari saluran build yang diautentikasi, atau mengunggah file untuk digunakan dari penyimpanan lokal.
Gambar 14. Uji sumber daya.
Di bawah ini adalah jendela popup untuk memilih sumber daya pengujian berdasarkan URL web. Anda cukup memasukkan tautan url unduhan, dan klik tombol Pilih untuk mengonfirmasi pilihan.
Gambar 15. Uji Pemilih Sumber Daya - URL Web.
Jika Anda telah mengunggah sumber daya ke Google Grive, Google Cloud Storage (GCS), atau saluran lainnya, Anda juga dapat membuka tab saluran tertentu dan memilih sumber daya di sana. Berikut adalah contoh untuk memilih sumber daya dari Google Drive.
Gambar 16. Uji Pemilih Sumber Daya - Google Drive.
Selain hanya memilih file, karakter wildcard juga didukung di kolom Nama File . Dokumentasinya dapat ditemukan di sini .
Gambar 17. Tes Resource Selector - Dukungan pola wildcard.
Anda juga dapat memilih file dari penyimpanan file lokal Android Test Station. Anda dapat mengunggah file ke penyimpanan ini, atau langsung menggunakan file dan direktori lokal .
Gambar 18. Uji Pemilih Sumber Daya - Penyimpanan file lokal.
Tambahkan konfigurasi jalankan ulang
Anda dapat menjadwalkan pemutaran ulang yang dimulai setelah proses utama selesai dan memuat hasilnya, namun dapat menggunakan perangkat, tindakan, atau sumber daya yang berbeda.
Gambar 19. Menambahkan Konfigurasi Rerun.
Mulai uji coba
Setelah Anda memasukkan informasi yang diperlukan untuk uji coba, klik Mulai Uji Coba . Jika semua informasi valid, uji coba dimulai, dan Anda diarahkan ke halaman untuk melihat detail dan kemajuan uji coba.
Gambar 20. Memulai uji coba.
Buat rencana pengujian
Rencana pengujian digunakan untuk membuat pengujian berjalan pada jadwal berkala. Misalnya menjalankan CTS 9.0 setiap hari pada jam 5 sore. Untuk membuat rencana pengujian baru, klik Buat rencana pengujian baru .
Gambar 21. Membuat rencana pengujian.
Konfigurasikan rencana pengujian
Masukkan nama rencana pengujian dan label apa pun yang ingin Anda tambahkan. Kemudian pilih jadwal yang akan digunakan.
- Manual - Rencana pengujian membuat pengujian berjalan hanya ketika pengguna mengklik Jalankan rencana pengujian di halaman daftar rencana pengujian.
- Berkala - Rencana pengujian secara otomatis menjadwalkan pengujian berjalan pada jadwal periodik yang dipilih. Misalnya menjadwalkan uji coba setiap hari pada pukul 17.00.
- Kustom - Rencana pengujian secara otomatis menjadwalkan pengujian berjalan berdasarkan ekspresi cron yang dimasukkan. Misalnya, untuk menjadwalkan pengujian yang dijalankan setiap hari pada pukul 17.00, ekspresi cronnya adalah
0 17 * * *
.
Gambar 22. Mengonfigurasi rencana pengujian.
Tambahkan rangkaian pengujian
Tambahkan rangkaian pengujian yang ingin Anda jadwalkan menurut rencana pengujian dengan mengeklik + Tambahkan konfigurasi uji coba . Pilih rangkaian pengujian dari tarik-turun Nama dan klik Langkah berikutnya . Kemudian pilih perangkat tempat Anda ingin menjalankan pengujian dan klik Tambahkan Konfigurasi . Anda dapat menambahkan beberapa konfigurasi untuk setiap rencana pengujian.
Gambar 23. Mengonfigurasi uji coba.
Tambahkan tindakan perangkat
Tambahkan tindakan perangkat yang ingin Anda jalankan sebelum setiap pengujian dijalankan. Lihat Menambahkan tindakan perangkat untuk detail selengkapnya.
Gambar 24. Menambahkan tindakan perangkat.
Tetapkan sumber daya pengujian
Menambahkan sumber daya pengujian ke rencana pengujian sama dengan menambahkannya ke pengujian individual. Lihat Mengatur sumber daya pengujian untuk detail selengkapnya.
Gambar 25. Menetapkan sumber daya pengujian.
Lihat uji coba yang dijalankan
Daftar uji coba
Lihat daftar uji coba terjadwal di halaman Uji Coba. Klik Lihat untuk melihat detail selengkapnya tentang uji coba.
Anda juga dapat memfilter daftar dengan memasukkan string ke dalam bilah filter dan menekan tombol Enter . Anda dapat menggunakan beberapa filter dengan memisahkannya menggunakan koma. Filter mengembalikan semua baris yang berisi teks persis (tidak ada substring yang cocok) di kolom mana pun, kecuali Status dan Created .
Filter kosong mengembalikan semua baris. Saat ini tidak ada cara untuk memfilter baris dengan nilai kosong.
Gambar 26. Daftar uji coba.
Detail uji coba
Anda dapat melihat detail pengujian yang dijalankan di sini, seperti status, log, dan hasil.
Gambar 27. Detail uji coba.
Status uji coba
Kemajuan uji coba ditampilkan di bagian Status. Jika ada pesan terkait, seperti kemajuan pengunduhan, alasan pembatalan, atau pesan kesalahan, pesan tersebut juga ditampilkan di sini.
Gambar 28. Status uji coba.
Status uji coba adalah:
- Tertunda - Sumber daya yang diperlukan sedang diunduh.
- Antri - Tes siap dijalankan saat perangkat tersedia.
- Berjalan - Tes berjalan pada perangkat yang dialokasikan.
- Selesai - Tes telah selesai dan melaporkan hasilnya.
- Dibatalkan - Tes dibatalkan oleh pengguna atau waktunya habis saat mencoba mencari perangkat yang tersedia.
- Kesalahan - Terjadi kesalahan yang mencegah pengujian berjalan.
Batalkan uji coba
Jika uji coba belum selesai, Anda dapat membatalkannya dengan mengklik Batal lalu mengklik Ya di dialog konfirmasi. Uji coba yang dijalankan juga dibatalkan secara otomatis jika uji tersebut tetap berada dalam status Antrian lebih lama dari kolom queue_timeout_seconds . Membatalkan uji coba saat berada dalam status Berjalan mungkin memerlukan waktu beberapa menit untuk diterapkan.
Gambar 29. Membatalkan uji coba.
Hasil uji coba
Setelah uji coba selesai, hasilnya dikumpulkan dan ditampilkan. Anda dapat melihat detail tambahan dengan mengeklik panah untuk setiap proses. Klik Lihat File Output untuk melihat artefak pengujian yang dikumpulkan, seperti test_result.xml
dan test_result_failures.html
.
Gambar 30. Hasil uji coba.
Anda dapat melihat log host langsung dan log Tradefed di tab Log.
Gambar 31. Tab Log.
Hasil untuk masing-masing modul ada di tab Hasil Tes.
Gambar 32. Tab Hasil Tes.
Anda dapat mengunduh file yang digunakan sebagai sumber pengujian dengan mengklik Buka di tab Sumber Daya Pengujian.
Gambar 33. Tab Sumber Daya Uji.
Untuk melihat detail pengujian yang dijalankan, seperti create_time , buka tab Config.
Gambar 34. Tab konfigurasi.
Fitur lanjutan
Kelola file konfigurasi
Android Test Station menggunakan file konfigurasi yang ditulis dalam YAML untuk memuat opsi yang telah ditentukan sebelumnya seperti pengujian, saluran build, dan tindakan perangkat. Contoh file konfigurasi untuk beberapa opsi ditunjukkan di bawah.
// example_file.yaml
tests:
- id : android.cts.9_0.arm
name: CTS 9.0 (ARM)
test_resource_defs:
- name: android-cts.zip
default_download_url: https://dl.google.com/dl/android/cts/android-cts-9.0_r7-linux_x86-arm.zip
test_resource_type: TEST_PACKAGE
command: cts
env_vars:
- name: TF_PATH
value: ${TF_WORK_DIR}/android-cts/tools:${TF_WORK_DIR}/android-cts/testcases
- name: LD_LIBRARY_PATH
value: ${TF_WORK_DIR}/android-cts/lib:${TF_WORK_DIR}/android-cts/lib64
setup_scripts:
output_file_patterns:
- android-cts/logs/latest/.*
- android-cts/results/latest/.*\.html
- android-cts/results/latest/compatibility_result\..*
- android-cts/results/latest/logo.png
- android-cts/results/latest/test_result.xml
result_file: test_result.xml
java_properties:
- name: CTS_ROOT
value: ${TF_WORK_DIR}
context_file_dir: android-cts/results/
context_file_pattern: '[\d_\.]+\.zip'
retry_command_line: retry --retry 0
runner_sharding_args: --shard-count ${TF_SHARD_COUNT}
build_channels:
- id: google_drive
name: Google Drive
provider_name: Google Drive
device_actions:
- id: flash
name: Flash
test_resource_defs:
- name: bootloader.img
test_resource_type: DEVICE_IMAGE
- name: radio.img
test_resource_type: DEVICE_IMAGE
- name: img.zip
test_resource_type: DEVICE_IMAGE
tradefed_target_preparers:
- class_name: com.android.tradefed.targetprep.RunHostCommandTargetPreparer
option_values:
- name: work-dir
values:
- ${TF_WORK_DIR}
- name: host-setup-command
values:
- adb -s $SERIAL reboot-bootloader
- fastboot -s $SERIAL flash bootloader bootloader.img
- fastboot -s $SERIAL flash radio radio.img
- fastboot -s $SERIAL reboot-bootloader
- fastboot -s $SERIAL -w update img.zip
- adb -s $SERIAL wait-for-device
- name: host-cmd-timeout
values:
- 10m
Saat menyiapkan instance Android Test Station, Anda dapat berbagi konfigurasi dengan pengguna lain dengan mengekspornya sebagai file. Untuk melakukan ini, buka halaman Pengaturan dan klik Ekspor di kanan atas.
Gambar 35. Manajemen file konfigurasi.
Setelah file konfigurasi Anda diunduh, bagikan file tersebut dengan pengguna lain. Mereka dapat menambahkan file konfigurasi ke instance Android Test Station dengan mengklik Impor dan memilih file konfigurasi.
Buat tindakan perangkat baru
Tindakan perangkat digunakan untuk mengotomatiskan proses penyiapan perangkat. Tindakan adalah skrip yang dijalankan pada setiap perangkat tempat pengujian dijalankan sebelum setiap pengujian dijalankan, termasuk sebelum percobaan ulang. Untuk melihat daftar tindakan perangkat yang tersedia, buka halaman Pengaturan dan klik tab Tindakan Perangkat. Beberapa tindakan perangkat sudah dikonfigurasi, seperti me-reboot dan mem-flash.
Gambar 36. Tab Tindakan Perangkat.
Tambahkan tindakan perangkat baru
Klik Tindakan perangkat baru .
Gambar 37. Tombol tindakan perangkat baru.
Masukkan nama dan deskripsi.
Gambar 38. Nama tindakan perangkat.
Klik Tambahkan Penyiap Target .
Masukkan nama lengkap kelas Trade Federation Target Preparer, misalnya,
com.android.tradefed.targetprep.RunHostCommandTargetPreparer
.Gambar 39. Menambahkan target preparer.
Daftar pembuat target yang tersedia dapat ditemukan di referensi com.android.tradefed.targetprep .
Gambar 40. Daftar Target Penyusun.
Tambahkan opsi apa pun untuk digunakan dengan pembuat target. Untuk melihat opsi yang tersedia, periksa targetprep untuk kode sumber setiap pembuat target di AOSP:
Gambar 41. Contoh opsi tindakan.
Untuk menambahkan opsi, klik Tambahkan Opsi Persiapan Target dan masukkan nilai yang diperlukan.
Gambar 42. Contoh perintah tindakan.
Tentukan sumber daya pengujian yang diperlukan untuk menjalankan tindakan perangkat, misalnya, membuat gambar untuk mem-flash. Untuk menambahkan definisi sumber daya, klik Tambahkan Sumber Daya Uji dan isi bidang yang wajib diisi. Jika Anda tahu di mana file Anda berada, Anda dapat memberikan URL unduhan default dengan mengeklik telusuri . Jika pembuat target menerima direktori sebagai sumber daya pengujian, pilih Dekompresi . Kemudian tentukan direktori Tujuan relatif di bawah direktori kerja sementara dan Nama File yang akan didekompresi. Jika tidak ada nama file yang diberikan, semua file akan didekompresi dari sumber pengujian.
Gambar 43. Sumber daya uji tindakan.
Klik Perbarui .
Gambar 44. Tindakan menyimpan perubahan.
Kelola tes
Edit tes
Untuk mengedit tes yang disimpan, buka halaman Tes dan klik Edit pada baris tes yang ingin Anda modifikasi. Setelah mengubah konfigurasi pengujian, klik Perbarui .
Gambar 45. Mengedit tes.
Tambahkan tes baru
Untuk menambahkan tes baru, buka halaman Tes dan klik Buat Tes Baru . Masukkan informasi yang sesuai dan klik Buat .
Gambar 46. Membuat tes.
Gambar 47. Menyalin tes.
Ekspor konfigurasi host
Setelah mengonfigurasi host, Anda dapat mengekspor konfigurasi host ke file. Anda dapat mengunggah file ini ke host lain untuk menyalin konfigurasi yang disimpan.
Untuk mengekspor konfigurasi host, buka halaman Pengaturan dan klik Ekspor di sudut kanan atas.
Gambar 48. Mengekspor konfigurasi host.
Untuk mengimpor file konfigurasi host, buka halaman Pengaturan dan klik Impor di sudut kanan atas.
Gambar 49. Mengimpor konfigurasi host.
Gunakan file dan direktori lokal
Mulai versi R11, file di direktori $HOME/.ats_storage
secara otomatis dapat diakses di Android Test Station. Salin atau pindahkan file ke direktori tersebut, lalu Anda dapat memilihnya dari tab File Lokal saat menjadwalkan uji coba.
cp /path/to/file $HOME/.ats_storage
Gambar 50. Memilih file dari direktori $HOME/.ats_storage
.
Anda dapat memasang direktori tambahan ke penyimpanan file lokal dengan flag --mount_local_path
.
mtt start --mount_local_path=/path/to/dir1 --mount_local_path=/path/to/dir2:renamed_dir2
Gambar 51. Direktori tambahan dipasang di penyimpanan file lokal.
Aktifkan mode multi-host
Dengan mode Multi-host, pengguna dapat menggunakan satu host pengontrol ATS untuk mengelola perangkat dan melakukan pengujian pada beberapa host pekerja ATS.
Gambar 52. Arsitektur mode multi-host.
Untuk memulai pengontrol ATS, gunakan perintah berikut:
mtt start --operation_mode=ON_PREMISE
Pengontrol pemeriksaan dapat diakses di
http://${CONTROLLER_HOSTNAME}:8000
.Untuk memulai pekerja, gunakan perintah berikut:
mtt start --control_server_url=http://CONTROLLER_HOSTNAME:8000 --operation_mode=ON_PREMISE
Jika jaringan Anda tidak mengizinkan host untuk berkomunikasi satu sama lain, Anda harus mengikuti petunjuk penyiapan lebih lanjut di bawah tentang pekerja ATS.
Hubungkan kedua host menggunakan terowongan SSH. Pilih port untuk port utama dan server file, misalnya 9000 dan 9006.
ssh -L ATS_PORT:localhost:8000 -L FS_PORT:localhost:8006 CONTROLLER_HOSTNAME
Konfigurasikan dan mulai ATS.
DOCKER_GATEWAY_IP_ADDRESS=$(ip -4 addr show dev docker0 | grep -Eo 'inet [.0-9]+/' | grep -Eo '[.0-9]+')
socat tcp-listen:ATS_PORT,bind="${DOCKER_GATEWAY_IP_ADDRESS}",reuseaddr,fork tcp-connect:127.0.0.1:ATS_PORT &
socat tcp-listen:FS_PORT,bind="${DOCKER_GATEWAY_IP_ADDRESS}",reuseaddr,fork tcp-connect:127.0.0.1:FS_PORT &
mtt start --control_server_url=http://${DOCKER_GATEWAY_IP_ADDRESS}:ATS_PORT \ --control_file_server_url=http://${DOCKER_GATEWAY_IP_ADDRESS}:FS_PORT \ --operation_mode=ON_PREMISE
Pembersih berkas
Pembersih file adalah tugas cron yang dijalankan setiap jam untuk membersihkan file berdasarkan konfigurasi yang ditentukan pengguna. ATS memiliki dua konfigurasi default untuk mengarsipkan hasil uji coba dan menghapus file sementara. Panduan ini menjelaskan cara menyesuaikan kebijakan dan konfigurasi untuk mengelola file Anda secara efektif.
Kebijakan
Kebijakan menentukan operasi yang akan dilakukan pada file atau direktori, dan kriteria untuk memilih target. Operasi yang tersedia ditunjukkan pada tabel:
Jenis operasi | Parameter |
---|---|
ARCHIVE | remove_file : Jika true , hapus file setelah pengarsipan. |
DELETE |
Kriteria didasarkan pada atribut file dan informasi sistem. Kriteria yang tersedia ditunjukkan pada tabel:
Jenis kriteria | Keterangan | Parameter |
---|---|---|
LAST_MODIFIED_TIME | Filter file berdasarkan tanggal dan waktu modifikasi terakhirnya. | ttl : Berbagai macam ekspresi waktu didukung, misalnya, 10m , 2h , 7 days , 4w . Lihat pytimeparse untuk format yang didukung. |
LAST_ACCESS_TIME | Filter file berdasarkan tanggal dan waktu akses terakhirnya. | Sama seperti LAST_MODIFIED_TIME . |
NAME_MATCH | Filter file berdasarkan namanya menggunakan ekspresi reguler. | pattern : Ekspresi reguler, misalnya, [a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}\.zip untuk mencocokkan ritsleting hasil. |
SYSTEM_AVAILABLE_SPACE | Memicu tindakan berdasarkan ruang yang tersedia di sistem. | threshold : Memicu tindakan ketika ruang yang tersedia berada di bawah ambang batas, misalnya, 200 (B), 200KB , 200MB , 200GB , 2TB . |
Gambar 53. Tambahkan kebijakan pembersih file baru.
Konfigurasi
Konfigurasi menggabungkan satu atau lebih kebijakan dengan direktori tertentu. File dan direktori dalam direktori tertentu diproses berdasarkan kebijakan yang ditentukan. Kebijakan diterapkan sesuai urutan kemunculannya di konfigurasi.
Semua direktori target harus ditempatkan di bawah direktori /data
. Jika konfigurasi Anda menentukan direktori target sebagai logs
, itu ditafsirkan sebagai /data/logs
.
Gambar 54. Edit file konfigurasi pembersih.
Mengatur ulang
Mengklik Reset Settings akan mengembalikan konfigurasi pembersih file ke keadaan default. Tindakan ini menghapus SEMUA item khusus.
Gambar 55. Reset pengaturan pembersih file.
Mendukung
Laporan bug
Kontribusi Anda pada Android Test Station membantu meningkatkan pengembangan alat ini, dan kami menginginkan masukan Anda! Lihat catatan rilis ATS untuk rincian tentang rilis terbaru. Untuk melaporkan bug atau menawarkan saran, silakan ajukan laporan bug . Mitra harus melaporkan bug atau saran melalui saluran mitra mereka.