AppCenterTest@1 - App Center test v1 görevi

Makale
07/02/2024

Visual Studio App Center ile uygulama paketlerini test edin.

Syntax

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

# 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. 
    #uitestStoreFile: # 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.

Girişler

appFile - İkili uygulama dosya yolu
Giriş diğer adı: app. string. Gereklidir.

Depo kökünden test etmek istediğiniz APK veya IPA dosyasına göreli yol.

artifactsDirectory - Artifacts dizini
Giriş diğer adı: artifactsDir. string. Gereklidir. Varsayılan değer: $(Build.ArtifactStagingDirectory)/AppCenterTest.

Hazırlama adımı tarafından üretilen ve çalıştırma adımı tarafından kullanılan yapıtların nereye yerleştirileceği belirtir. Bu dizin henüz yoksa oluşturulur.

prepareTests - Testleri hazırlama
Giriş diğer adı: enablePrepare. boolean. Varsayılan değer: true.

olarak ayarlandığında true, bu giriş testleri hazırlar.

frameworkOption - Test çerçevesi
Giriş diğer adı: framework. string. olduğunda enablePrepare = truegereklidir. İzin verilen değerler: appium, espresso, calabash, uitest (Xamarin UI Testi), xcuitest. Varsayılan değer: appium.

appiumBuildDirectory - Dizin oluşturma
Giriş diğer adı: appiumBuildDir. string. olduğunda enablePrepare = true && framework = appiumgereklidir.

Appium testlerinin olduğu dizinin yolu.

espressoBuildDirectory - Dizin oluşturma
Giriş diğer adı: espressoBuildDir. string. İsteğe bağlı. when enablePrepare = true && framework = espressokullanın.

Espresso çıkış dizinine giden yol.

espressoTestApkFile - APK yolunu test et
Giriş diğer adı: espressoTestApkPath. string. İsteğe bağlı. when enablePrepare = true && framework = espressokullanın.

Espresso testleri ile APK dosyasının yolu. Ayarlanmadıysa, build-dir bulmak için kullanılır. Joker karaktere izin verilir.

calabashProjectDirectory - Proje dizini
Giriş diğer adı: calabashProjectDir. string. olduğunda enablePrepare = true && framework = calabashgereklidir.

Calabash çalışma alanı dizininin yolu.

calabashConfigFile - Salatalık yapılandırma dosyası
string. İsteğe bağlı. when enablePrepare = true && framework = calabashkullanın.

Salatalık yapılandırma dosyasının yolu, genellikle cucumber.yml.

calabashProfile - Çalıştırılacak profil
string. İsteğe bağlı. when enablePrepare = true && framework = calabashkullanın.

Çalıştırılacak profil. Bu değer Salatalık yapılandırma dosyasında bulunmalıdır.

calabashSkipConfigCheck - Yapılandırma Denetimini Atla
boolean. İsteğe bağlı. when enablePrepare = true && framework = calabashkullanın. Varsayılan değer: false.

olarak ayarlandığında true, bu giriş Salatalık profili tarafından belirtilen yapılandırma denetimini atlar.

uiTestBuildDirectory - Dizin oluşturma
Giriş diğer adı: uitestBuildDir. string. olduğunda enablePrepare = true && framework = uitestgereklidir.

Yerleşik test derlemeleri ile dizinin yolu.

uitestStorePath - Dosyayı depolama
string. İsteğe bağlı. when enablePrepare = true && framework = uitestkullanın.

Uygulamayı imzalamak için kullanılan depolama dosyasının yolu.

uiTestStorePassword - Mağaza parolası
Giriş diğer adı: uitestStorePass. string. İsteğe bağlı. when enablePrepare = true && framework = uitestkullanın.

Uygulamayı imzalamak için kullanılan mağaza dosyasının parolası. Bu değeri şifrelemek için Değişkenler sekmesinde kilidi etkinleştirilmiş yeni bir değişken kullanın.

uitestKeyAlias - Anahtar diğer adı
string. İsteğe bağlı. when enablePrepare = true && framework = uitestkullanın.

Depo dosyasında kullanılan ortak/özel anahtar çiftini tanımlayan diğer adı belirtir.

uiTestKeyPassword - Anahtar parolası
Giriş diğer adı: uitestKeyPass. string. İsteğe bağlı. when enablePrepare = true && framework = uitestkullanın.

Diğer ad ve depolama dosyası için anahtar parolasını belirtir. Bu değeri şifrelemek için Değişkenler sekmesinde kilidi etkinleştirilmiş yeni bir değişken kullanın.

uiTestToolsDirectory - Test araçları dizini
Giriş diğer adı: uitestToolsDir. string. İsteğe bağlı. when enablePrepare = true && framework = uitestkullanın.

test-cloud.exeiçeren Xamarin UI test araçlarının bulunduğu dizinin yolu.

signInfo - İmzalama bilgileri
string. İsteğe bağlı. when framework = calabash || framework = uitestkullanın.

Test sunucusunu imzalar.

xcUITestBuildDirectory - Dizin oluşturma
Giriş diğer adı: xcuitestBuildDir. string. İsteğe bağlı. when enablePrepare = true && framework = xcuitestkullanın.

Derleme çıkış dizininin yolu (genellikle $(ProjectDir)/Build/Products/Debug-iphoneos).

xcUITestIpaFile - IPA yolunu test et
Giriş diğer adı: xcuitestTestIpaPath. string. İsteğe bağlı. olduğunda enablePrepare = true && framework = xcuitestkullanın.

XCUITest testleriyle .ipa dosyasının yolu.

prepareOptions - Ek seçenekler
Giriş diğer adı: prepareOpts. string. İsteğe bağlı. olduğunda enablePrepare = truekullanın.

App Center test hazırlama adımına geçirilen ek bağımsız değişkenler.

runTests - Testleri çalıştırma
Giriş diğer adı: enableRun. boolean. Varsayılan değer: true.

Testleri çalıştırır.

credentialsOption - Kimlik doğrulama yöntemi
Giriş diğer adı: credsType. string. olduğunda enableRun = truegereklidir. İzin verilen değerler: serviceEndpoint (App Center hizmeti bağlantısı), inputs (Kimlik bilgileri). Varsayılan değer: serviceEndpoint.

App Center hizmeti bağlantısını kullanır veya Visual Studio App Center'a bağlanmak için kimlik bilgilerini girer.

serverEndpoint - App Center hizmeti bağlantısı
string. olduğunda enableRun = true && credsType = serviceEndpointgereklidir.

Visual Studio App Center için hizmet bağlantısını seçer. Gerekirse Yönet bağlantısına tıklayarak yeni bir hizmet bağlantısı oluşturun.

username - App Center kullanıcı adı
string. olduğunda enableRun = true && credsType = inputsgereklidir.

App Center oturum açma sayfasını ziyaret ederek kullanıcı adınızı oluşturun ve değeri burada belirtin.

password - App Center parolası
string. olduğunda enableRun = true && credsType = inputsgereklidir.

App Center oturum açma sayfasını ziyaret ederek parolanızı ayarlayın ve değeri burada belirtin. Derleme veya yayın işlem hatlarında $(passwordVariable) tanımlanan değişkenler kabul edilir. Güvenli olmasını sağlamak için değişken türünü olarak secret işaretleyebilirsiniz.

appSlug - Uygulama bilgi alanı
string. olduğunda enableRun = truegereklidir.

Uygulama bilgi alanı biçimindedir <username>/<app_identifier>. Bir uygulamanın ve <app_identifier> öğesini bulmak <username> için Visual Studio App Center'dan adına tıklayın. Sonuçta elde edilen URL biçimindedir https://appcenter.ms/users/<username>/apps/<app_identifier>.

devices - Aygıtları
string. olduğunda enableRun = truegereklidir.

Bu testin çalıştırılacağı cihazları tanımlar. Visual Studio App Center Test işaretinden yeni bir test çalıştırması tanımlarken bu dizeyi kopyalayıp yapıştırın.

series - Test serisi
string. İsteğe bağlı. olduğunda enableRun = truekullanın. Varsayılan değer: master.

Test çalıştırmalarını düzenlemek için seri adı (örneğin: ana, üretim, beta).

dsymDirectory - dSYM dizini
Giriş diğer adı: dsymDir. string. İsteğe bağlı. olduğunda enableRun = truekullanın.

iOS sembol dosyalarının yolu.

localeOption - Sistem dili
Giriş diğer adı: locale. string. olduğunda enableRun = truegereklidir. İzin verilen değerler: da_DK (Danca (Danimarka)), nl_NL (Felemenkçe (Hollanda)), en_GB (İngilizce (Birleşik Krallık)), en_US (İngilizce (Birleşik Devletler)), fr_FR (Fransızca (Fransa)), (Almanca (Almanya)), ja_JPde_DE (Japonca (Japonya)), ru_RU (Rusça (Rusya)), (İspanyolca (Meksika)), es_ESes_MX (İspanyolca (İspanya)), user (Diğer). Varsayılan değer: en_US.

Diliniz görüntülenmiyorsa kullanılır. öğesini seçin Other ve gibi en_USyerel ayarını girin.

userDefinedLocale - Diğer yerel ayar
string. İsteğe bağlı. olduğunda enableRun = true && locale = userkullanın.

İki harfli ISO-639 dil kodlarını ve iki harfli ISO 3166 ülke kodlarını <language>_<country>biçiminde (gibi en_US) girer.

loginOptions - Oturum açma için ek seçenekler
Giriş diğer adı: loginOpts. string. İsteğe bağlı. olduğunda enableRun = true && credsType = inputskullanın.

Visual Studio App Center oturum açma adımına geçirilen ek bağımsız değişkenler.

runOptions - Çalıştırma için ek seçenekler
Giriş diğer adı: runOpts. string. İsteğe bağlı. olduğunda enableRun = truekullanın.

Visual Studio App Center test çalıştırmasına geçirilen ek bağımsız değişkenler.

skipWaitingForResults - Test sonucunu beklemeyin
Giriş diğer adı: async. boolean. İsteğe bağlı. olduğunda enableRun = truekullanın. Varsayılan değer: false.

Bir komutu zaman uyumsuz olarak yürütür ve test sonuçları beklenmeden testler karşıya yüklendiğinde çıkar.

cliFile - App Center CLI konumu
Giriş diğer adı: cliLocationOverride. string.

Derleme veya yayın aracısının Visual Studio App Center CLI'sinin yolu.

showDebugOutput - Hata ayıklama çıkışını etkinleştirme
Giriş diğer adı: debug. boolean. Varsayılan değer: false.

Visual Studio App Center CLI'ya ekler --debug .

uitestStoreFile - Dosyayı depolama
string. İsteğe bağlı. olduğunda enablePrepare = true && framework = uitestkullanın.

Görev denetim seçenekleri

Tüm görevlerde görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz . Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Yok.

Açıklamalar

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

Önce App Center'a kaydolun.
Bu görevi kullanma hakkında ayrıntılı bilgi için, Ui Testi için Azure DevOps kullanma App Center belgeleri makalesine bakın.

Örnekler

Bu örnek, App Center Test görevini kullanarak bir Android uygulamasında Espresso testleri ç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

Gereksinimler

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme
Üzerinde çalışır	Agent, DeploymentGroup
Talep	Hiçbiri
Özellikler	Bu görev, işteki sonraki görevler için hiçbir talebi karşılamaz.
Komut kısıtlamaları	Herhangi biri
Ayarlanabilir değişkenler	Herhangi biri
Aracı sürümü	2.206.1 veya üzeri
Görev kategorisi	Test etme

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme
Üzerinde çalışır	Agent, DeploymentGroup
Talep	Hiçbiri
Özellikler	Bu görev, işteki sonraki görevler için hiçbir talebi karşılamaz.
Komut kısıtlamaları	Herhangi biri
Ayarlanabilir değişkenler	Herhangi biri
Aracı sürümü	2.144.0 veya üzeri
Görev kategorisi	Test etme

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme
Üzerinde çalışır	Agent, DeploymentGroup
Talep	Hiçbiri
Özellikler	Bu görev, işteki sonraki görevler için hiçbir talebi karşılamaz.
Komut kısıtlamaları	Herhangi biri
Ayarlanabilir değişkenler	Herhangi biri
Aracı sürümü	Desteklenen tüm aracı sürümleri.
Görev kategorisi	Test etme

Aracılığıyla paylaş