Share via


XamarinTestCloud@1 - Tâche Xamarin Test Cloud v1

XamarinTestCloud@1 est déconseillé. À l’origine, cette tâche était utilisée dans un pipeline de build ou de mise en production pour tester des applications mobiles avec Xamarin Test Cloud à l’aide de Xamarin.UITest.

Notes

Cette tâche est déconseillée et sera retirée le 31 janvier 2024.

Vous pouvez maintenant vous inscrire auprès d’App Center et utiliser la tâche AppCenterDistribute@3 à la place.

XamarinTestCloud@1 est déconseillé. À l’origine, cette tâche était utilisée dans un pipeline de build ou de mise en production pour tester des applications mobiles avec Xamarin Test Cloud à l’aide de Xamarin.UITest.

Notes

Vous pouvez maintenant vous inscrire auprès d’App Center et utiliser la tâche AppCenterDistrivbute#3 à la place.

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.

Entrées

appFile - Fichier d’application
Alias d’entrée : app. string. Obligatoire.

Spécifie le chemin relatif à partir de la racine du référentiel des applications à tester. Des caractères génériques peuvent être utilisés. Par exemple, **/*.apk pour tous les fichiers APK dans tous les sous-dossiers. En savoir plus sur les modèles de correspondance de fichiers.


dsymFile - fichier dSYM (iOS uniquement)
Alias d’entrée : dsym. string.

Fournit un chemin d’accès relatif au .ipa fichier. Pour faciliter la lecture des journaux d’incident, vous pouvez charger un fichier dSYM associé à votre application. Ce champ s’applique uniquement aux applications iOS. Des caractères génériques peuvent être utilisés. Par exemple : *.dSYM. En savoir plus sur les modèles de correspondance de fichiers.


teamApiKey - Clé API d’équipe
string. Obligatoire.

Spécifie votre clé API Xamarin Test Cloud Team, qui se trouve sous Teams & Apps. Utilisez une variable secrète pour éviter d’exposer cette valeur.


email - E-mail utilisateur
Alias d’entrée : user. string. Obligatoire.

Spécifie l’adresse e-mail de votre compte Xamarin Test Cloud.


devices - Dispositifs
string. Obligatoire.

Spécifie la chaîne d’appareils générée par Xamarin Test Cloud. La chaîne est la valeur de l’argument --devices de ligne de commande d’une série de tests Test Cloud.


series - Série
string. Obligatoire. Valeur par défaut : master.

Spécifie le nom de la série pour l’organisation des séries de tests (par exemple master, production, beta).


testAssemblyDirectory - Répertoire d’assembly de test
Alias d’entrée : testDir. string. Obligatoire.

Spécifie le chemin relatif du dossier contenant les assemblys de test, par exemple : SolutionName/TestsProjectName/bin/Release.


parallelizationOption - Parallélisation
Alias d’entrée : parallelization. string. Obligatoire. Valeurs autorisées : none, --fixture-chunk (Par fixation de test), --test-chunk (Par méthode de test). Valeur par défaut : none.

Spécifie les tests à exécuter simultanément.


localeOption - Langue système
Alias d’entrée : locale. string. Obligatoire. Valeurs autorisées : da_DK (Danois (Danemark)), nl_NL (Néerlandais (Pays-Bas)), en_GB (Anglais (Royaume-Uni)), en_US (Anglais (États-Unis)), fr_FR (Français (France)), de_DE (Allemand (Allemagne)), (Japonais)), ru_RUja_JP (Russe (Russie)), es_MX (Espagnol (Mexique)), es_ES (Espagnol (Espagne)), user (Autre). Valeur par défaut : en_US.

Spécifie votre langue. Si votre langue n’est pas affichée, sélectionnez Other et entrez ses paramètres régionaux ci-dessous, tels que en_US.


userDefinedLocale - Autres paramètres régionaux
string. facultatif. Utilisez quand locale = user.

Entre n’importe quel code de langue ISO-639 à deux lettres ainsi que tout code de pays ISO 3166 à deux lettres au format [langue]_[pays], par en_USexemple .


testCloudFile - test-cloud.exe emplacement
Alias d’entrée : testCloudLocation. string. Obligatoire. Valeur par défaut : **/packages/**/tools/test-cloud.exe.

Spécifie le chemin d’accès à test-cloud.exe. Les caractères génériques peuvent être utilisés, et lorsqu’ils le sont, la première occurrence de test-cloud.exe est utilisée. En savoir plus sur les modèles de correspondance de fichiers.


optionalArgs - Arguments facultatifs
string.

Spécifie les arguments supplémentaires passés à test-cloud.exe.


publishNUnitResults - Publier des résultats dans Azure Pipelines
boolean. Valeur par défaut : true.

Spécifie l’option --nunit-xml à transmettre pour test-cloud.exeque les résultats du fichier xml NUnit soient publiés dans Azure Pipelines.


publishNUnitResults - Publier les résultats dans Azure Pipelines/TFS
boolean. Valeur par défaut : true.

Spécifie l’option --nunit-xml à transmettre afin test-cloud.exeque les résultats du fichier xml NUnit soient publiés sur TFS ou Azure Pipelines.


Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Configuration requise

Condition requise Description
Types de pipelines YAML, build classique, version classique
S’exécute sur Agent, DeploymentGroup
Demandes None
Capabilities Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes Quelconque
Variables settables Quelconque
Version de l’agent 1.83.0 ou version ultérieure
Catégorie de la tâche Test