Stasiun Uji Android

Android Test Station adalah alat pengujian yang dapat digunakan pengembang dan teknisi pengujian Android untuk menggunakan antarmuka pengguna untuk menjalankan rangkaian pengujian Android standar, seperti Android Compatibility Test Suite (CTS) . Alat ini berfungsi sebagai antarmuka web untuk Trade Federation (TF) , yang memungkinkan Anda menjalankan CTS dengan mudah pada satu set perangkat uji dengan pengaturan minimal, serta menetapkan jadwal untuk menjalankan pengujian secara terus-menerus.

Menyiapkan Android Test Station

Bagian ini menjelaskan cara memasang dan menyiapkan Android Test Station.

Android Test Station menggunakan kode sumber dari lokasi berikut:

Memasang Stasiun Uji Android

Ikuti semua persyaratan perangkat keras dan perangkat lunak untuk rangkaian pengujian yang ingin Anda jalankan.

Persyaratan untuk CTS dapat ditemukan di source.android.com .

Tidak ada persyaratan perangkat keras tambahan, tetapi kami menyarankan untuk menggunakan mesin dengan ruang hard drive kosong 100 GB dan memori 8 GB, yang cukup untuk menyimpan file keluaran dari beberapa rangkaian pengujian.

Ada dua cara untuk menginstal Android Test Station:

Menginstal dengan program penginstal

Di Ubuntu 18.04+, program penginstal menginstal dan mengonfigurasi semua program dan sumber daya yang diperlukan untuk menjalankan Android Test Station.

Untuk menggunakan program penginstalan:

  1. Jalankan program penginstal:

    curl https://storage.googleapis.com/android-mtt.appspot.com/prod/install.sh | bash
    
  2. Jalankan mtt version untuk memeriksa versi terinstal Android Test Station CLI.

Menginstal secara manual

Menginstal Docker
  1. Ikuti instruksi untuk menginstal Docker Community Edition (CE) di mesin Linux Anda.

  2. Ikuti langkah-langkah pasca-instalasi untuk mengelola Docker sebagai pengguna non-root .

  3. Anda mungkin perlu memulai ulang jendela terminal atau keluar dan masuk lagi agar perubahan izin diterapkan.

Menginstal Python 3.7

Android Test Station CLI membutuhkan Python 3.7.

Untuk Ubuntu 16.04 atau yang lebih lama, Anda perlu menambahkan repositori untuk Python 3.7 terlebih dahulu, dengan melakukan salah satu hal berikut:

  • Jalankan perintah ini:

    sudo add-apt-repository ppa:deadsnakes/ppa
    
  • Atau buat dan instal repositori dari sumbernya

Untuk menginstal Python 3.7, jalankan perintah ini:

sudo apt-get update
sudo apt install python3.7 python3.7-distutils
Mendapatkan Android Test Station CLI

Unduh paket antarmuka baris perintah (CLI) di sini.

Memulai Stasiun Uji Android

Mulai Android Test Station dengan perintah berikut:

mtt start

Pertama kali UI dimulai, mungkin perlu beberapa menit untuk muncul. CLI menampilkan URL web untuk mengakses UI di browser. Secara default, URL webnya adalah localhost:8000 . Jika perlu, 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

Mencadangkan dan memulihkan basis data

Untuk mencadangkan basis data ATS, hentikan aplikasi dan jalankan perintah berikut, yang mencadangkan basis data 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, Setup Wizard akan membawa 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.

Memulihkan cadangan konfigurasi

Jika Anda memiliki file konfigurasi yang dicadangkan dari host Android Test Station lain, Anda dapat mengunggah file untuk menyalin konfigurasi apa pun yang dimodifikasi dari host tersebut dengan mengeklik tombol Unggah File .

Kembalikan Cadangan Konfigurasi

Gambar 1. Memulihkan Cadangan Konfigurasi

Menyetel 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.

Setel Akun Layanan

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.

Ubah akun layanan

Gambar 3. Mengubah akun layanan

Mengimpor set konfigurasi

Kumpulan konfigurasi adalah kumpulan konfigurasi untuk menjalankan rangkaian pengujian, termasuk tindakan perangkat terkait, saluran build, dll. Kumpulan konfigurasi dihosting di bucket Google Cloud Storage (GCS) tertentu. Setelah mengautentikasi saluran build GCS dengan akun Google Anda, Anda akan melihat daftar semua set konfigurasi yang tersedia untuk Anda.

Pilih set konfigurasi yang ingin Anda tambahkan ke host Stasiun Pengujian Anda dan klik Impor yang Dipilih .

Impor Set Konfigurasi

Gambar 4. Mengimpor Set Konfigurasi

Termasuk pengaturan Wi-Fi

Beberapa pengujian CTS mengharuskan perangkat Anda terhubung ke hotspot Wi-Fi. Untuk memilih jaringan Wi-Fi Anda, masukkan SSID WiFi dan PSK WiFi opsional .

Pengaturan Wi-Fi

Gambar 5. Pengaturan hotspot Wi-Fi

Setelah menyelesaikan Wizard Penyiapan, halaman akan dimuat ulang dengan pengaturan baru yang diterapkan.

Menghubungkan perangkat

USB debugging harus diaktifkan untuk menggunakan perangkat untuk pengujian. Untuk mengaktifkan debugging:

  1. Ikuti petunjuk di Aktifkan opsi pengembang dan debugging .

  2. Jika Anda berencana menggunakan build Android pengujian yang dimuat sebelumnya dengan kunci ADB khusus, letakkan file .adb_key khusus di bawah direktori ~/.android/ .

    File dimuat secara otomatis dan diteruskan ke ADB untuk mengaktifkan USB debugging secara otomatis setelah perangkat di-flash untuk perangkat yang menjalankan build tersebut.

  3. Hubungkan perangkat ke mesin host menggunakan USB.

    Perangkat akan muncul di tab Perangkat Android Test Station dalam satu menit setelah menyegarkan antarmuka web. Anda juga dapat melihat status perangkat di tab ini.

    Hubungkan Perangkat

    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 pada satu waktu, sehingga perangkat harus menyelesaikan pengujian saat ini sebelum menjalankan yang baru.

Menjalankan tes

Memilih tes

Android Test Station hadir dengan serangkaian konfigurasi CTS yang sudah dibundel. Untuk menjalankan salah satu tes ini, buka tab Test Suites dan klik Run test untuk tes yang diinginkan.

Pilih Tes

Gambar 7. Memilih tes

Untuk mengedit atau menambahkan pengujian baru, lihat Menambahkan pengujian .

Mengonfigurasi uji coba

Edit parameter yang akan digunakan untuk uji coba khusus ini. Sebagian besar parameter telah diisi sebelumnya dengan nilai yang ditentukan dalam konfigurasi pengujian yang dipilih.

Langkah ini dapat diselesaikan menggunakan nilai default, tetapi Anda dapat mengubah parameter apa pun, seperti Max Retry dan Command , agar sesuai dengan kebutuhan Anda.

Konfigurasikan Uji Jalan

Gambar 8. Mengonfigurasi uji coba

Parameter uji coba adalah:

  • Name - Nama test suite yang ingin Anda jalankan.
  • Hitungan Jalan - Berapa kali uji coba ini harus dijalankan saat dijadwalkan. Uji coba dijadwalkan menggunakan Trade Federation , yang menjalankan hingga 20 uji coba secara paralel jika ada kapasitas untuk melakukannya.
  • Max Retry - Jumlah maksimum kali untuk mencoba kembali uji coba jika setidaknya satu pengujian gagal. Ini biasanya diatur ke 4–6 percobaan ulang untuk menjalankan CTS penuh untuk menangani tes yang tidak stabil.
  • Timeout Antrian - Jika uji coba tetap dalam status Antrian terlalu lama, itu akan dibatalkan secara otomatis. Tentukan lama waktu menunggu sebelum pembatalan di sini. Standarnya adalah 24 jam.
  • Command - Perintah untuk menjalankan test suite. Anda dapat memasukkan argumen baris perintah tambahan di sini. Misalnya, jalankan modul tertentu di CTS 8.1 dengan:

    cts-suite -m ShortModuleName
    
  • Perintah Coba Ulang - Perintah untuk mencoba kembali rangkaian pengujian. Anda dapat menambahkan argumen baris perintah tambahan di sini. Misalnya, untuk mencoba kembali hanya modul tertentu di CTS 8.1, gunakan:

    cts --retry 0 -m ShortModuleName
    

    Argumen coba lagi 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 kembali uji coba sebelumnya:

    • Lokal - Jika proses dimulai pada host saat ini, masukkan ID uji coba yang terlihat saat melihat detail uji coba.

      Uji Coba Lokal Sebelumnya

      Gambar 9. Uji coba lokal sebelumnya

    • Jarak Jauh - Jika proses dimulai pada host yang berbeda, unggah file hasil pengujian dengan memilih Jarak Jauh , klik Unggah File Hasil Tes , dan pilih file dari penyimpanan lokal Anda.

      Uji Coba Sebelumnya Jarak Jauh

      Gambar 10. Uji coba jarak jauh sebelumnya

Memilih perangkat

Klik kotak centang untuk memilih perangkat yang akan dialokasikan untuk menjalankan rangkaian pengujian. Hitungan pecahan harus secara otomatis berubah agar sesuai dengan jumlah perangkat yang dipilih.

Pilih Perangkat

Gambar 11. Memilih perangkat

Untuk memilih perangkat menurut atribut selain serial perangkat, Anda dapat memasukkan "Spesifikasi Perangkat" secara manual. Misalnya, untuk memilih 3 perangkat yang nama produknya "bramble", masukkan berikut ini:

product:bramble;product:bramble;product:bramble

Atribut yang didukung adalah:

  • build_id
  • perangkat_serial
  • tipe perangkat
  • nama host
  • produk
  • produk_varian
  • sim_state

Semua perangkat yang dipilih harus dalam status Tersedia untuk menjalankan uji coba, dan semuanya beralih ke status Alokasi saat uji coba dijalankan. Uji coba berada dalam status Antrian saat menunggu perangkat tersedia.

Menambahkan tindakan perangkat

Tindakan perangkat adalah skrip yang dapat dieksekusi sebelum setiap pengujian dijalankan. Beberapa tindakan perangkat sudah dikonfigurasi, seperti mem-flash dan mem-boot ulang. Untuk membuat tindakan perangkat baru, lihat Membuat tindakan perangkat baru .

Tindakan Perangkat

Gambar 12. Tindakan perangkat

Untuk menambahkan tindakan perangkat ke uji coba, klik Tambahkan tindakan baru , centang kotak untuk tindakan yang akan ditambahkan, dan klik Tambahkan Tindakan . Tindakan perangkat dilakukan secara berurutan. Anda dapat menyusun ulang tindakan dengan menyeretnya.

Tambahkan Tindakan

Gambar 13. Tindakan penataan ulang

Menyetel sumber daya pengujian

Sumber daya pengujian adalah file yang diperlukan untuk menjalankan uji coba. Misalnya, menjalankan CTS memerlukan file android-cts*.zip , dan mem-flash perangkat mengharuskan Anda menyediakan gambar build.

URL unduhan untuk file zip suite pengujian harus default ke tautan Google Drive yang diberikan kepada mitra. Anda dapat memilih file yang berbeda dengan mengklik browse . Di jendela sembulan, Anda dapat memasukkan tautan unduhan file, menggunakan file dari saluran build yang diautentikasi, atau mengunggah file untuk digunakan dari penyimpanan lokal.

Sumber Daya Tes

Gambar 14. Sumber daya pengujian

Di bawah ini adalah jendela sembulan untuk memilih sumber daya pengujian dengan URL web. Anda cukup memasukkan tautan url unduhan, dan klik tombol Pilih untuk mengonfirmasi pilihan.

Pemilih Sumber Daya Uji - URL Web

Gambar 15. Pemilih Sumber Daya Uji - URL Web

Jika Anda telah mengunggah sumber daya ke Google Grive, Google Cloud Storage (GCS), atau saluran lain, Anda juga dapat menavigasi ke tab saluran tertentu dan memilih sumber daya di sana. Berikut adalah contoh untuk memilih sumber daya dari google drive.

Pemilih Sumber Daya Uji - Google Drive

Gambar 16. Pemilih Sumber Daya Uji - Google Drive

Selain hanya memilih file, karakter wildcard juga didukung di bidang Filename . Dokumentasinya dapat ditemukan di sini .

Test Resource Selector - Dukungan Pola Wildcard

Gambar 17. Pemilih Sumber Daya Uji - 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 .

Pemilih Sumber Daya Uji - Toko Berkas Lokal

Gambar 18. Pemilih Sumber Daya Uji - Penyimpanan file lokal

Menambahkan konfigurasi ulang

Anda dapat menjadwalkan pemutaran ulang yang akan dimulai setelah proses utama selesai dan memuat hasilnya, tetapi dapat menggunakan perangkat, tindakan, atau sumber daya yang berbeda.

Tambahkan Konfigurasi Ulang

Gambar 19. Menambahkan Konfigurasi Jalankan Ulang

Memulai 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.

Mulai Uji Coba

Gambar 20. Memulai uji coba

Membuat 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 .

Buat Rencana Tes

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 hanya akan membuat pengujian berjalan ketika pengguna mengklik Jalankan rencana pengujian di halaman daftar rencana pengujian.
  • Berkala - Rencana pengujian akan secara otomatis menjadwalkan pengujian berjalan pada jadwal periodik yang dipilih. Misalnya, menjadwalkan uji coba setiap hari pada pukul 17.00.
  • Kustom - Rencana pengujian akan secara otomatis menjadwalkan pengujian berdasarkan ekspresi cron yang dimasukkan. Misalnya, untuk menjadwalkan uji coba setiap hari pada pukul 17.00, ekspresi cron akan menjadi 0 17 * * * .

Konfigurasikan Rencana Uji

Gambar 22. Mengonfigurasi rencana pengujian

Tambahkan suite pengujian

Tambahkan rangkaian pengujian yang ingin Anda jadwalkan menurut rencana pengujian dengan mengeklik + Tambahkan konfigurasi uji coba . Pilih rangkaian uji dari menu tarik-turun Nama dan klik Langkah berikutnya . Kemudian pilih perangkat tempat Anda ingin menjalankan tes dan klik Add Configuration . Anda dapat menambahkan beberapa konfigurasi untuk setiap rencana pengujian.

Konfigurasikan Uji Jalan

Gambar 23. Mengonfigurasi uji coba

Tambahkan tindakan perangkat

Tambahkan tindakan perangkat yang ingin Anda jalankan sebelum setiap uji coba. Lihat Menambahkan tindakan perangkat untuk detail selengkapnya.

Tambahkan Tindakan Perangkat

Gambar 24. Menambahkan tindakan perangkat

Setel sumber daya pengujian

Menambahkan sumber daya pengujian ke rencana pengujian sama dengan menambahkannya ke pengujian individu. Lihat Menyetel sumber daya pengujian untuk detail selengkapnya.

Setel Sumber Daya Pengujian

Gambar 25. Mengatur sumber daya pengujian

Melihat uji coba

Daftar uji coba

Lihat daftar uji coba terjadwal di halaman Uji Jalan. Klik Lihat untuk melihat detail selengkapnya tentang uji coba.

Anda juga dapat memfilter daftar dengan memasukkan string ke bilah filter dan menekan tombol Enter . Anda dapat menggunakan beberapa filter dengan memisahkannya dengan koma. Filter mengembalikan semua baris yang berisi teks persis (tidak ada substring yang cocok) di kolom mana pun, tidak termasuk Status dan Created .

Filter kosong mengembalikan semua baris. Saat ini tidak ada cara untuk memfilter baris dengan nilai kosong.

Daftar Uji Coba

Gambar 26. Daftar uji coba

Detail uji coba

Anda dapat melihat detail uji coba di sini, seperti status, log, dan hasil.

Detail Uji Coba

Gambar 27. Detail uji coba

Status uji coba

Kemajuan untuk uji coba ditampilkan di bagian Status. Jika ada pesan terkait, seperti kemajuan unduhan, alasan pembatalan, atau pesan kesalahan, itu juga akan ditampilkan di sini.

Status Uji Coba

Gambar 28. Status uji coba

Status uji coba adalah:

  • Tertunda - Sumber daya yang diperlukan sedang diunduh.
  • Antrian - 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 kehabisan waktu saat mencoba menemukan perangkat yang tersedia.
  • Kesalahan - Terjadi kesalahan yang mencegah pengujian berjalan.

Membatalkan uji coba

Jika uji coba belum selesai, Anda dapat membatalkannya dengan mengklik Batal , lalu mengklik Ya dalam dialog konfirmasi. Uji coba juga dibatalkan secara otomatis jika tetap dalam status Antrian lebih lama dari bidang queue_timeout_seconds . Membatalkan uji coba saat dalam status Berjalan mungkin memerlukan waktu beberapa menit untuk diterapkan.

Batalkan Uji Coba

Gambar 29. Membatalkan uji coba

Hasil uji coba

Setelah uji coba selesai, hasilnya akan dikumpulkan dan ditampilkan. Anda dapat melihat detail tambahan dengan mengklik panah untuk setiap putaran. Klik Lihat File Keluaran untuk melihat artefak uji yang dikumpulkan, seperti test_result.xml dan test_result_failures.html .

Hasil Uji Coba

Gambar 30. Hasil uji coba

Anda dapat melihat host langsung dan log Tradefed di tab Log.

Uji Coba Log

Gambar 31. Tab Log

Hasil untuk masing-masing modul ada di tab Hasil Tes.

Tab Hasil Tes

Gambar 32. Tab Hasil Pengujian

Anda dapat mengunduh file yang digunakan sebagai sumber pengujian dengan mengklik Buka di tab Sumber Daya Pengujian.

Tab Sumber Daya Tes

Gambar 33. Tab Sumber Daya Pengujian

Untuk melihat detail uji coba, seperti create_time , buka tab Config.

Tab Konfigurasi Uji

Gambar 34. Tab konfigurasi

Fitur lanjutan

Mengelola 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 ini.

// 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.

Manajemen File Konfigurasi

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 mereka dengan mengklik Impor dan memilih file konfigurasi.

Membuat 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 mem-boot ulang dan mem-flash.

Tab Tindakan Perangkat

Gambar 36. Tab Tindakan Perangkat

Menambahkan tindakan perangkat baru

  1. Klik Tindakan perangkat baru .

    Tombol Tindakan Perangkat Baru

    Gambar 37. Tombol aksi perangkat baru

  2. Masukkan nama dan deskripsi.

    Nama Tindakan Perangkat

    Gambar 38. Nama tindakan perangkat

  3. Klik Tambahkan Persiapan Target .

  4. Masukkan nama kelas lengkap Trade Federation Target Preparer, misalnya com.android.tradefed.targetprep.RunHostCommandTargetPreparer .

    Tambahkan Persiapan Target

    Gambar 39. Menambahkan penyusun target

    Daftar pembuat target yang tersedia dapat ditemukan di referensi com.android.tradefed.targetprep .

    Daftar Persiapan Target

    Gambar 40. Daftar Persiapan Target

  5. Tambahkan opsi apa pun untuk digunakan dengan penyusun target. Untuk melihat opsi yang tersedia, periksa targetprep untuk kode sumber untuk setiap persiapan target di AOSP:

    Contoh Opsi Tindakan

    Gambar 41. Contoh opsi tindakan

  6. Untuk menambahkan opsi, klik Tambahkan Opsi Persiapan Target dan masukkan nilai yang diperlukan.

    Contoh Perintah Tindakan

    Gambar 42. Contoh perintah aksi

  7. Tentukan sumber daya pengujian yang diperlukan untuk menjalankan tindakan perangkat, misalnya, membuat gambar untuk flashing. Untuk menambahkan definisi sumber daya, klik Tambahkan Sumber Daya Uji dan isi bidang yang diperlukan. Jika Anda mengetahui lokasi file Anda, Anda dapat memberikan URL unduhan default dengan mengeklik jelajahi . 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 didekompresi dari sumber daya pengujian.

    Sumber Daya Uji Tindakan

    Gambar 43. Sumber daya uji tindakan

  8. Klik Perbarui .

    Tindakan Simpan Perubahan

    Gambar 44. Tindakan simpan perubahan

Mengelola tes

Mengedit tes

Untuk mengedit tes yang disimpan, buka halaman Tes dan klik Edit pada baris tes yang ingin Anda ubah. Setelah mengubah konfigurasi pengujian, klik Perbarui .

Mengedit tes

Gambar 45. Mengedit tes

Menambahkan tes baru

Untuk menambahkan tes baru, buka halaman Tes dan klik Buat Tes Baru . Masukkan informasi yang sesuai dan klik Buat .

Buat tes

Gambar 46. Membuat tes

Salin tes

Gambar 47. Menyalin tes

Mengekspor konfigurasi host

Setelah Anda 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.

Mengekspor konfigurasi host

Gambar 48. Mengekspor konfigurasi host

Untuk mengimpor file konfigurasi host, buka halaman Pengaturan dan klik Impor di sudut kanan atas.

Mengimpor konfigurasi host

Gambar 49. Mengimpor konfigurasi host

Menggunakan file dan direktori lokal

Mulai dari versi R11, file di direktori $HOME/.ats_storage dapat diakses secara otomatis 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

Memilih file lokal

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

Direktori terpasang tambahan

Gambar 51. Direktori tambahan yang dipasang di penyimpanan file lokal

Aktifkan mode multi-host

Dengan mode Multi-host, pengguna dapat menggunakan satu host pengontrol ATS untuk mengelola perangkat dan menguji beberapa host pekerja ATS.

Arsitektur mode multi-host

Gambar 52. Arsitektur mode multi-host

  1. Untuk memulai pengontrol ATS, gunakan perintah berikut:

    mtt start --operation_mode=ON_PREMISE
    
  2. Periksa pengontrol dapat diakses di http://controller:8000.

  3. Untuk memulai pekerja, gunakan perintah berikut:

    mtt start --control_server_url=http://controller.com: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.

  1. Hubungkan kedua host menggunakan terowongan SSH. Pilih port untuk port utama dan file server, misalnya 9000 dan 9006.

    ssh -L ATS_PORT:localhost:8000 -L FS_PORT:localhost:8006 CONTROLLER_HOSTNAME
    
  2. Konfigurasi 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=${DOCKER_GATEWAY_IP_ADDRESS}:ATS_PORT \
                    --control_file_server_url=${DOCKER_GATEWAY_IP_ADDRESS}:FS_PORT \
                    --operation_mode=ON_PREMISE
    

Mendukung

Pelaporan Bug

Kontribusi Anda ke Android Test Station membantu meningkatkan pengembangan alat, dan kami membutuhkan masukan Anda! Lihat catatan rilis ATS untuk detail tentang rilis terbaru. Untuk melaporkan bug atau menawarkan saran, harap ajukan laporan bug . Mitra harus melaporkan bug atau saran melalui saluran mitra mereka.