AppCenterTest@1 - Tarefa de teste v1 do App Center

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

Insumos

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.


artifactsDirectory - Diretório de artefatos
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. Este diretório será criado se 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.


frameworkOption - Estrutura de teste
Alias de entrada: framework. string. Necessário quando prepareTests = true. Valores permitidos: appium, espresso, calabash, uitest (Xamarin UI Test), xcuitest. Valor padrão: appium.


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

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


espressoBuildDirectory - Construir diretório
Alias de entrada: espressoBuildDir. string. Opcional. Use quando prepareTests = true && frameworkOption = espresso.

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


espressoTestApkFile - Teste APK caminho
Alias de entrada: espressoTestApkPath. string. Opcional. Use quando prepareTests = true && frameworkOption = espresso.

O caminho para o arquivo APK com os testes de café expresso. Se não estiver definido, build-dir é usado para descobri-lo. É permitido um curinga.


calabashProjectDirectory - do diretório do Project
Alias de entrada: calabashProjectDir. string. Necessário quando prepareTests = true && frameworkOption = calabash.

O caminho para o diretório do espaço de trabalho Calabash.


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

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


calabashProfile - perfil 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 Cucumber.


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

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


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

O caminho para o diretório com os assemblies de teste construídos.


de arquivos do uitestStorePath - Store
string. Opcional. Use quando prepareTests = true && frameworkOption = uitest.

O caminho para o arquivo de armazenamento usado para assinar o aplicativo.


uiTestStorePassword - Palavra-passe da Loja
Alias de entrada: uitestStorePass. string. Opcional. Use quando prepareTests = true && frameworkOption = uitest.

A senha do arquivo de armazenamento 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 usado no arquivo de armazenamento.


uiTestKeyPassword - Senha da chave
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.


uiTestToolsDirectory - Diretório de ferramentas de teste
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 - Construir diretório
Alias de entrada: xcuitestBuildDir. string. Opcional. Use quando prepareTests = true && frameworkOption = xcuitest.

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


xcUITestIpaFile - Testar 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.


credentialsOption - Método de autenticação
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 de 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 login 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 login do App Centere forneça o valor aqui. As variáveis definidas em pipelines de compilação ou liberação como $(passwordVariable) são aceitas. Você pode marcar o tipo de variável como secret para protegê-la.


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

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


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

Identifica os dispositivos contra os quais esse teste será executado. Copie e cole essa cadeia de caracteres ao definir uma nova execução de teste a partir do beacon de teste do Visual Studio App Center.


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

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


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

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


localeOption - Linguagem do sistema
Alias de entrada: locale. string. Necessário quando runTests = true. Valores permitidos: da_DK (dinamarquês (Dinamarca)), nl_NL (neerlandê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 seu idioma não for exibido. Selecione Other e insira sua localidade, como en_US.


userDefinedLocale - Outra localidade
string. Opcional. Use quando runTests = true && localeOption = user.

Introduz 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 iniciar sessão
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 o teste do Visual Studio App Center são executados.


skipWaitingForResults - Não espere pelo 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 esperar pelos resultados do teste.


cliFile - de localização da CLI do App Center
Alias de entrada: cliLocationOverride. string.

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


showDebugOutput - Ativar 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 controlo de tarefas

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

Variáveis de saída

Nenhum.

Observações

Esta tarefa permite executar conjuntos de testes em um aplicativo binário (.apk ou arquivo .ipa) usando o App Center Test.

Exemplos

Este exemplo executa testes Espresso em um aplicativo Android usando a tarefa App Center Test.

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

Requerimentos

Requisito Descrição
Tipos de pipeline YAML, construção clássica
Funciona em Agente, DeploymentGroup
Exigências Nenhum
Capacidades Esta tarefa não satisfaz quaisquer exigências 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 de tarefa Teste
Requisito Descrição
Tipos de pipeline YAML, construção clássica
Funciona em Agente, DeploymentGroup
Exigências Nenhum
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 2.144.0 ou superior
Categoria de tarefa Teste
Requisito Descrição
Tipos de pipeline YAML, construção clássica
Funciona em Agente, DeploymentGroup
Exigências Nenhum
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente Todas as versões de agente suportadas.
Categoria de tarefa Teste