AppCenterTest@1 - Attività test di App Center v1

Articolo
07/02/2024

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.

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

Input

appFile - Percorso file dell'applicazione binaria
Alias di input: app. string. Obbligatorio.

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

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

Specifica dove inserire gli artefatti prodotti 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, calabashespressouitest (test dell'interfaccia utente Xamarin), . xcuitest Valore predefinito: appium.

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

Percorso della directory con i test di Appium.

espressoBuildDirectory - Directory di compilazione
Alias di input: espressoBuildDir. string. facoltativo. Usare quando enablePrepare = true && framework = espresso.

Percorso della directory di output Espresso.

espressoTestApkFile - Testare il percorso APK
Alias di input: espressoTestApkPath. string. facoltativo. 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.

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

Percorso della directory dell'area di lavoro Calabash.

calabashConfigFile - File di configurazione del cetriolo
string. facoltativo. Usare quando enablePrepare = true && framework = calabash.

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

calabashProfile - Profilo da eseguire
string. facoltativo. Usare quando enablePrepare = true && framework = calabash.

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

calabashSkipConfigCheck - Ignora controllo configurazione
boolean. facoltativo. 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 - 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 il file
string. facoltativo. Usare quando enablePrepare = true && framework = uitest.

Percorso del file dell'archivio usato per firmare l'app.

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

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

uitestKeyAlias - Alias chiave
string. facoltativo. Usare quando enablePrepare = true && framework = uitest.

Specifica l'alias che identifica la coppia di chiavi pubblica/privata usata nel file dell'archivio.

uiTestKeyPassword - Password chiave
Alias di input: uitestKeyPass. string. facoltativo. 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 relativo blocco abilitato nella scheda Variabili.

uiTestToolsDirectory - Directory degli strumenti di test
Alias di input: uitestToolsDir. string. facoltativo. Usare quando enablePrepare = true && framework = uitest.

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

signInfo - Informazioni sulla firma
string. facoltativo. Usare quando framework = calabash || framework = uitest.

Firma il server di test.

xcUITestBuildDirectory - Directory di compilazione
Alias di input: xcuitestBuildDir. string. facoltativo. Usare quando enablePrepare = true && framework = xcuitest.

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

xcUITestIpaFile - Percorso IPA di test
Alias di input: xcuitestTestIpaPath. string. facoltativo. Usare quando enablePrepare = true && framework = xcuitest.

Percorso del file con estensione ipa con i test XCUITest.

prepareOptions - Opzioni aggiuntive
Alias di input: prepareOpts. string. facoltativo. 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.

credentialsOption - Metodo di autenticazione
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 - 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 di App Center e 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 Center e specificando il valore qui. Variabili definite nelle pipeline di compilazione o versione come $(passwordVariable) accettate. È possibile contrassegnare il tipo di variabile per secret proteggerlo.

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

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

devices - Dispositivi
string. Obbligatorio quando enableRun = true.

Identifica i dispositivi in 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.

series - Serie di test
string. facoltativo. 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. facoltativo. Usare quando enableRun = true.

Percorso dei file di simboli iOS.

localeOption - Lingua del 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)), (Francese (Francia)), fr_FRde_DE (Tedesco (Germania)), ja_JP (Giapponese (Giappone)), ru_RU (Russo (Russia)), es_MX (Spagnolo (Messico)), es_ES (Spagnolo (Spagna)), user (Altro). Valore predefinito: en_US.

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

userDefinedLocale - Altre impostazioni locali
string. facoltativo. 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. facoltativo. Usare quando enableRun = true && credsType = inputs.

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

runOptions - Opzioni aggiuntive per l'esecuzione
Alias di input: runOpts. string. facoltativo. 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. facoltativo. Usare quando enableRun = true. Valore predefinito: false.

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

cliFile - Posizione 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.

uitestStoreFile - Archiviare il file
string. facoltativo. Usare quando enablePrepare = true && framework = uitest.

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 ipa ) usando il test di App Center.

Iscriversi prima con App Center .
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.

Esempio

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
Esecuzione in	Agente, DeploymentGroup
Richieste	Nessuno
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	2.206.1 o versione successiva
Categoria attività	Test

Requisito	Descrizione
Tipi di pipeline	YAML, build classica
Esecuzione in	Agente, DeploymentGroup
Richieste	Nessuno
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	2.144.0 o versione successiva
Categoria attività	Test

Requisito	Descrizione
Tipi di pipeline	YAML, build classica
Esecuzione in	Agente, DeploymentGroup
Richieste	Nessuno
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	Tutte le versioni dell'agente supportate.
Categoria attività	Test

Condividi tramite