Test görevi App Center

Azure Pipelines | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 | TFS 2017

Bu görev, App Center Test kullanarak bir uygulama ikilisinde ( .apk veya dosyasında) test paketleri çalıştırmanızı sağlar .ipa .

Not

Microsoft Team Foundation Server (TFS) 2018 ve önceki sürümlerde, derleme ve yayın işlem hatları tanımlar olarak adlandırılır, çalışmalara derlemeler denir, hizmet bağlantılarına hizmet uç noktaları denir, aşamalar ortamlar olarak adlandırılır ve işler aşamalar olarak adlandırılır.

YAML kod parçacığı

# App Center test
# Test app packages with Visual Studio App Center
- task: AppCenterTest@1
  inputs:
    appFile: 
    #artifactsDirectory: '$(Build.ArtifactStagingDirectory)/AppCenterTest' 
    #prepareTests: true # Optional
    #frameworkOption: 'appium' # Required when prepareTests == True# Options: appium, espresso, calabash, uitest, xcuitest
    #appiumBuildDirectory: # Required when prepareTests == True && Framework == Appium
    #espressoBuildDirectory: # Optional
    #espressoTestApkFile: # Optional
    #calabashProjectDirectory: # Required when prepareTests == True && Framework == Calabash
    #calabashConfigFile: # Optional
    #calabashProfile: # Optional
    #calabashSkipConfigCheck: # Optional
    #uiTestBuildDirectory: # Required when prepareTests == True && Framework == Uitest
    #uitestStorePath: # Optional
    #uiTestStorePassword: # Optional
    #uitestKeyAlias: # Optional
    #uiTestKeyPassword: # Optional
    #uiTestToolsDirectory: # Optional
    #signInfo: # Optional
    #xcUITestBuildDirectory: # Optional
    #xcUITestIpaFile: # Optional
    #prepareOptions: # Optional
    #runTests: true # Optional
    #credentialsOption: 'serviceEndpoint' # Required when runTests == True# Options: serviceEndpoint, inputs
    #serverEndpoint: # Required when runTests == True && CredsType == ServiceEndpoint
    #username: # Required when runTests == True && CredsType == Inputs
    #password: # Required when runTests == True && CredsType == Inputs
    #appSlug: # Required when runTests == True
    #devices: # Required when runTests == True
    #series: 'master' # Optional
    #dsymDirectory: # Optional
    #localeOption: 'en_US' # Required when runTests == True# Options: da_DK, nl_NL, en_GB, en_US, fr_FR, de_DE, ja_JP, ru_RU, es_MX, es_ES, user
    #userDefinedLocale: # Optional
    #loginOptions: # Optional
    #runOptions: # Optional
    #skipWaitingForResults: # Optional
    #cliFile: # Optional
    #showDebugOutput: # Optional

Bağımsız değişkenler

Bağımsız Değişken Description
app
İkili uygulama dosyası yolu
Istenir Depo kökünden test etmek istediğiniz APK veya IPA dosyasına göreli yol.
Bağımsız değişken diğer adı: appFile
artifactsDir
Yapıt dizini
Istenir Hazırlama adımı tarafından üretilen ve çalıştırma adımı tarafından kullanılan yapıların yerleştirileceği yer. Bu dizin, yoksa oluşturulacak.
Varsayılan değer: $(Build.ArtifactStagingDirectory)/AppCenterTest
Bağımsız değişken diğer adı: artifactsDirectory
enablePrepare
Testleri Hazırlama
Seçim Testlerin hazırlanıp hazırlanmayacağını belirtin.
Varsayılan değer: true
Bağımsız değişken diğer adı: prepareTests
framework
Test çerçevesi
Istenir Seçenekler: Appium, Calabash, espresso, UITest (Xamarin UI test), xcutest.
Varsayılan değer: appium
Bağımsız değişken diğer adı: frameworkOption
appiumBuildDir
Yapı dizini (Appium)
Istenir Appium testleriyle dizin yolu.
Bağımsız değişken diğer adı: appiumBuildDirectory
espressoBuildDir
Derleme dizini (espresso)
Seçim Espresso çıkış dizini yolu
Bağımsız değişken diğer adı: espressoBuildDirectory
espressoTestApkPath
Test APK yolu (espresso)
Seçim Espresso testleriyle APK dosyasının yolu. Ayarlanmamışsa, bu ayarı saptamak için Build-dir kullanılır. Joker karaktere izin verilir.
Bağımsız değişken diğer adı: espressoTestApkFile
calabashProjectDir
Proje dizini (Calabash)
Istenir Calabash çalışma alanı dizininin yolu.
Bağımsız değişken diğer adı: calabashProjectDirectory
calabashConfigFile
Cukısaber yapılandırma dosyası (Calabash)
Seçim Cukısaber yapılandırma dosyasının yolu, genellikle cubrber. yıml.
calabashProfile
Çalıştırılacak profil (Calabash)
Seçim Çalıştırılacak profil. Bu değer, Culanber yapılandırma dosyasında mevcut olmalıdır.
calabashSkipConfigCheck
Yapılandırma denetimini atla (Calabash)
Seçim CuO profili olmadan çalışmayı zorla.
Varsayılan değer: false
uitestBuildDir
Yapı dizini (Xamarin UI testi)
Istenir Oluşturulan test Derlemeleriyle dizin yolu
Bağımsız değişken diğer adı: uiTestBuildDirectory
uitestStorePath
Depo dosyası (Xamarin UI testi)
Seçim Uygulamayı imzalamak için kullanılan mağaza dosyasının yolu.
uitestStorePass
Depolama parolası (Xamarin UI testi)
Seçim Uygulamayı imzalamak için kullanılan depo dosyasının parolası. Bu değeri şifrelemek için değişkenler sekmesinde kilidi etkinleştirilmiş yeni bir değişken kullanın.
Bağımsız değişken diğer adı: uiTestStorePassword
uitestKeyAlias
Anahtar diğer adı (Xamarin UI testi)
Seçim Depo dosyasında kullanılan ortak/özel anahtar çiftini tanımlayan diğer adı girin
uitestKeyPass
Anahtar parolası (Xamarin UI testi)
Seçim Diğer ad ve mağaza dosyası için anahtar parolasını girin. Bu değeri şifrelemek için değişkenler sekmesinde kilidi etkinleştirilmiş yeni bir değişken kullanın.
Bağımsız değişken diğer adı: uiTestKeyPassword
uitestToolsDir
Test araçları dizini (Xamarin UI testi)
Seçim Şunu içeren Xamarin UI test araçları ile dizin yolu test-cloud.exe
Bağımsız değişken diğer adı: uiTestToolsDirectory
signInfo
İmzalama bilgileri (Calabash/Xamarin UI testi
Seçim Test sunucusunu imzalamak için Imzalama bilgilerini kullanın.
xcuitestBuildDir
Yapı dizini (Xcutest)
Seçim Derleme çıkış dizininin yolu, genellikle $(ProjectDir)/Build/Products/Debug-iphoneos) .
Bağımsız değişken diğer adı: xcUITestBuildDirectory
xcuitestTestIpaPath
Test IPA yolu (Xcutest)
Seçim Xcutest testleriyle *. ipa dosyasının yolu.
Bağımsız değişken diğer adı: xcUITestIpaFile
prepareOpts
Ek seçenekler (testleri hazırlama için)
Seçim App Center Test hazırlama adımına geçirilen ek bağımsız değişkenler.
Bağımsız değişken diğer adı: prepareOptions
enableRun
Testleri çalıştırma
Seçim Testlerin çalıştırılıp çalıştırılmayacağını belirtin.
Varsayılan değer: true
Bağımsız değişken diğer adı: runTests
credsType
Kimlik doğrulama yöntemi
Istenir App Center hizmet bağlantısı kullanın veya App Center bağlanmak için kimlik bilgilerini girin.
Varsayılan değer: serviceEndpoint
Bağımsız değişken diğer adı: credentialsOption
serverEndpoint
App Center hizmet bağlantısı
Istenir App Center için hizmet bağlantısını seçin. Azure DevOps proje ayarlarında yeni bir App Center hizmet bağlantısı oluşturun.
username
App Center Kullanıcı adı (hizmet bağlantısı kullanılırken)
Istenir https://appcenter.ms/settings/profile Kullanıcı adınızı almak için adresini ziyaret edin.
password
App Center parolası (bir hizmet bağlantısı kullanılırken)
Istenir https://appcenter.ms/settings/profile Parolanızı ayarlamak için adresini ziyaret edin. Derleme veya yayın işlem hatları içinde tanımlanan bir değişkeni kabul edebilir $(passwordVariable) . Değişken türünü, secret güvenli hale getirmek için olarak işaretleyebilirsiniz.
appSlug
Uygulama bilgi
Istenir Uygulama bilgisinin biçimi {username}/{app_identifier} . {username} {app_identifier} Bir uygulamayı bulmak ve için, içindeki adına tıklayın https://appcenter.ms/apps ve sonuç URL 'si biçimindedir https://appcenter.ms/users/{username}/apps/{app_identifier} .
devices
Cihazlar
Istenir Bu testin hangi cihazlara çalışacağını belirleyen dize. App Center Test işaretten yeni bir test çalıştırması tanımladığınızda bu dizeyi kopyalayıp yapıştırın.
series
Test Serisi
Seçim Test çalıştırmalarını düzenlemek için seri adı (örn. Master, Production, Beta).
Varsayılan değer: master
dsymDir
Dsyd dizini
Seçim İOS sembol dosyalarının yolu.
Bağımsız değişken diğer adı: dsymDirectory
locale
Sistem dili
Istenir Seçenekler: da_DK, de_DE, en_GB, en_US, es_ES, es_MX, fr_FR, ja_JP, nl_NL, ru_RU, Kullanıcı. Diliniz bir seçenek değilse, user/Other öğesini kullanın ve aşağıdaki yerel ayarını girin, örneğin en_US .
Varsayılan değer: en_US
Bağımsız değişken diğer adı: localeOption
userDefinedLocale
Diğer yerel ayar
Seçim Her iki harfli ISO-639 dil kodunu, biçimdeki en_US gibi herhangi bir iki harfli ISO 3166 ülke koduyla birlikte girin [language]_[country] .
loginOpts
Oturum açma için ek seçenekler
Seçim App Center oturum açma adımına geçirilen ek bağımsız değişkenler.
Bağımsız değişken diğer adı: loginOptions
runOpts
Çalışma için ek seçenekler
Seçim App Center test çalıştırmasına geçirilen ek bağımsız değişkenler.
Bağımsız değişken diğer adı: runOptions
async
Test sonucunu bekleme
Seçim Testlerin zaman uyumsuz olarak yürütülüp yürütülmeyeceğini belirtin ve test sonuçlarını beklemeden testlerin hemen ardından çıkıldıktan sonra çıkılıyor.
Varsayılan değer: false
Bağımsız değişken diğer adı: skipWaitingForResults
cliLocationOverride
App Center CLı konumu
Seçim Yapı veya yayın aracısında App Center CLı yolu.
Bağımsız değişken diğer adı: cliFile
debug
Hata ayıklama çıkışını etkinleştir
Seçim Ayrıntılı çıkış için App Center CLı 'ye Add--Debug.
Bağımsız değişken diğer adı: showDebugOutput

Örnek

Bu örnek, App Center Test görevini kullanarak bir Android uygulamasında espresso testlerini çalıştırır.

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

Açık kaynak

Bu görev GitHub 'daaçık kaynaktır. Geribildirim ve katılımlar hoş geldiniz.

SSS