AppCenterTest@1 - App Center-test v1-taak

Artikel
03/24/2025

App-pakketten testen met Visual Studio App Center.

Syntaxis

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

Invoer

appFile - bestandspad voor binaire toepassingen
Invoeralias: app. string. Verplicht.

Het relatieve pad van de hoofdmap van de opslagplaats naar het APK- of IPA-bestand dat u wilt testen.

map artifactsDirectory - Artefacten
Invoeralias: artifactsDir. string. Verplicht. Standaardwaarde: $(Build.ArtifactStagingDirectory)/AppCenterTest.

Hiermee geeft u op waar de artefacten die zijn geproduceerd door de voorbereidingsstap en die door de uitvoeringsstap worden gebruikt. Deze map wordt gemaakt als deze nog niet bestaat.

prepareTests - tests voorbereiden
Invoeralias: enablePrepare. boolean. Standaardwaarde: true.

Als deze optie is ingesteld op true, worden de tests door deze invoer voorbereid.

frameworkOption - testframework
Invoeralias: framework. string. Vereist wanneer enablePrepare = true. Toegestane waarden: appium, espresso, calabash, uitest (Xamarin UI Test), xcuitest. Standaardwaarde: appium.

appiumBuildDirectory - map maken
Invoeralias: appiumBuildDir. string. Vereist wanneer enablePrepare = true && framework = appium.

Het pad naar de map met de Appium-tests.

espressoBuildDirectory - map maken
Invoeralias: espressoBuildDir. string. Facultatief. Gebruiken wanneer enablePrepare = true && framework = espresso.

Het pad naar de espresso-uitvoermap.

espressoTestApkFile - APK-pad testen
Invoeralias: espressoTestApkPath. string. Facultatief. Gebruiken wanneer enablePrepare = true && framework = espresso.

Het pad naar het APK-bestand met de Espresso-tests. Als deze niet is ingesteld, wordt build-dir gebruikt om deze te detecteren. Een jokerteken is toegestaan.

calabashProjectDirectory - projectmap
Invoeralias: calabashProjectDir. string. Vereist wanneer enablePrepare = true && framework = calabash.

Het pad naar de map van de Calabash-werkruimte.

calabashConfigFile - komkommerconfiguratiebestand
string. Facultatief. Gebruiken wanneer enablePrepare = true && framework = calabash.

Het pad naar het komkommerconfiguratiebestand, meestal cucumber.yml.

calabashProfile - profiel om uit te voeren
string. Facultatief. Gebruiken wanneer enablePrepare = true && framework = calabash.

Het profiel dat moet worden uitgevoerd. Deze waarde moet bestaan in het configuratiebestand Komkommer.

calabashSkipConfigCheck - Configuratiecontrole overslaan
boolean. Facultatief. Gebruiken wanneer enablePrepare = true && framework = calabash. Standaardwaarde: false.

Als deze optie is ingesteld op true, slaat deze invoer de configuratiecontrole over die is opgegeven door het komkommerprofiel.

uiTestBuildDirectory - map maken
Invoeralias: uitestBuildDir. string. Vereist wanneer enablePrepare = true && framework = uitest.

Het pad naar de map met de ingebouwde testassembly's.

uitestStorePath - opslaan
string. Facultatief. Gebruiken wanneer enablePrepare = true && framework = uitest.

Het pad naar het store-bestand dat wordt gebruikt om de app te ondertekenen.

uiTestStorePassword - Wachtwoord opslaan
Invoeralias: uitestStorePass. string. Facultatief. Gebruiken wanneer enablePrepare = true && framework = uitest.

Het wachtwoord van het store-bestand dat wordt gebruikt om de app te ondertekenen. Als u deze waarde wilt versleutelen, gebruikt u een nieuwe variabele met de vergrendeling ingeschakeld op het tabblad Variabelen.

uitestKeyAlias - sleutelalias
string. Facultatief. Gebruiken wanneer enablePrepare = true && framework = uitest.

Hiermee geeft u de alias die het openbare/persoonlijke sleutelpaar identificeert dat wordt gebruikt in het archiefbestand.

uiTestKeyPassword - sleutelwachtwoord
Invoeralias: uitestKeyPass. string. Facultatief. Gebruiken wanneer enablePrepare = true && framework = uitest.

Hiermee geeft u het sleutelwachtwoord voor de alias en het archiefbestand. Als u deze waarde wilt versleutelen, gebruikt u een nieuwe variabele met de vergrendeling ingeschakeld op het tabblad Variabelen.

MapuiTestToolsDirectory - Hulpprogramma's testen
Invoeralias: uitestToolsDir. string. Facultatief. Gebruiken wanneer enablePrepare = true && framework = uitest.

Het pad naar de map met de Xamarin UI-testhulpprogramma's die test-cloud.exebevatten.

signInfo - ondertekeningsgegevens
string. Facultatief. Gebruiken wanneer framework = calabash || framework = uitest.

Ondertekent de testserver.

xcUITestBuildDirectory - map maken
Invoeralias: xcuitestBuildDir. string. Facultatief. Gebruiken wanneer enablePrepare = true && framework = xcuitest.

Het pad naar de uitvoermap van de build (meestal $(ProjectDir)/Build/Products/Debug-iphoneos).

xcUITestIpaFile - IPA-pad testen
Invoeralias: xcuitestTestIpaPath. string. Facultatief. Gebruiken wanneer enablePrepare = true && framework = xcuitest.

Het pad naar het IPA-bestand met de XCUITest-tests.

prepareOptions - Aanvullende opties
Invoeralias: prepareOpts. string. Facultatief. Gebruiken wanneer enablePrepare = true.

De aanvullende argumenten die worden doorgegeven aan de teststap van App Center.

runTests - tests uitvoeren
Invoeralias: enableRun. boolean. Standaardwaarde: true.

Voert de tests uit.

credentialsOption - verificatiemethode
Invoeralias: credsType. string. Vereist wanneer enableRun = true. Toegestane waarden: serviceEndpoint (App Center-serviceverbinding), inputs (referenties). Standaardwaarde: serviceEndpoint.

Maakt gebruik van de App Center-serviceverbinding of voert de referenties in om verbinding te maken met Visual Studio App Center.

serverEndpoint - App Center-serviceverbinding
string. Vereist wanneer enableRun = true && credsType = serviceEndpoint.

Selecteert de serviceverbinding voor Visual Studio App Center. Klik indien nodig op de koppeling Beheren om een nieuwe serviceverbinding te maken.

username - App Center-gebruikersnaam
string. Vereist wanneer enableRun = true && credsType = inputs.

Maak uw gebruikersnaam door naar de aanmeldingspagina van App Center te gaanen geef hier de waarde op.

password - App Center-wachtwoord
string. Vereist wanneer enableRun = true && credsType = inputs.

Stel uw wachtwoord in door naar de aanmeldingspagina van App Center te gaanen geef hier de waarde op. Variabelen die zijn gedefinieerd in build- of release-pijplijnen als $(passwordVariable) worden geaccepteerd. U kunt het variabeletype markeren als secret om het te beveiligen.

appSlug - app-slug
string. Vereist wanneer enableRun = true.

De app-slug heeft de indeling van <username>/<app_identifier>. Als u de <username> en <app_identifier> voor een app wilt zoeken, klikt u op de naam van Visual Studio App Center-. De resulterende URL heeft de indeling https://appcenter.ms/users/<username>/apps/<app_identifier>.

devices - apparaten
string. Vereist wanneer enableRun = true.

Identificeert de apparaten waarop deze test wordt uitgevoerd. Kopieer en plak deze tekenreeks wanneer u een nieuwe testuitvoering definieert vanuit de Visual Studio App Center Test-baken.

series - testreeks
string. Facultatief. Gebruiken wanneer enableRun = true. Standaardwaarde: master.

De naam van de reeks voor het ordenen van de testuitvoeringen (bijvoorbeeld: master, productie, bèta).

dsymDirectory - dSYM-map
Invoeralias: dsymDir. string. Facultatief. Gebruiken wanneer enableRun = true.

Het pad naar de iOS-symboolbestanden.

localeOption - systeemtaal
Invoeralias: locale. string. Vereist wanneer enableRun = true. Toegestane waarden: da_DK (Deens (Denemarken)), nl_NL (Nederlands (Nederland)), en_GB (Engels (Verenigd Koninkrijk)), en_US (Engels (Verenigde Staten)), fr_FR (Frans (Frankrijk)), fr_FR (Frankrijk)), de_DEfr_FR (Duits (Duitsland)), ja_JP (Japans (Japan)), ru_RU (Russisch (Rusland)), es_MX (Spaans (Mexico)), es_ES (Spaans (Spanje)), user (overige). Standaardwaarde: en_US.

Gebruik deze optie als uw taal niet wordt weergegeven. Selecteer Other en voer de landinstelling in, zoals en_US.

userDefinedLocale - andere landinstellingen
string. Facultatief. Gebruiken wanneer enableRun = true && locale = user.

Voert elke ISO-639-taalcode van twee letters in, samen met een ISO 3166-landcode van twee letters in de notatie <language>_<country>, zoals en_US.

loginOptions - Aanvullende opties voor aanmelden
Invoeralias: loginOpts. string. Facultatief. Gebruiken wanneer enableRun = true && credsType = inputs.

De aanvullende argumenten die worden doorgegeven aan de aanmeldingsstap van Visual Studio App Center.

runOptions - Aanvullende opties voor het uitvoeren van
Invoeralias: runOpts. string. Facultatief. Gebruiken wanneer enableRun = true.

De extra argumenten die worden doorgegeven aan de testuitvoering van Visual Studio App Center.

skipWaitingForResults - Wacht niet op testresultaten
Invoeralias: async. boolean. Facultatief. Gebruiken wanneer enableRun = true. Standaardwaarde: false.

Hiermee wordt een opdracht asynchroon uitgevoerd en wordt afgesloten wanneer de tests worden geüpload zonder te wachten op de testresultaten.

cliFile - Cli-locatie van App Center
Invoeralias: cliLocationOverride. string.

Het pad naar de Visual Studio App Center CLI op de build- of releaseagent.

showDebugOutput - Foutopsporingsuitvoer inschakelen
Invoeralias: debug. boolean. Standaardwaarde: false.

Voegt --debug toe aan de Visual Studio App Center CLI.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Met deze taak kunt u testsuites uitvoeren op basis van een binaire toepassing (.apk of .ipa-bestand) met behulp van App Center Test.

meld u eerst aan bij App Center.
Zie het documentatieartikel over App Center Azure DevOps gebruiken voor het testen van gebruikersinterfacesvoor meer informatie over het gebruik van deze taak.

Voorbeelden

In dit voorbeeld worden Espresso-tests uitgevoerd op een Android-app met behulp van de App Center-testtaak.

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

Vereisten

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Geen
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welk dan ook
variabelen instellen	Welk dan ook
Agentversie	2.206.1 of hoger
Taakcategorie	Testen

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Geen
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welk dan ook
variabelen instellen	Welk dan ook
Agentversie	2.144.0 of hoger
Taakcategorie	Testen

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Geen
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welk dan ook
variabelen instellen	Welk dan ook
Agentversie	Alle ondersteunde agentversies.
Taakcategorie	Testen

Delen via