AppCenterTest@1 - App Center-test v1-taak

Artikel
07/02/2024

App-pakketten testen met Visual Studio App Center.

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.

Invoerwaarden

appFile - Pad naar binair toepassingsbestand
Invoeralias: app. string. Vereist.

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

artifactsDirectory - Map artefacten
Invoeralias: artifactsDir. string. Vereist. Standaardwaarde: $(Build.ArtifactStagingDirectory)/AppCenterTest.

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

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

Als deze optie is ingesteld op true, bereidt deze invoer de tests voor.

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. Optioneel. Gebruik wanneer enablePrepare = true && framework = espresso.

Het pad naar de espresso-uitvoermap.

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

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

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

Het pad naar de calabash-werkruimtemap.

calabashConfigFile - Configuratiebestand voor komkommer
string. Optioneel. Gebruik wanneer enablePrepare = true && framework = calabash.

Het pad naar het configuratiebestand Komkommer, meestal cucumber.yml.

calabashProfile - Uit te voeren profiel
string. Optioneel. Gebruik wanneer enablePrepare = true && framework = calabash.

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

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

Als deze optie is ingesteld op true, wordt met deze invoer de configuratiecontrole overgeslagen 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 - Bestand opslaan
string. Optioneel. Gebruik 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. Optioneel. Gebruik 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 waarvoor de vergrendeling is ingeschakeld op het tabblad Variabelen.

uitestKeyAlias - Sleutelalias
string. Optioneel. Gebruik wanneer enablePrepare = true && framework = uitest.

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

uiTestKeyPassword - Sleutelwachtwoord
Invoeralias: uitestKeyPass. string. Optioneel. Gebruik wanneer enablePrepare = true && framework = uitest.

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

uiTestToolsDirectory - Map testhulpprogramma's
Invoeralias: uitestToolsDir. string. Optioneel. Gebruik wanneer enablePrepare = true && framework = uitest.

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

signInfo - Ondertekeningsgegevens
string. Optioneel. Gebruik wanneer framework = calabash || framework = uitest.

Ondertekent de testserver.

xcUITestBuildDirectory - Map maken
Invoeralias: xcuitestBuildDir. string. Optioneel. Gebruik 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. Optioneel. Gebruik wanneer enablePrepare = true && framework = xcuitest.

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

prepareOptions - Aanvullende opties
Invoeralias: prepareOpts. string. Optioneel. Gebruik wanneer enablePrepare = true.

Met de aanvullende argumenten die worden doorgegeven aan de App Center-test, wordt de stap voorbereid.

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 gaan en hier de waarde op te geven.

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

Stel uw wachtwoord in door naar de aanmeldingspagina van App Center te gaan en hier de waarde op te geven. Variabelen die zijn gedefinieerd in build- of release-pijplijnen zoals $(passwordVariable) geaccepteerd. U kunt het type variabele markeren als secret om het te beveiligen.

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

De app-slug heeft de indeling .<username>/<app_identifier> Als u de en <app_identifier> wilt zoeken voor een app, klikt u op de <username> naam van de app in 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 waarvoor deze test wordt uitgevoerd. Kopieer en plak deze tekenreeks wanneer u een nieuwe testuitvoering definieert vanuit het testbaken van Visual Studio App Center.

series - Testreeks
string. Optioneel. Gebruik wanneer enableRun = true. Standaardwaarde: master.

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

dsymDirectory - dSYM-map
Invoeralias: dsymDir. string. Optioneel. Gebruik 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)), de_DE (Duits (Duitsland)), ja_JP (Japans (Japan)), ru_RU (Russisch (Rusland)), es_MX (Spaans (Mexico)), es_ES (Spaans (Spanje)), user (Overig). Standaardwaarde: en_US.

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

userDefinedLocale - Andere landinstellingen
string. Optioneel. Gebruik wanneer enableRun = true && locale = user.

Voert een 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. Optioneel. Gebruik wanneer enableRun = true && credsType = inputs.

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

runOptions - Aanvullende opties voor uitvoeren
Invoeralias: runOpts. string. Optioneel. Gebruik wanneer enableRun = true.

De aanvullende argumenten die worden doorgegeven aan de test van Visual Studio App Center, worden uitgevoerd.

skipWaitingForResults - Niet wachten op testresultaat
Invoeralias: async. boolean. Optioneel. Gebruik wanneer enableRun = true. Standaardwaarde: false.

Voert een opdracht asynchroon uit 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 - Uitvoer voor foutopsporing inschakelen
Invoeralias: debug. boolean. Standaardwaarde: false.

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

uitestStoreFile - Bestand opslaan
string. Optioneel. Gebruik wanneer enablePrepare = true && framework = uitest.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

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

Meld u eerst aan bij App Center .
Zie het App Center-documentatieartikel Azure DevOps gebruiken voor ui-tests voor 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

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Geen
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	2.206.1 of hoger
Taakcategorie	Testen

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Geen
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	2.144.0 of hoger
Taakcategorie	Testen

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Geen
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	Alle ondersteunde agentversies.
Taakcategorie	Testen

Delen via