AppCenterTest@1 – Tarefa de teste do App Center v1

Testar pacotes de aplicativos com o 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.

Entradas

appFile - Caminho do arquivo de aplicativo binário
Alias de entrada: app. string. Obrigatórios.

O caminho relativo da raiz do repositório para o arquivo APK ou IPA que você deseja testar.

artifactsDirectory - Diretório artifacts
Alias de entrada: artifactsDir. string. Obrigatórios. Valor padrão: $(Build.ArtifactStagingDirectory)/AppCenterTest.

Especifica onde colocar os artefatos produzidos pela etapa de preparação e usados pela etapa de execução. Esse diretório será criado se ele ainda não existir.

prepareTests - Preparar testes
Alias de entrada: enablePrepare. boolean. Valor padrão: true.

Quando definida truecomo , essa entrada prepara os testes.

frameworkOption - Estrutura de teste
Alias de entrada: framework. string. Obrigatório quando enablePrepare = true. Valores permitidos: appium, espresso, calabash, uitest (Teste de interface do usuário do Xamarin), xcuitest. Valor padrão: appium.

appiumBuildDirectory - Diretório de build
Alias de entrada: appiumBuildDir. string. Obrigatório quando enablePrepare = true && framework = appium.

O caminho para o diretório com os testes do Appium.

espressoBuildDirectory - Diretório de build
Alias de entrada: espressoBuildDir. string. Opcional. Use quando enablePrepare = true && framework = espresso.

O caminho para o diretório de saída do Espresso.

espressoTestApkFile - Testar o caminho do APK
Alias de entrada: espressoTestApkPath. string. Opcional. Use quando enablePrepare = true && framework = espresso.

O caminho para o arquivo APK com os testes do Espresso. Se não estiver definido, build-dir será usado para descobri-lo. Um curinga é permitido.

calabashProjectDirectory - Diretório do projeto
Alias de entrada: calabashProjectDir. string. Obrigatório quando enablePrepare = true && framework = calabash.

O caminho para o diretório do workspace calabash.

calabashConfigFile - Arquivo de configuração de pepino
string. Opcional. Use quando enablePrepare = true && framework = calabash.

O caminho para o arquivo de configuração do Pepino, geralmente cucumber.yml.

calabashProfile - Perfil a ser executado
string. Opcional. Use quando enablePrepare = true && framework = calabash.

O perfil a ser executado. Esse valor deve existir no arquivo de configuração do Pepino.

calabashSkipConfigCheck - Ignorar verificação de configuração
boolean. Opcional. Use quando enablePrepare = true && framework = calabash. Valor padrão: false.

Quando definida truecomo , essa entrada ignora a configuração marcar especificada pelo perfil Pepino.

uiTestBuildDirectory - Diretório de build
Alias de entrada: uitestBuildDir. string. Obrigatório quando enablePrepare = true && framework = uitest.

O caminho para o diretório com os assemblies de teste criados.

uitestStorePath - Armazenar arquivo
string. Opcional. Use quando enablePrepare = true && framework = uitest.

O caminho para o arquivo de repositório usado para assinar o aplicativo.

uiTestStorePassword - Armazenar senha
Alias de entrada: uitestStorePass. string. Opcional. Use quando enablePrepare = true && framework = uitest.

A senha do arquivo de repositório usado para assinar o aplicativo. Para criptografar esse valor, use uma nova variável com seu bloqueio habilitado na guia Variáveis.

uitestKeyAlias - Alias de chave
string. Opcional. Use quando enablePrepare = true && framework = uitest.

Especifica o alias que identifica o par de chaves pública/privada que é usado no arquivo de repositório.

uiTestKeyPassword - Senha da chave
Alias de entrada: uitestKeyPass. string. Opcional. Use quando enablePrepare = true && framework = uitest.

Especifica a senha da chave para o alias e o arquivo de armazenamento. Para criptografar esse valor, use uma nova variável com seu bloqueio habilitado na guia Variáveis.

uiTestToolsDirectory - Diretório de ferramentas de teste
Alias de entrada: uitestToolsDir. string. Opcional. Use quando enablePrepare = true && framework = uitest.

O caminho para o diretório com as ferramentas de teste da interface do usuário do Xamarin que contêm test-cloud.exe.

signInfo - Informações de assinatura
string. Opcional. Use quando framework = calabash || framework = uitest.

Assina o servidor de teste.

xcUITestBuildDirectory - Diretório de build
Alias de entrada: xcuitestBuildDir. string. Opcional. Use quando enablePrepare = true && framework = xcuitest.

O caminho para o diretório de saída de build (geralmente $(ProjectDir)/Build/Products/Debug-iphoneos).

xcUITestIpaFile - Testar o caminho do IPA
Alias de entrada: xcuitestTestIpaPath. string. Opcional. Use quando enablePrepare = true && framework = xcuitest.

O caminho para o arquivo .ipa com os testes XCUITest.

prepareOptions - Opções adicionais
Alias de entrada: prepareOpts. string. Opcional. Use quando enablePrepare = true.

Os argumentos adicionais que são passados para a etapa de preparação de teste do App Center.

runTests - Executar testes
Alias de entrada: enableRun. boolean. Valor padrão: true.

Executa os testes.

credentialsOption - Método de autenticação
Alias de entrada: credsType. string. Obrigatório quando enableRun = true. Valores permitidos: serviceEndpoint (conexão de serviço do App Center) inputs (Credenciais). Valor padrão: serviceEndpoint.

Usa a conexão de serviço do App Center ou insere as credenciais para se conectar ao Visual Studio App Center.

serverEndpoint - Conexão de serviço do App Center
string. Obrigatório quando enableRun = true && credsType = serviceEndpoint.

Seleciona a conexão de serviço para o Visual Studio App Center. Se necessário, clique no link Gerenciar para criar uma nova conexão de serviço.

username - Nome de usuário do App Center
string. Obrigatório quando enableRun = true && credsType = inputs.

Crie seu nome de usuário visitando a página de entrada do App Center e forneça o valor aqui.

password - Senha do App Center
string. Obrigatório quando enableRun = true && credsType = inputs.

Defina sua senha visitando a página de entrada do App Center e forneça o valor aqui. Variáveis definidas em pipelines de build ou de lançamento conforme $(passwordVariable) são aceitas. Você pode marcar o tipo de variável como secret para protegê-lo.

appSlug - Lesma do aplicativo
string. Obrigatório quando enableRun = true.

O slug do aplicativo está no formato de <username>/<app_identifier>. Para localizar o <username> e <app_identifier> para um aplicativo, clique em seu nome no Visual Studio App Center. A URL resultante está no formato https://appcenter.ms/users/<username>/apps/<app_identifier>.

devices - Dispositivos
string. Obrigatório quando enableRun = true.

Identifica os dispositivos em que esse teste será executado. Copie e cole essa cadeia de caracteres quando você definir uma nova execução de teste no sinalizador de teste do Visual Studio App Center.

series - Série de testes
string. Opcional. Use quando enableRun = true. Valor padrão: master.

O nome da série para organizar as execuções de teste (por exemplo: master, produção, beta).

dsymDirectory - Diretório dSYM
Alias de entrada: dsymDir. string. Opcional. Use quando enableRun = true.

O caminho para os arquivos de símbolo do iOS.

localeOption - Idioma do sistema
Alias de entrada: locale. string. Obrigatório quando enableRun = true. Valores permitidos: da_DK (Dinamarquês (Dinamarca)), nl_NL (Holandês (Países Baixos)), en_GB (Inglês (Reino Unido)), en_US (Inglês (Estados Unidos)), fr_FR (Francês (França)), de_DE (Alemão (Alemanha)), ja_JP (Japonês (Japão)), ru_RU (Russo (Rússia)), es_MX (Espanhol (México)), es_ES (Espanhol (Espanha)), user (Outros). Valor padrão: en_US.

Utilize se o idioma não for exibido. Selecione Other e insira sua localidade, como en_US.

userDefinedLocale - Outra localidade
string. Opcional. Use quando enableRun = true && locale = user.

Insere qualquer código de idioma ISO-639 de duas letras junto com qualquer código de país ISO 3166 de duas letras no formato <language>_<country>, como en_US.

loginOptions - Opções adicionais para logon
Alias de entrada: loginOpts. string. Opcional. Use quando enableRun = true && credsType = inputs.

Os argumentos adicionais que são passados para a etapa de logon do Visual Studio App Center.

runOptions - Opções adicionais para execução
Alias de entrada: runOpts. string. Opcional. Use quando enableRun = true.

Os argumentos adicionais que são passados para a execução de teste do Visual Studio App Center.

skipWaitingForResults - Não espere o resultado do teste
Alias de entrada: async. boolean. Opcional. Use quando enableRun = true. Valor padrão: false.

Executa um comando de forma assíncrona e sai quando os testes são carregados sem aguardar os resultados do teste.

cliFile - Local da CLI do App Center
Alias de entrada: cliLocationOverride. string.

O caminho para a CLI do Visual Studio App Center no agente de build ou versão.

showDebugOutput - Habilitar saída de depuração
Alias de entrada: debug. boolean. Valor padrão: false.

Adiciona --debug à CLI do Visual Studio App Center.

Opções de controle da tarefa

Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Comentários

Essa tarefa permite executar pacotes de teste em um binário de aplicativo (.apk ou arquivo .ipa ) usando o Teste do App Center.

• Inscrever-se com o App Center primeiro.
• Para obter detalhes sobre como usar essa tarefa, confira o artigo de documentação do App Center Usando o Azure DevOps para teste de interface do usuário.

Exemplos

Este exemplo executa testes do Espresso em um aplicativo Android usando a tarefa de teste do 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

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico
Executa em	Agent, DeploymentGroup
Demandas	Nenhum
Funcionalidades	Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
Restrições de comando	Qualquer
Variáveis configuráveis	Qualquer
Versão do agente	2.206.1 ou superior
Categoria da tarefa	Teste