AppCenterTest@1 - Attività test v1 di App Center

Testare i pacchetti di app con Visual Studio App Center.

Sintassi

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

Ingressi dati

appFile - percorso file binario dell'applicazione
Alias di input: app. string. Obbligatorio.

Percorso relativo dalla radice del repository al file APK o IPA da testare.

artifactsDirectory - directory Artifacts
Alias di input: artifactsDir. string. Obbligatorio. Valore predefinito: $(Build.ArtifactStagingDirectory)/AppCenterTest

Specifica dove inserire gli artefatti generati dal passaggio di preparazione e usati dal passaggio di esecuzione. Questa directory verrà creata se non esiste già.

prepareTests - Preparare i test
Alias di input: enablePrepare. boolean. Valore predefinito: true

Se impostato su true, questo input prepara i test.

frameworkOption - Framework di test
Alias di input: framework. string. Obbligatorio quando enablePrepare = true. Valori consentiti: appium, espresso, calabash, uitest (test dell'interfaccia utente Xamarin), xcuitest. Valore predefinito: appium

appiumBuildDirectory - della directory di compilazione
Alias di input: appiumBuildDir. string. Obbligatorio quando enablePrepare = true && framework = appium.

Percorso della directory con i test di Appium.

espressoBuildDirectory - della directory di compilazione
Alias di input: espressoBuildDir. string. Opzionale. Usare quando enablePrepare = true && framework = espresso.

Percorso della directory di output espresso.

espressoTestApkFile - test del percorso APK
Alias di input: espressoTestApkPath. string. Opzionale. Usare quando enablePrepare = true && framework = espresso.

Percorso del file APK con i test espresso. Se non è impostato, build-dir viene usato per individuarlo. È consentito un carattere jolly.

directory calabashProjectDirectory - progetto
Alias di input: calabashProjectDir. string. Obbligatorio quando enablePrepare = true && framework = calabash.

Percorso della directory dell'area di lavoro Calabash.

calabashConfigFile - file di configurazione di Cetriolo
string. Opzionale. Usare quando enablePrepare = true && framework = calabash.

Percorso del file di configurazione di Cetriolo, in genere cucumber.yml.

calabashProfile - Profilo per l'esecuzione di
string. Opzionale. Usare quando enablePrepare = true && framework = calabash.

Profilo da eseguire. Questo valore deve esistere nel file di configurazione di Cetriolo.

calabashSkipConfigCheck - ignorare il controllo della configurazione
boolean. Opzionale. Usare quando enablePrepare = true && framework = calabash. Valore predefinito: false

Se impostato su true, questo input ignora il controllo di configurazione specificato dal profilo Di cetriolo.

uiTestBuildDirectory - della directory di compilazione
Alias di input: uitestBuildDir. string. Obbligatorio quando enablePrepare = true && framework = uitest.

Percorso della directory con gli assembly di test compilati.

uitestStorePath - Archiviare file
string. Opzionale. Usare quando enablePrepare = true && framework = uitest.

Percorso del file dello store usato per firmare l'app.

uiTestStorePassword - Memorizza la password
Alias di input: uitestStorePass. string. Opzionale. Usare quando enablePrepare = true && framework = uitest.

Password del file dello store usato per firmare l'app. Per crittografare questo valore, usare una nuova variabile con il blocco abilitato nella scheda Variabili.

uitestKeyAlias - alias chiave
string. Opzionale. Usare quando enablePrepare = true && framework = uitest.

Specifica l'alias che identifica la coppia di chiavi pubblica/privata utilizzata nel file di archiviazione.

uiTestKeyPassword - password della chiave
Alias di input: uitestKeyPass. string. Opzionale. Usare quando enablePrepare = true && framework = uitest.

Specifica la password della chiave per l'alias e il file di archiviazione. Per crittografare questo valore, usare una nuova variabile con il blocco abilitato nella scheda Variabili.

uiTestToolsDirectory - directory strumenti di test
Alias di input: uitestToolsDir. string. Opzionale. Usare quando enablePrepare = true && framework = uitest.

Percorso della directory con gli strumenti di test dell'interfaccia utente di Xamarin che contengono test-cloud.exe.

signInfo - informazioni sulla firma
string. Opzionale. Usare quando framework = calabash || framework = uitest.

Firma il server di test.

xcUITestBuildDirectory - della directory di compilazione
Alias di input: xcuitestBuildDir. string. Opzionale. Usare quando enablePrepare = true && framework = xcuitest.

Percorso della directory di output di compilazione (in genere $(ProjectDir)/Build/Products/Debug-iphoneos).

xcUITestIpaFile - test del percorso IPA
Alias di input: xcuitestTestIpaPath. string. Opzionale. Usare quando enablePrepare = true && framework = xcuitest.

Percorso del file con estensione ipa con i test XCUITest.

prepareOptions - Opzioni aggiuntive
Alias di input: prepareOpts. string. Opzionale. Usare quando enablePrepare = true.

Argomenti aggiuntivi passati al passaggio di preparazione del test di App Center.

runTests - Eseguire test
Alias di input: enableRun. boolean. Valore predefinito: true

Esegue i test.

metodo di autenticazione credentialsOption -
Alias di input: credsType. string. Obbligatorio quando enableRun = true. Valori consentiti: serviceEndpoint (connessione al servizio App Center), inputs (credenziali). Valore predefinito: serviceEndpoint

Usa la connessione al servizio App Center o immette le credenziali per connettersi a Visual Studio App Center.

serverEndpoint - di connessione al servizio App Center
string. Obbligatorio quando enableRun = true && credsType = serviceEndpoint.

Seleziona la connessione al servizio per Visual Studio App Center. Se necessario, fare clic sul collegamento Gestisci per creare una nuova connessione al servizio.

username - nome utente di App Center
string. Obbligatorio quando enableRun = true && credsType = inputs.

Creare il nome utente visitando la pagina di accesso App Centere specificare il valore qui.

password - password di App Center
string. Obbligatorio quando enableRun = true && credsType = inputs.

Impostare la password visitando la pagina di accesso di App Centere specificare il valore qui. Le variabili definite nelle pipeline di compilazione o versione come $(passwordVariable) vengono accettate. È possibile contrassegnare il tipo di variabile come secret per proteggerlo.

appSlug - di slug dell'app
string. Obbligatorio quando enableRun = true.

Lo slug dell'app è nel formato di <username>/<app_identifier>. Per individuare le <username> e le <app_identifier> per un'app, fare clic sul nome Visual Studio App Center. L'URL risultante è nel formato https://appcenter.ms/users/<username>/apps/<app_identifier>.

dispositivi devices -
string. Obbligatorio quando enableRun = true.

Identifica i dispositivi su cui verrà eseguito il test. Copiare e incollare questa stringa quando si definisce una nuova esecuzione di test dal beacon test di Visual Studio App Center.

serie di test di series -
string. Opzionale. Usare quando enableRun = true. Valore predefinito: master

Nome della serie per organizzare le esecuzioni dei test, ad esempio master, produzione, beta.

dsymDirectory - directory dSYM
Alias di input: dsymDir. string. Opzionale. Usare quando enableRun = true.

Percorso dei file di simboli iOS.

localeOption - lingua di sistema
Alias di input: locale. string. Obbligatorio quando enableRun = true. Valori consentiti: da_DK (danese (Danimarca)), nl_NL (olandese (Paesi Bassi)), en_GB (inglese (Regno Unito)), en_US (inglese (Stati Uniti)), fr_FR (francese (Francia)), fr_FRja_JP (tedesco (Germania)), ru_RU (giapponese (Giappone),es_MX (russo (Russia)), es_ES (spagnolo (Messico)), user (spagnolo (Spagna)), (altro). Valore predefinito: en_US

Utilizzare se la lingua non viene visualizzata. Selezionare Other e immettere le impostazioni locali, ad esempio en_US.

userDefinedLocale - Altre impostazioni locali
string. Opzionale. Usare quando enableRun = true && locale = user.

Immette qualsiasi codice di lingua ISO-639 a due lettere insieme a qualsiasi codice paese ISO 3166 a due lettere nel formato <language>_<country>, ad esempio en_US.

loginOptions - Opzioni aggiuntive per l'accesso
Alias di input: loginOpts. string. Opzionale. Usare quando enableRun = true && credsType = inputs.

Argomenti aggiuntivi passati al passaggio di accesso di Visual Studio App Center.

runOptions - Opzioni aggiuntive per l'esecuzione di
Alias di input: runOpts. string. Opzionale. Usare quando enableRun = true.

Argomenti aggiuntivi passati all'esecuzione del test di Visual Studio App Center.

skipWaitingForResults - Non attendere il risultato del test
Alias di input: async. boolean. Opzionale. Usare quando enableRun = true. Valore predefinito: false

Esegue un comando in modo asincrono ed esce quando i test vengono caricati senza attendere i risultati del test.

cliFile - percorso dell'interfaccia della riga di comando di App Center
Alias di input: cliLocationOverride. string.

Percorso dell'interfaccia della riga di comando di Visual Studio App Center nell'agente di compilazione o versione.

showDebugOutput - Abilitare l'output di debug
Alias di input: debug. boolean. Valore predefinito: false

Aggiunge --debug all'interfaccia della riga di comando di Visual Studio App Center.

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni:

Questa attività consente di eseguire gruppi di test su un file binario dell'applicazione (.apk o file con estensione ipa) usando il test di App Center.

• Iscriviti ad App Center prima.
• Per informazioni dettagliate sull'uso di questa attività, vedere l'articolo della documentazione di App Center Uso di Azure DevOps per il test dell'interfaccia utente.

Esempi

Questo esempio esegue test espresso in un'app Android usando l'attività Test di 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

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica
Viene eseguito in	Agente, DeploymentGroup
richieste	Nessuno
funzionalità di	Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi	Qualunque
variabili impostabili	Qualunque
Versione dell'agente	2.206.1 o versione successiva
Categoria attività	Prova