AppCenterTest@1 - Tarefa de teste v1 do Centro de Aplicações

Testar pacotes de aplicações com o Centro de Aplicações do Visual Studio.

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 ficheiro de aplicação binária
Alias de entrada: app. string. Obrigatório.

O caminho relativo da raiz do repositório para o ficheiro APK ou IPA que pretende testar.

artifactsDirectory - Diretório artefactos
Alias de entrada: artifactsDir. string. Obrigatório. Valor predefinido: $(Build.ArtifactStagingDirectory)/AppCenterTest.

Especifica onde colocar os artefactos produzidos pelo passo de preparação e utilizados pelo passo de execução. Este diretório será criado se ainda não existir.

prepareTests - Preparar testes
Alias de entrada: enablePrepare. boolean. Valor predefinido: true.

Quando definida como true, esta entrada prepara os testes.

frameworkOption - Arquitetura de teste
Alias de entrada: framework. string. Necessário quando enablePrepare = true. Valores permitidos: appium, espresso, uitestcalabash( Xamarin UI Test), xcuitest. Valor predefinido: appium.

appiumBuildDirectory - Criar diretório
Alias de entrada: appiumBuildDir. string. Necessário quando enablePrepare = true && framework = appium.

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

espressoBuildDirectory - Criar diretório
Alias de entrada: espressoBuildDir. string. Opcional. Utilize quando enablePrepare = true && framework = espresso.

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

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

O caminho para o ficheiro APK com os testes Espresso. Se não estiver definido, build-dir é utilizado para detetá-lo. É permitido um caráter universal.

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

O caminho para o diretório da área de trabalho de Calabash.

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

O caminho para o ficheiro de configuração do Pepino, normalmente cucumber.yml.

calabashProfile - Perfil a executar
string. Opcional. Utilize quando enablePrepare = true && framework = calabash.

O perfil a executar. Este valor tem de existir no ficheiro de configuração do Pepino.

calabashSkipConfigCheck - Ignorar Verificação de Configuração
boolean. Opcional. Utilize quando enablePrepare = true && framework = calabash. Valor predefinido: false.

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

uiTestBuildDirectory - Criar diretório
Alias de entrada: uitestBuildDir. string. Necessário quando enablePrepare = true && framework = uitest.

O caminho para o diretório com as assemblagens de teste incorporadas.

uitestStorePath - Ficheiro de arquivo
string. Opcional. Utilize quando enablePrepare = true && framework = uitest.

O caminho para o ficheiro da loja que é utilizado para assinar a aplicação.

uiTestStorePassword - Armazenar palavra-passe
Alias de entrada: uitestStorePass. string. Opcional. Utilize quando enablePrepare = true && framework = uitest.

A palavra-passe do ficheiro da loja que é utilizado para assinar a aplicação. Para encriptar este valor, utilize uma nova variável com o respetivo bloqueio ativado no separador Variáveis.

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

Especifica o alias que identifica o par de chaves públicas/privadas que é utilizado no ficheiro de arquivo.

uiTestKeyPassword - Palavra-passe chave
Alias de entrada: uitestKeyPass. string. Opcional. Utilize quando enablePrepare = true && framework = uitest.

Especifica a palavra-passe chave para o ficheiro de arquivo e alias. Para encriptar este valor, utilize uma nova variável com o respetivo bloqueio ativado no separador Variáveis.

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

O caminho para o diretório com as ferramentas de teste de IU Xamarin que contêm test-cloud.exe.

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

Assina o servidor de teste.

xcUITestBuildDirectory - Criar diretório
Alias de entrada: xcuitestBuildDir. string. Opcional. Utilize quando enablePrepare = true && framework = xcuitest.

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

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

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

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

Os argumentos adicionais que são transmitidos para o passo de preparação de testes do Centro de Aplicações.

runTests - Executar testes
Alias de entrada: enableRun. boolean. Valor predefinido: true.

Executa os testes.

credentialsOption - Método de autenticação
Alias de entrada: credsType. string. Necessário quando enableRun = true. Valores permitidos: serviceEndpoint (ligação ao serviço do Centro de Aplicações), inputs (Credenciais). Valor predefinido: serviceEndpoint.

Utiliza a ligação do serviço Do Centro de Aplicações ou introduz as credenciais para ligar ao Centro de Aplicações do Visual Studio.

serverEndpoint - Ligação ao serviço do Centro de Aplicações
string. Necessário quando enableRun = true && credsType = serviceEndpoint.

Seleciona a ligação de serviço para o Centro de Aplicações do Visual Studio. Se necessário, clique na ligação Gerir para criar uma nova ligação de serviço.

username - Nome de utilizador do Centro de Aplicações
string. Necessário quando enableRun = true && credsType = inputs.

Crie o seu nome de utilizador ao visitar a página de início de sessão do Centro de Aplicações e forneça o valor aqui.

password - Palavra-passe do Centro de Aplicações
string. Necessário quando enableRun = true && credsType = inputs.

Defina a sua palavra-passe ao visitar a página de início de sessão do Centro de Aplicações e indique o valor aqui. Variáveis definidas em pipelines de compilação ou versão conforme $(passwordVariable) são aceites. Pode marcar o tipo de variável como secret para o proteger.

appSlug - Lesma da aplicação
string. Necessário quando enableRun = true.

O slug da aplicação está no formato de <username>/<app_identifier>. Para localizar o <username> e <app_identifier> para uma aplicação, clique no respetivo nome a partir do Centro de Aplicações do Visual Studio. O URL resultante está no formato https://appcenter.ms/users/<username>/apps/<app_identifier>.

devices - Dispositivos
string. Necessário quando enableRun = true.

Identifica os dispositivos em que este teste será executado. Copie e cole esta cadeia quando definir uma nova execução de teste a partir do Visual Studio App Center Test beacon.

series - Série de testes
string. Opcional. Utilize quando enableRun = true. Valor predefinido: 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. Utilize quando enableRun = true.

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

localeOption - Idioma do sistema
Alias de entrada: locale. string. Necessário quando enableRun = 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 (Outro). Valor predefinido: en_US.

Utilize se o seu idioma não for apresentado. Selecione Other e introduza a respetiva região, como en_US.

userDefinedLocale - Outra região
string. Opcional. Utilize quando enableRun = true && locale = 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 o início de sessão
Alias de entrada: loginOpts. string. Opcional. Utilize quando enableRun = true && credsType = inputs.

Os argumentos adicionais que são transmitidos para o passo de início de sessão do Visual Studio App Center.

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

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

skipWaitingForResults - Não aguarde pelo resultado do teste
Alias de entrada: async. boolean. Opcional. Utilize quando enableRun = true. Valor predefinido: false.

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

cliFile - Localização da CLI do Centro de Aplicações
Alias de entrada: cliLocationOverride. string.

O caminho para a CLI do Centro de Aplicações do Visual Studio no agente de compilação ou versão.

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

Adiciona --debug à CLI do Centro de Aplicações do Visual Studio.

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

Esta tarefa permite-lhe executar conjuntos de testes num binário de aplicação (.apk ou ficheiro .ipa ) com o Teste do Centro de Aplicações.

• Inscreva-se primeiro no Centro de Aplicações .
• Para obter detalhes sobre como utilizar esta tarefa, veja o artigo de documentação do Centro de Aplicações Utilizar o Azure DevOps para Testes de IU.

Exemplos

Este exemplo executa testes do Expresso numa aplicação Android com a tarefa de Teste do Centro de Aplicações.

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	Description
Tipos de pipeline	YAML, Compilação clássica
É executado em	Agente, DeploymentGroup
Exigências	Nenhuma
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos	Qualquer
Variáveis de tabelas definidas	Qualquer
Versão do agente	2.206.1 ou superior
Categoria da tarefa	Teste