AppCenterTest@1 - Tugas uji v1 App Center

Uji paket aplikasi dengan Visual Studio App Center.

Sintaks

# App Center test v1
# Test app packages with Visual Studio App Center.
- task: AppCenterTest@1
  inputs:
    appFile: # string. Alias: app. Required. Binary application file path. 
    artifactsDirectory: '$(Build.ArtifactStagingDirectory)/AppCenterTest' # string. Alias: artifactsDir. Required. Artifacts directory. Default: $(Build.ArtifactStagingDirectory)/AppCenterTest.
  # Prepare Tests
    #prepareTests: true # boolean. Alias: enablePrepare. Prepare tests. Default: true.
    frameworkOption: 'appium' # 'appium' | 'espresso' | 'calabash' | 'uitest' | 'xcuitest'. Alias: framework. Required when enablePrepare = true. Test framework. Default: appium.
    #appiumBuildDirectory: # string. Alias: appiumBuildDir. Required when enablePrepare = true && framework = appium. Build directory. 
    #espressoBuildDirectory: # string. Alias: espressoBuildDir. Optional. Use when enablePrepare = true && framework = espresso. Build directory. 
    #espressoTestApkFile: # string. Alias: espressoTestApkPath. Optional. Use when enablePrepare = true && framework = espresso. Test APK path. 
    #calabashProjectDirectory: # string. Alias: calabashProjectDir. Required when enablePrepare = true && framework = calabash. Project directory. 
    #calabashConfigFile: # string. Optional. Use when enablePrepare = true && framework = calabash. Cucumber config file. 
    #calabashProfile: # string. Optional. Use when enablePrepare = true && framework = calabash. Profile to run. 
    #calabashSkipConfigCheck: false # boolean. Optional. Use when enablePrepare = true && framework = calabash. Skip Configuration Check. Default: false.
    #uiTestBuildDirectory: # string. Alias: uitestBuildDir. Required when enablePrepare = true && framework = uitest. Build directory. 
    #uitestStorePath: # string. Optional. Use when enablePrepare = true && framework = uitest. Store file. 
    #uiTestStorePassword: # string. Alias: uitestStorePass. Optional. Use when enablePrepare = true && framework = uitest. Store password. 
    #uitestKeyAlias: # string. Optional. Use when enablePrepare = true && framework = uitest. Key alias. 
    #uiTestKeyPassword: # string. Alias: uitestKeyPass. Optional. Use when enablePrepare = true && framework = uitest. Key password. 
    #uiTestToolsDirectory: # string. Alias: uitestToolsDir. Optional. Use when enablePrepare = true && framework = uitest. Test tools directory. 
    #signInfo: # string. Optional. Use when framework = calabash || framework = uitest. Signing information. 
    #xcUITestBuildDirectory: # string. Alias: xcuitestBuildDir. Optional. Use when enablePrepare = true && framework = xcuitest. Build directory. 
    #xcUITestIpaFile: # string. Alias: xcuitestTestIpaPath. Optional. Use when enablePrepare = true && framework = xcuitest. Test IPA path. 
    #prepareOptions: # string. Alias: prepareOpts. Optional. Use when enablePrepare = true. Additional options. 
  # Run Tests
    #runTests: true # boolean. Alias: enableRun. Run tests. Default: true.
    credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required when enableRun = true. Authentication method. Default: serviceEndpoint.
    #serverEndpoint: # string. Required when enableRun = true && credsType = serviceEndpoint. App Center service connection. 
    #username: # string. Required when enableRun = true && credsType = inputs. App Center username. 
    #password: # string. Required when enableRun = true && credsType = inputs. App Center password. 
    appSlug: # string. Required when enableRun = true. App slug. 
    devices: # string. Required when enableRun = true. Devices. 
    #series: 'master' # string. Optional. Use when enableRun = true. Test series. Default: master.
    #dsymDirectory: # string. Alias: dsymDir. Optional. Use when enableRun = true. dSYM directory. 
    localeOption: 'en_US' # 'da_DK' | 'nl_NL' | 'en_GB' | 'en_US' | 'fr_FR' | 'de_DE' | 'ja_JP' | 'ru_RU' | 'es_MX' | 'es_ES' | 'user'. Alias: locale. Required when enableRun = true. System language. Default: en_US.
    #userDefinedLocale: # string. Optional. Use when enableRun = true && locale = user. Other locale. 
    #loginOptions: # string. Alias: loginOpts. Optional. Use when enableRun = true && credsType = inputs. Additional options for login. 
    #runOptions: # string. Alias: runOpts. Optional. Use when enableRun = true. Additional options for run. 
    #skipWaitingForResults: false # boolean. Alias: async. Optional. Use when enableRun = true. Do not wait for test result. Default: false.
  # Advanced
    #cliFile: # string. Alias: cliLocationOverride. App Center CLI location. 
    #showDebugOutput: false # boolean. Alias: debug. Enable debug output. Default: false.

Input

appFile - Jalur file aplikasi biner
Alias input: app. string. Wajib diisi.

Jalur relatif dari akar repositori ke file APK atau IPA yang ingin Anda uji.

artifactsDirectory - Direktori artefak
Alias input: artifactsDir. string. Wajib diisi. Nilai default: $(Build.ArtifactStagingDirectory)/AppCenterTest.

Menentukan tempat menempatkan artefak yang dihasilkan oleh langkah persiapan dan digunakan oleh langkah eksekusi. Direktori ini akan dibuat jika belum ada.

prepareTests - Menyiapkan tes
Alias input: enablePrepare. boolean. Nilai default: true.

Ketika diatur ke true, input ini menyiapkan pengujian.

frameworkOption - Kerangka kerja pengujian
Alias input: framework. string. Diperlukan saat enablePrepare = true. Nilai yang diizinkan: appium, espresso, calabash, uitest (Uji UI Xamarin), xcuitest. Nilai default: appium.

appiumBuildDirectory - Buat direktori
Alias input: appiumBuildDir. string. Diperlukan saat enablePrepare = true && framework = appium.

Jalur ke direktori dengan tes Appium.

espressoBuildDirectory - Buat direktori
Alias input: espressoBuildDir. string. Pilihan. Gunakan saat enablePrepare = true && framework = espresso.

Jalur ke direktori output Espresso.

espressoTestApkFile - Uji jalur APK
Alias input: espressoTestApkPath. string. Pilihan. Gunakan saat enablePrepare = true && framework = espresso.

Jalur ke file APK dengan pengujian Espresso. Jika tidak diatur, build-dir digunakan untuk menemukannya. Kartubebas diperbolehkan.

calabashProjectDirectory - Direktori proyek
Alias input: calabashProjectDir. string. Diperlukan saat enablePrepare = true && framework = calabash.

Jalur ke direktori ruang kerja Calabash.

calabashConfigFile - File konfigurasi mentimun
string. Opsional. Gunakan saat enablePrepare = true && framework = calabash.

Jalur ke file konfigurasi Mentimun, biasanya cucumber.yml.

calabashProfile - Profil yang akan dijalankan
string. Pilihan. Gunakan saat enablePrepare = true && framework = calabash.

Profil yang akan dijalankan. Nilai ini harus ada dalam file konfigurasi Mentimun.

calabashSkipConfigCheck - Lewati Pemeriksaan Konfigurasi
boolean. Pilihan. Gunakan saat enablePrepare = true && framework = calabash. Nilai default: false.

Ketika diatur ke true, input ini melewati pemeriksaan konfigurasi yang ditentukan oleh profil Mentimun.

uiTestBuildDirectory - Buat direktori
Alias input: uitestBuildDir. string. Diperlukan saat enablePrepare = true && framework = uitest.

Jalur ke direktori dengan rakitan pengujian yang dibuat.

uitestStorePath - Simpan file
string. Pilihan. Gunakan saat enablePrepare = true && framework = uitest.

Jalur ke file penyimpanan yang digunakan untuk menandatangani aplikasi.

uiTestStorePassword - Simpan kata sandi
Alias input: uitestStorePass. string. Pilihan. Gunakan saat enablePrepare = true && framework = uitest.

Kata sandi file penyimpanan yang digunakan untuk menandatangani aplikasi. Untuk mengenkripsi nilai ini, gunakan variabel baru dengan kuncinya diaktifkan pada tab Variabel.

uitestKeyAlias - Alias kunci
string. Pilihan. Gunakan saat enablePrepare = true && framework = uitest.

Menentukan alias yang mengidentifikasi pasangan kunci publik/privat yang digunakan dalam file penyimpanan.

uiTestKeyPassword - Kata sandi kunci
Alias input: uitestKeyPass. string. Pilihan. Gunakan saat enablePrepare = true && framework = uitest.

Menentukan kata sandi kunci untuk alias dan menyimpan file. Untuk mengenkripsi nilai ini, gunakan variabel baru dengan kuncinya diaktifkan pada tab Variabel.

uiTestToolsDirectory - Direktori alat pengujian
Alias input: uitestToolsDir. string. Pilihan. Gunakan saat enablePrepare = true && framework = uitest.

Jalur ke direktori dengan alat uji Xamarin UI yang berisi test-cloud.exe.

signInfo - Informasi penandatanganan
string. Opsional. Gunakan saat framework = calabash || framework = uitest.

Menandatangani server pengujian.

xcUITestBuildDirectory - Buat direktori
Alias input: xcuitestBuildDir. string. Opsional. Gunakan saat enablePrepare = true && framework = xcuitest.

Jalur ke direktori output build (biasanya $(ProjectDir)/Build/Products/Debug-iphoneos).

xcUITestIpaFile - Menguji jalur IPA
Alias input: xcuitestTestIpaPath. string. Pilihan. Gunakan saat enablePrepare = true && framework = xcuitest.

Jalur ke file .ipa dengan tes XCUITest.

prepareOptions - Opsi tambahan
Alias input: prepareOpts. string. Pilihan. Gunakan saat enablePrepare = true.

Argumen tambahan yang diteruskan ke langkah persiapan pengujian App Center.

runTests - Jalankan pengujian
Alias input: enableRun. boolean. Nilai default: true.

Menjalankan pengujian.

credentialsOption - Metode autentikasi
Alias input: credsType. string. Diperlukan saat enableRun = true. Nilai yang diizinkan: serviceEndpoint (Koneksi layanan App Center), inputs (Kredensial). Nilai default: serviceEndpoint.

Menggunakan koneksi layanan App Center atau memasukkan kredensial untuk menyambungkan ke Visual Studio App Center.

serverEndpoint - Koneksi layanan App Center
string. Diperlukan saat enableRun = true && credsType = serviceEndpoint.

Memilih koneksi layanan untuk Visual Studio App Center. Jika diperlukan, klik tautan Kelola untuk membuat koneksi layanan baru.

username - Nama pengguna App Center
string. Diperlukan saat enableRun = true && credsType = inputs.

Buat nama pengguna Anda dengan mengunjungi halaman masuk App Center, dan berikan nilainya di sini.

password - Kata sandi Pusat Aplikasi
string. Diperlukan saat enableRun = true && credsType = inputs.

Atur kata sandi Anda dengan mengunjungi halaman masuk App Center, dan berikan nilainya di sini. Variabel yang ditentukan dalam alur build atau rilis seperti $(passwordVariable) yang diterima. Anda dapat menandai jenis variabel sebagai secret untuk mengamankannya.

appSlug - Simpul aplikasi
string. Diperlukan saat enableRun = true.

Simpul aplikasi dalam format <username>/<app_identifier>. Untuk menemukan <username> dan <app_identifier> untuk aplikasi, klik namanya dari Visual Studio App Center. URL yang dihasilkan dalam format https://appcenter.ms/users/<username>/apps/<app_identifier>.

devices - Perangkat
string. Diperlukan saat enableRun = true.

Mengidentifikasi perangkat yang akan dijalankan pengujian ini. Salin dan tempel string ini saat Anda menentukan uji coba baru dari suar Uji Visual Studio App Center.

series - Seri pengujian
string. Pilihan. Gunakan saat enableRun = true. Nilai default: master.

Nama seri untuk mengatur eksekusi pengujian (misalnya: master, produksi, beta).

dsymDirectory - Direktori dSYM
Alias input: dsymDir. string. Pilihan. Gunakan saat enableRun = true.

Jalur ke file simbol iOS.

localeOption - Bahasa sistem
Alias input: locale. string. Diperlukan saat enableRun = true. Nilai yang diizinkan: da_DK (Denmark(Denmark)), nl_NL (Belanda)), en_GB (Inggris (Inggris)), en_US (Inggris (Amerika Serikat)), fr_FR (Prancis (Prancis)), de_DE (Jerman (Jerman)), ja_JP (Jepang (Jepang)), ru_RU (Rusia (Rusia)), es_MX (Spanyol (Meksiko)), es_ES (Spanyol (Spanyol)), user (Lainnya). Nilai default: en_US.

Manfaatkan jika bahasa Anda tidak ditampilkan. Pilih Other dan masukkan lokalnya, seperti en_US.

userDefinedLocale - Lokal lainnya
string. Pilihan. Gunakan saat enableRun = true && locale = user.

Memasukkan kode bahasa ISO-639 dua huruf bersama dengan kode negara ISO 3166 dua huruf dalam format <language>_<country>, seperti en_US.

loginOptions - Opsi tambahan untuk masuk
Alias input: loginOpts. string. Pilihan. Gunakan saat enableRun = true && credsType = inputs.

Argumen tambahan yang diteruskan ke langkah masuk Visual Studio App Center.

runOptions - Opsi tambahan untuk dijalankan
Alias input: runOpts. string. Pilihan. Gunakan saat enableRun = true.

Argumen tambahan yang diteruskan ke uji coba Visual Studio App Center.

skipWaitingForResults - Jangan menunggu hasil pengujian
Alias input: async. boolean. Opsional. Gunakan saat enableRun = true. Nilai default: false.

Menjalankan perintah secara asinkron dan keluar ketika pengujian diunggah tanpa menunggu hasil pengujian.

cliFile - Lokasi CLI App Center
Alias input: cliLocationOverride. string.

Jalur ke CLI Visual Studio App Center pada agen build atau rilis.

showDebugOutput - Aktifkan output debug
Alias input: debug. boolean. Nilai default: false.

--debug Menambahkan ke CLI Visual Studio App Center.

Opsi kontrol tugas

Semua tugas memiliki opsi kontrol selain input tugas mereka. Untuk informasi selengkapnya, lihat Opsi kontrol dan properti tugas umum.

Variabel output

Tidak ada.

Keterangan

Tugas ini memungkinkan Anda menjalankan rangkaian pengujian terhadap biner aplikasi (file .apk atau .ipa ) menggunakan Pengujian App Center.

• Daftar dengan App Center terlebih dahulu.
• Untuk detail tentang menggunakan tugas ini, lihat artikel dokumentasi App Center Menggunakan Azure DevOps untuk Pengujian UI.

Contoh

Contoh ini menjalankan pengujian Espresso pada aplikasi Android menggunakan tugas Uji App Center.

steps:
- task: AppCenterTest@1
  displayName: 'Espresso Test - Synchronous'
  inputs:
    appFile: 'Espresso/espresso-app.apk'
    artifactsDirectory: '$(Build.ArtifactStagingDirectory)/AppCenterTest'
    frameworkOption: espresso
    espressoBuildDirectory: Espresso
    serverEndpoint: 'myAppCenterServiceConnection'
    appSlug: 'xplatbg1/EspressoTests'
    devices: a84c93af

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Tidak ada
Kemampuan	Tugas ini tidak memenuhi tuntutan untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	2.206.1 atau lebih tinggi
Kategori tugas	Uji