VSMobileCenterTest@0 – Tarefa de Teste v0 do Mobile Center
Utilize esta tarefa para testar pacotes de aplicações móveis com o Visual Studio Mobile Center.
Syntax
# Mobile Center Test v0
# Test mobile app packages with Visual Studio Mobile Center.
- task: VSMobileCenterTest@0
inputs:
app: # string. Required. Binary Application File Path.
artifactsDir: '$(Build.ArtifactStagingDirectory)/MobileCenterTest' # string. Required. Artifacts Directory. Default: $(Build.ArtifactStagingDirectory)/MobileCenterTest.
# Prepare Tests
#enablePrepare: true # boolean. Prepare Tests. Default: true.
framework: 'appium' # 'appium' | 'espresso' | 'calabash' | 'uitest' | 'xcuitest'. Required when enablePrepare = true. Test Framework. Default: appium.
#appiumBuildDir: # string. Required when enablePrepare = true && framework = appium. Build Directory.
#espressoBuildDir: # string. Optional. Use when enablePrepare = true && framework = espresso. Build Directory.
#espressoTestApkPath: # string. Optional. Use when enablePrepare = true && framework = espresso. Test APK Path.
#calabashProjectDir: # string. 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.
#uitestBuildDir: # string. Required when enablePrepare = true && framework = uitest. Build Directory.
#uitestStoreFile: # string. Optional. Use when enablePrepare = true && framework = uitest. Store File.
#uitestStorePass: # string. Optional. Use when enablePrepare = true && framework = uitest. Store Password.
#uitestKeyAlias: # string. Optional. Use when enablePrepare = true && framework = uitest. Key Alias.
#uitestKeyPass: # string. Optional. Use when enablePrepare = true && framework = uitest. Key Password.
#uitestToolsDir: # string. Optional. Use when enablePrepare = true && framework = uitest. Test Tools Directory.
#signInfo: # string. Optional. Use when framework = calabash || framework = uitest. Signing Information.
#xcuitestBuildDir: # string. Optional. Use when enablePrepare = true && framework = xcuitest. Build Directory.
#xcuitestTestIpaPath: # string. Optional. Use when enablePrepare = true && framework = xcuitest. Test IPA Path.
#prepareOpts: # string. Optional. Use when enablePrepare = true. Additional Options.
# Run Tests
#enableRun: true # boolean. Run Tests. Default: true.
credsType: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Required when enableRun = true. Authentication Method. Default: serviceEndpoint.
#serverEndpoint: # string. Required when enableRun = true && credsType = serviceEndpoint. Mobile Center Connection.
#username: # string. Required when enableRun = true && credsType = inputs. Mobile Center Username.
#password: # string. Required when enableRun = true && credsType = inputs. Mobile 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.
#dsymDir: # string. Optional. Use when enableRun = true. dSYM Directory.
locale: 'en_US' # 'da_DK' | 'nl_NL' | 'en_GB' | 'en_US' | 'fr_FR' | 'de_DE' | 'ja_JP' | 'ru_RU' | 'es_MX' | 'es_ES' | 'user'. Required when enableRun = true. System Language. Default: en_US.
#userDefinedLocale: # string. Optional. Use when enableRun = true && locale = user. Other Locale.
#loginOpts: # string. Optional. Use when enableRun = true && credsType = inputs. Addtional Options for Login.
#runOpts: # string. Optional. Use when enableRun = true. Additional Options for Run.
#async: false # boolean. Optional. Use when enableRun = true. Do not wait for test result. Default: false.
# Advanced
#cliLocationOverride: # string. mobile-center CLI Location.
#debug: false # boolean. Enable Debug Output. Default: false.
Entradas
app
- Caminho do Ficheiro de Aplicação Binária
string
. Obrigatório.
Especifica o caminho relativo da raiz do repositório para o . APK ou . Ficheiro IPA que pretende testar.
artifactsDir
- Diretório de Artefactos
string
. Obrigatório. Valor predefinido: $(Build.ArtifactStagingDirectory)/MobileCenterTest
.
Especifica o diretório para colocar os artefactos produzidos pelo passo de preparação e utilizados pelo passo de execução. O diretório é criado se não existir.
enablePrepare
- Preparar Testes
boolean
. Valor predefinido: true
.
Se estiver definido como true
, prepara os testes.
framework
- Test Framework
string
. Necessário quando enablePrepare = true
. Valores permitidos: appium
, espresso
, calabash
, uitest
(Xamarin UI Test), xcuitest
. Valor predefinido: appium
.
Especifica a arquitetura de teste que a tarefa irá utilizar.
appiumBuildDir
- Criar Diretório
string
. Necessário quando enablePrepare = true && framework = appium
.
Especifica o caminho para o diretório que contém testes do Appium.
espressoBuildDir
- Criar Diretório
string
. Opcional. Utilize quando enablePrepare = true && framework = espresso
.
Especifica o caminho para o diretório de saída do Expresso.
espressoTestApkPath
- Testar Caminho do APK
string
. Opcional. Utilize quando enablePrepare = true && framework = espresso
.
Especifica o caminho para o ficheiro APK com testes do Espresso. Se um valor não estiver definido, build-dir
é utilizado para localizar o ficheiro APK. São permitidos carateres universais.
calabashProjectDir
- Diretório do Projeto
string
. Necessário quando enablePrepare = true && framework = calabash
.
Especifica o caminho para o diretório da área de trabalho do Calabash.
calabashConfigFile
- Ficheiro de Configuração de Pepino
string
. Opcional. Utilize quando enablePrepare = true && framework = calabash
.
Especifica o caminho do ficheiro para o ficheiro de configuração Pepino, que normalmente cucumber.yml
é .
calabashProfile
- Perfil a executar
string
. Opcional. Utilize quando enablePrepare = true && framework = calabash
.
Especifica o perfil a executar. Este valor tem de existir no ficheiro de configuração Pepino.
calabashSkipConfigCheck
- Ignorar Verificação de Configuração
boolean
. Opcional. Utilize quando enablePrepare = true && framework = calabash
. Valor predefinido: false
.
Força a tarefa a ser executada sem um perfil de Pepino.
uitestBuildDir
- Criar Diretório
string
. Necessário quando enablePrepare = true && framework = uitest
.
Especifica o caminho para o diretório com assemblagens de teste incorporadas.
uitestStoreFile
- Armazenar Ficheiro
string
. Opcional. Utilize quando enablePrepare = true && framework = uitest
.
Especifica o caminho para o ficheiro de arquivo.
uitestStorePass
- Armazenar Palavra-passe
string
. Opcional. Utilize quando enablePrepare = true && framework = uitest
.
Especifica a palavra-passe do ficheiro de arquivo. Utilize uma nova variável com o respetivo bloqueio ativado no separador Variáveis para encriptar este valor.
uitestKeyAlias
- Alias de Chave
string
. Opcional. Utilize quando enablePrepare = true && framework = uitest
.
Especifica o alias que identifica o par de chaves públicas/privadas utilizado no ficheiro de arquivo.
uitestKeyPass
- Palavra-passe da Chave
string
. Opcional. Utilize quando enablePrepare = true && framework = uitest
.
Especifica a palavra-passe da chave para o alias e o ficheiro de arquivo. Utilize uma nova variável com o respetivo bloqueio ativado no separador Variáveis para encriptar este valor.
uitestToolsDir
- Diretório ferramentas de teste
string
. Opcional. Utilize quando enablePrepare = true && framework = uitest
.
Especifica o caminho para o diretório com ferramentas test-cloud.exe
de teste da IU do Xamarin que contém .
signInfo
- Informações de Assinatura
string
. Opcional. Utilize quando framework = calabash || framework = uitest
.
Utiliza informações de assinatura para assinar o servidor de teste.
xcuitestBuildDir
- Criar Diretório
string
. Opcional. Utilize quando enablePrepare = true && framework = xcuitest
.
Especifica o caminho para o diretório de saída da compilação, que normalmente é $(ProjectDir)/Build/Products/Debug-iphoneos
.
xcuitestTestIpaPath
- Testar Caminho do IPA
string
. Opcional. Utilize quando enablePrepare = true && framework = xcuitest
.
Especifica o caminho para o *.ipa
ficheiro com os testes XCUITest.
prepareOpts
- Opções Adicionais
string
. Opcional. Utilize quando enablePrepare = true
.
Especifica argumentos adicionais a transmitir para mobile-center test prepare step
.
enableRun
- Executar Testes
boolean
. Valor predefinido: true
.
credsType
- Método de Autenticação
string
. Necessário quando enableRun = true
. Valores permitidos: serviceEndpoint
(Ligação do Mobile Center), inputs
(Credenciais). Valor predefinido: serviceEndpoint
.
Especifica o método de autenticação. Utilize uma ligação de ponto final de serviço do Mobile Center ou especifique as credenciais para ligar ao Visual Studio Mobile Center.
serverEndpoint
- Ligação do Centro Móvel
string
. Necessário quando enableRun = true && credsType = serviceEndpoint
.
Especifica o ponto final de serviço para a ligação do Visual Studio Mobile Center. Para criar um, clique na ligação Gerir e crie um novo ponto final de serviço.
username
- Nome de Utilizador do Mobile Center
string
. Necessário quando enableRun = true && credsType = inputs
.
Visite o Azure Mobile Center para definir o seu nome de utilizador.
password
- Palavra-passe do Mobile Center
string
. Necessário quando enableRun = true && credsType = inputs
.
Visite o Azure Mobile Center para definir a sua palavra-passe. Esta cadeia pode aceitar uma variável definida nas definições de compilação/versão como $(passwordVariable)
. 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 {username}
e {app_identifier}
para uma aplicação, localize a listagem da aplicação nas Aplicações Móveis do Azure. O URL está no formato de https://mobile.azure.com/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 Mobile Center Test Beacon.
series
- Série de Testes
string
. Opcional. Utilize quando enableRun = true
. Valor predefinido: master
.
Especifica o nome da série para organizar execuções de teste (por exemplo master
, , production
, beta
).
dsymDir
- Diretório dSYM
string
. Opcional. Utilize quando enableRun = true
.
Especifica o caminho para o diretório dSYM, que contém ficheiros de símbolo iOS.
locale
- Linguagem do Sistema
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
.
Se o seu idioma não for apresentado, especifique Outro e introduza a respetiva região, como en_US
.
userDefinedLocale
- Outra Região
string
. Opcional. Utilize quando enableRun = true && locale = user
.
Especifica 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
.
loginOpts
- Opções Adicionais para Início de Sessão
string
. Opcional. Utilize quando enableRun = true && credsType = inputs
.
Especifica argumentos adicionais que são transmitidos para mobile-center login step
.
runOpts
- Opções Adicionais para Executar
string
. Opcional. Utilize quando enableRun = true
.
Especifica argumentos adicionais que são transmitidos para mobile-center test run
.
async
- Não aguarde pelo resultado do teste
boolean
. Opcional. Utilize quando enableRun = true
. Valor predefinido: false
.
Quando definido como true
, executa comandos de forma assíncrona e sai quando os testes são carregados sem aguardar pelos resultados do teste.
cliLocationOverride
- Localização da CLI do centro móvel
string
.
Especifica o caminho para a mobile-center
interface de linha de comandos (CLI).
debug
- Ativar Saída de Depuração
boolean
. Valor predefinido: false
.
Adiciona --debug
à mobile-center
interface de linha de comandos (CLI).
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.
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 | Todas as versões de agente suportadas. |
Categoria da tarefa | Teste |