AppCenterTest@1 – Tarefa de teste do App Center v1

Artigo
03/24/2025

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 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ó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 enablePrepare = 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 enablePrepare = true && framework = 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 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 Project
Alias de entrada: calabashProjectDir. string. Necessário quando enablePrepare = true && framework = calabash.

O caminho para o diretório do workspace calabash.

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

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

perfil calabashProfile - para executar
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 de verificação de configuração
boolean. Opcional. Use quando enablePrepare = true && framework = 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 enablePrepare = true && framework = uitest.

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

de arquivo da uitestStorePath - Store
string. Opcional. Use quando enablePrepare = true && framework = 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 enablePrepare = true && framework = 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 enablePrepare = true && framework = 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 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.

do diretório de ferramentas de teste do uiTestToolsDirectory -
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 - de diretório 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 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.

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

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

de linguagem do sistema localeOption -
Alias de entrada: locale. string. Necessá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 (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 enableRun = true && locale = 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 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 executar
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 aguarde 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 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.

inscreva-se no App Center primeiro.
Para obter detalhes sobre como usar essa tarefa, consulte o artigo de documentação do App Center Usando o Azure DevOps para testes de interface do usuário.

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	Agent, 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	Agent, 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	Agent, 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

Compartilhar via