Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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 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.
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 enablePrepare = 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 enablePrepare = true && framework = appium.
O caminho para o diretório com os testes Appium.
espressoBuildDirectory
-
Construir diretório
Alias de entrada: espressoBuildDir.
string. Opcional. Use quando enablePrepare = true && framework = espresso.
O caminho para o diretório de saída do Espresso.
espressoTestApkFile
-
Teste APK caminho
Alias de entrada: espressoTestApkPath.
string. Opcional. Use quando enablePrepare = true && framework = 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 enablePrepare = true && framework = 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 enablePrepare = true && framework = calabash.
O caminho para o arquivo de configuração do Cucumber, geralmente cucumber.yml.
calabashProfile
-
perfil 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 Cucumber.
calabashSkipConfigCheck
-
Ignorar de verificação de configuração
boolean. Opcional. Use quando enablePrepare = true && framework = 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 enablePrepare = true && framework = uitest.
O caminho para o diretório com os assemblies de teste construídos.
de arquivos do uitestStorePath - Store
string. Opcional. Use quando enablePrepare = true && framework = 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 enablePrepare = true && framework = 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 enablePrepare = true && framework = 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 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
-
Construir diretório
Alias de entrada: xcuitestBuildDir.
string. Opcional. Use quando enablePrepare = true && framework = 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 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. 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 de 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 login 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 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 enableRun = 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 enableRun = 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 enableRun = 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 enableRun = true.
O caminho para os arquivos de símbolos do iOS.
localeOption
-
Linguagem 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 (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 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 iniciar sessão
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 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 enableRun = 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.
- 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 teste de interface do usuário.
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 |