XamarinTestCloud@1 – Tarefa Xamarin Test Cloud v1

XamarinTestCloud@1 foi preterido. Originalmente, essa tarefa foi usada em um pipeline de build ou lançamento para testar aplicativos móveis com o Xamarin Test Cloud usando Xamarin.UITest.

Observação

Essa tarefa foi preterida e será desativada em 31 de janeiro de 2024.

Agora você pode se inscrever no App Center e usar a tarefa AppCenterDistribute@3 .

XamarinTestCloud@1 foi preterido. Originalmente, essa tarefa foi usada em um pipeline de build ou lançamento para testar aplicativos móveis com o Xamarin Test Cloud usando Xamarin.UITest.

Observação

Agora você pode se inscrever no App Center e usar a tarefa AppCenterDistrivbute#3 .

Syntax

# Xamarin Test Cloud v1
# [Deprecated] Test mobile apps with Xamarin Test Cloud using Xamarin.UITest. Instead, use the 'App Center test' task.
- task: XamarinTestCloud@1
  inputs:
    appFile: # string. Alias: app. Required. App file. 
    #dsymFile: # string. Alias: dsym. dSYM file (iOS only). 
    teamApiKey: # string. Required. Team API key. 
    email: # string. Alias: user. Required. User email. 
    devices: # string. Required. Devices. 
    series: 'master' # string. Required. Series. Default: master.
    testAssemblyDirectory: # string. Alias: testDir. Required. Test assembly directory. 
  # Advanced
    parallelizationOption: 'none' # 'none' | '--fixture-chunk' | '--test-chunk'. Alias: parallelization. Required. Parallelization. Default: none.
    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. System language. Default: en_US.
    #userDefinedLocale: # string. Optional. Use when locale = user. Other locale. 
    testCloudFile: '**/packages/**/tools/test-cloud.exe' # string. Alias: testCloudLocation. Required. test-cloud.exe location. Default: **/packages/**/tools/test-cloud.exe.
    #optionalArgs: # string. Optional arguments. 
    #publishNUnitResults: true # boolean. Publish results to Azure Pipelines. Default: true.
# Xamarin Test Cloud v1
# [Depreciated] Testing mobile apps with Xamarin Test Cloud using Xamarin.UITest - recommended task is now AppCenterTest.
- task: XamarinTestCloud@1
  inputs:
    appFile: # string. Alias: app. Required. App file. 
    #dsymFile: # string. Alias: dsym. dSYM file (iOS only). 
    teamApiKey: # string. Required. Team API key. 
    email: # string. Alias: user. Required. User email. 
    devices: # string. Required. Devices. 
    series: 'master' # string. Required. Series. Default: master.
    testAssemblyDirectory: # string. Alias: testDir. Required. Test assembly directory. 
  # Advanced
    parallelizationOption: 'none' # 'none' | '--fixture-chunk' | '--test-chunk'. Alias: parallelization. Required. Parallelization. Default: none.
    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. System language. Default: en_US.
    #userDefinedLocale: # string. Optional. Use when locale = user. Other locale. 
    testCloudFile: '**/packages/**/tools/test-cloud.exe' # string. Alias: testCloudLocation. Required. test-cloud.exe location. Default: **/packages/**/tools/test-cloud.exe.
    #optionalArgs: # string. Optional arguments. 
    #publishNUnitResults: true # boolean. Publish results to Azure Pipelines/TFS. Default: true.

Entradas

appFile - Arquivo de aplicativo
Alias de entrada: app. string. Obrigatórios.

Especifica o caminho relativo da raiz do repositório dos aplicativos para testar. Caracteres curinga podem ser usados. Por exemplo, **/*.apk para todos os arquivos APK em todas as subpastas. Saiba mais sobre padrões de correspondência de arquivos.


dsymFile - Arquivo dSYM (somente iOS)
Alias de entrada: dsym. string.

Fornece um caminho relativo ao .ipa arquivo. Para facilitar a leitura dos logs de falhas, você pode carregar um arquivo dSYM associado ao seu aplicativo. Esse campo só se aplica a aplicativos iOS. Caracteres curinga podem ser usados. Por exemplo: *.dSYM. Saiba mais sobre padrões de correspondência de arquivos.


teamApiKey - Chave de API de Equipe
string. Obrigatórios.

Especifica a chave da API da Equipe de Nuvem de Teste do Xamarin, que pode ser encontrada em Aplicativos & do Teams. Use uma variável secreta para evitar expor esse valor.


email - Email do usuário
Alias de entrada: user. string. Obrigatórios.

Especifica o endereço de email da sua conta do Xamarin Test Cloud.


devices - Dispositivos
string. Obrigatórios.

Especifica a cadeia de caracteres de dispositivos gerada pelo Xamarin Test Cloud. A cadeia de caracteres pode ser encontrada como o valor do argumento de linha de --devices comando de uma execução de teste de Nuvem de Teste.


series - Série
string. Obrigatórios. Valor padrão: master.

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


testAssemblyDirectory - Diretório de assembly de teste
Alias de entrada: testDir. string. Obrigatórios.

Especifica o caminho relativo para a pasta que contém os assemblies de teste, como: SolutionName/TestsProjectName/bin/Release.


parallelizationOption - Paralelização
Alias de entrada: parallelization. string. Obrigatórios. Valores permitidos: none, ( --fixture-chunk Por acessório de teste), --test-chunk (Por método de teste). Valor padrão: none.

Especifica testes a serem executados simultaneamente.


localeOption - Idioma do sistema
Alias de entrada: locale. string. Obrigatórios. 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 (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.

Especifica seu idioma. Se o idioma não for exibido, selecione Other e insira sua localidade abaixo, como en_US.


userDefinedLocale - Outra localidade
string. Opcional. Use quando locale = user.

Insere qualquer código de idioma ISO-639 de duas letras junto com qualquer código de país ISO 3166 de duas letras no formato [idioma]_[país], como en_US.


testCloudFile - test-cloud.exe local
Alias de entrada: testCloudLocation. string. Obrigatórios. Valor padrão: **/packages/**/tools/test-cloud.exe.

Especifica o caminho para test-cloud.exe. Curingas podem ser usados e, quando estiverem, a primeira ocorrência de test-cloud.exe é usada. Saiba mais sobre padrões de correspondência de arquivos.


optionalArgs - Argumentos opcionais
string.

Especifica os argumentos adicionais passados para test-cloud.exe.


publishNUnitResults - Publicar resultados no Azure Pipelines
boolean. Valor padrão: true.

Especifica a opção --nunit-xml a ser passada para para test-cloud.exeque os resultados do arquivo xml NUnit sejam publicados no Azure Pipelines.


publishNUnitResults - Publicar resultados no Azure Pipelines/TFS
boolean. Valor padrão: true.

Especifica a opção --nunit-xml para a qual os test-cloud.exeresultados do arquivo xml NUnit são publicados no TFS ou no Azure Pipelines.


Opções de controle da tarefa

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

Variáveis de saída

Nenhum.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
É executado em Agent, DeploymentGroup
Demandas Nenhum
Funcionalidades Essa tarefa não atende a nenhuma demanda por tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 1.83.0 ou superior
Categoria da tarefa Teste