AppCenterTest@1 – Tarefa de teste do App Center v1

Testar pacotes de aplicativos com o Visual Studio App Center.

Sintaxe

# 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 prepareTests = true. Test framework. Default: appium.
    #appiumBuildDirectory: # string. Alias: appiumBuildDir. Required when prepareTests = true && frameworkOption = appium. Build directory. 
    #espressoBuildDirectory: # string. Alias: espressoBuildDir. Optional. Use when prepareTests = true && frameworkOption = espresso. Build directory. 
    #espressoTestApkFile: # string. Alias: espressoTestApkPath. Optional. Use when prepareTests = true && frameworkOption = espresso. Test APK path. 
    #calabashProjectDirectory: # string. Alias: calabashProjectDir. Required when prepareTests = true && frameworkOption = calabash. Project directory. 
    #calabashConfigFile: # string. Optional. Use when prepareTests = true && frameworkOption = calabash. Cucumber config file. 
    #calabashProfile: # string. Optional. Use when prepareTests = true && frameworkOption = calabash. Profile to run. 
    #calabashSkipConfigCheck: false # boolean. Optional. Use when prepareTests = true && frameworkOption = calabash. Skip Configuration Check. Default: false.
    #uiTestBuildDirectory: # string. Alias: uitestBuildDir. Required when prepareTests = true && frameworkOption = uitest. Build directory. 
    #uitestStorePath: # string. Optional. Use when prepareTests = true && frameworkOption = uitest. Store file. 
    #uiTestStorePassword: # string. Alias: uitestStorePass. Optional. Use when prepareTests = true && frameworkOption = uitest. Store password. 
    #uitestKeyAlias: # string. Optional. Use when prepareTests = true && frameworkOption = uitest. Key alias. 
    #uiTestKeyPassword: # string. Alias: uitestKeyPass. Optional. Use when prepareTests = true && frameworkOption = uitest. Key password. 
    #uiTestToolsDirectory: # string. Alias: uitestToolsDir. Optional. Use when prepareTests = true && frameworkOption = uitest. Test tools directory. 
    #signInfo: # string. Optional. Use when frameworkOption = calabash || frameworkOption = uitest. Signing information. 
    #xcUITestBuildDirectory: # string. Alias: xcuitestBuildDir. Optional. Use when prepareTests = true && frameworkOption = xcuitest. Build directory. 
    #xcUITestIpaFile: # string. Alias: xcuitestTestIpaPath. Optional. Use when prepareTests = true && frameworkOption = xcuitest. Test IPA path. 
    #prepareOptions: # string. Alias: prepareOpts. Optional. Use when prepareTests = true. Additional options. 
  # Run Tests
    #runTests: true # boolean. Alias: enableRun. Run tests. Default: true.
    credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required when runTests = true. Authentication method. Default: serviceEndpoint.
    #serverEndpoint: # string. Required when runTests = true && credentialsOption = serviceEndpoint. App Center service connection. 
    #username: # string. Required when runTests = true && credentialsOption = inputs. App Center username. 
    #password: # string. Required when runTests = true && credentialsOption = inputs. App Center password. 
    appSlug: # string. Required when runTests = true. App slug. 
    devices: # string. Required when runTests = true. Devices. 
    #series: 'master' # string. Optional. Use when runTests = true. Test series. Default: master.
    #dsymDirectory: # string. Alias: dsymDir. Optional. Use when runTests = 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 runTests = true. System language. Default: en_US.
    #userDefinedLocale: # string. Optional. Use when runTests = true && localeOption = user. Other locale. 
    #loginOptions: # string. Alias: loginOpts. Optional. Use when runTests = true && credentialsOption = inputs. Additional options for login. 
    #runOptions: # string. Alias: runOpts. Optional. Use when runTests = true. Additional options for run. 
    #skipWaitingForResults: false # boolean. Alias: async. Optional. Use when runTests = 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ório

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


do diretório artifactsDirectory - Artifacts
Alias de entrada: artifactsDir. string. Obrigatório 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 definido como true, essa entrada prepara os testes.


da estrutura de teste do frameworkOption -
Alias de entrada: framework. string. Necessário quando prepareTests = true. Valores permitidos: appium, espresso, calabash, uitest (Teste de Interface do Usuário do Xamarin), xcuitest. Valor padrão: appium.


appiumBuildDirectory - de diretório build
Alias de entrada: appiumBuildDir. string. Necessário quando prepareTests = true && frameworkOption = appium.

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


espressoBuildDirectory - de diretório build
Alias de entrada: espressoBuildDir. string. Opcional. Use quando prepareTests = true && frameworkOption = 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 prepareTests = true && frameworkOption = 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 Project
Alias de entrada: calabashProjectDir. string. Necessário quando prepareTests = true && frameworkOption = calabash.

O caminho para o diretório do workspace calabash.


calabashConfigFile - arquivo de configuração do Pepino
string. Opcional. Use quando prepareTests = true && frameworkOption = calabash.

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


perfil calabashProfile - para executar
string. Opcional. Use quando prepareTests = true && frameworkOption = calabash.

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


calabashSkipConfigCheck - ignorar de verificação de configuração
boolean. Opcional. Use quando prepareTests = true && frameworkOption = calabash. Valor padrão: false.

Quando definido como true, essa entrada ignora a verificação de configuração especificada pelo perfil pepino.


uiTestBuildDirectory - de diretório build
Alias de entrada: uitestBuildDir. string. Necessário quando prepareTests = true && frameworkOption = uitest.

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


de arquivo da uitestStorePath - Store
string. Opcional. Use quando prepareTests = true && frameworkOption = uitest.

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


de senha do repositório de uiTestStorePassword -
Alias de entrada: uitestStorePass. string. Opcional. Use quando prepareTests = true && frameworkOption = uitest.

A senha do arquivo de repositório que é 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 prepareTests = true && frameworkOption = uitest.

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


de senha de chave uiTestKeyPassword -
Alias de entrada: uitestKeyPass. string. Opcional. Use quando prepareTests = true && frameworkOption = 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.


do diretório de ferramentas de teste do uiTestToolsDirectory -
Alias de entrada: uitestToolsDir. string. Opcional. Use quando prepareTests = true && frameworkOption = 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 frameworkOption = calabash || frameworkOption = uitest.

Assina o servidor de teste.


xcUITestBuildDirectory - de diretório build
Alias de entrada: xcuitestBuildDir. string. Opcional. Use quando prepareTests = true && frameworkOption = xcuitest.

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


xcUITestIpaFile - testar o caminho IPA
Alias de entrada: xcuitestTestIpaPath. string. Opcional. Use quando prepareTests = true && frameworkOption = xcuitest.

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


prepareOptions - Opções adicionais
Alias de entrada: prepareOpts. string. Opcional. Use quando prepareTests = 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.


método credentialsOption - Authentication
Alias de entrada: credsType. string. Necessário quando runTests = 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 - de conexão do serviço do App Center
string. Necessário quando runTests = true && credentialsOption = 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. Necessário quando runTests = true && credentialsOption = inputs.

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


password - de senha do App Center
string. Necessário quando runTests = true && credentialsOption = inputs.

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


de lesma do aplicativo appSlug -
string. Necessário quando runTests = true.

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


dispositivos devices -
string. Necessário quando runTests = true.

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


da série de testes series -
string. Opcional. Use quando runTests = true. Valor padrão: master.

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


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

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


de linguagem do sistema localeOption -
Alias de entrada: locale. string. Necessário quando runTests = 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 (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 - outros de localidade
string. Opcional. Use quando runTests = true && localeOption = user.

Insere qualquer código de idioma ISO-639 de duas letras juntamente 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 runTests = true && credentialsOption = inputs.

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


runOptions - Opções adicionais para executar
Alias de entrada: runOpts. string. Opcional. Use quando runTests = true.

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


skipWaitingForResults - Não aguarde o resultado do teste
Alias de entrada: async. boolean. Opcional. Use quando runTests = 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 de 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 de tarefa

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

Variáveis de saída

Nenhum.

Observações

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

Exemplos

Este exemplo executa testes do Espresso em um aplicativo Android usando a tarefa 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
Execuções em Agente, DeploymentGroup
de demandas Nenhum
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente 2.206.1 ou superior
Categoria de tarefa Teste
Requisito Descrição
Tipos de pipeline YAML, build clássico
Execuções em Agente, DeploymentGroup
de demandas Nenhum
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente 2.144.0 ou superior
Categoria de tarefa Teste
Requisito Descrição
Tipos de pipeline YAML, build clássico
Execuções em Agente, DeploymentGroup
de demandas Nenhum
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente Todas as versões de agente com suporte.
Categoria de tarefa Teste