次の方法で共有

XamarinTestCloud@1 - Xamarin Test Cloud v1 タスク

  • [アーティクル]

XamarinTestCloud@1は非推奨です。 当初、このタスクは Xamarin.UITest を使用して Xamarin Test Cloud でモバイル アプリをテストするために、ビルドまたはリリース パイプラインで使用されていました。

注意

このタスクは非推奨であり、2024 年 1 月 31 日に廃止されます。

App Center にサインアップし、代わりに AppCenterDistribute@3 タスクを使用できるようになりました。

XamarinTestCloud@1は非推奨です。 当初、このタスクは Xamarin.UITest を使用して Xamarin Test Cloud でモバイル アプリをテストするために、ビルドまたはリリース パイプラインで使用されていました。

注意

App Center にサインアップ し、代わりに AppCenterDistrivbute#3 タスクを使用できるようになりました。

構文

# 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.

入力

appFile - アプリ ファイル
入力エイリアス: app。 string. 必須です。

テストするアプリのリポジトリ ルートからの相対パスを指定します。 ワイルドカードを使用できます。 たとえば、 **/*.apk すべてのサブフォルダー内のすべての APK ファイルについてです。 ファイル マッチング パターンの詳細については、こちらを参照してください。


dsymFile - dSYM ファイル (iOS のみ)
入力エイリアス: dsym。 string.

ファイルに対する相対パスを提供します .ipa 。 クラッシュ ログを読みやすくするために、アプリに関連付けられている dSYM ファイルをアップロードできます。 このフィールドは、iOS アプリにのみ適用されます。 ワイルドカードを使用できます。 (例: *.dSYM)。 ファイル マッチング パターンの詳細については、こちらを参照してください。


teamApiKey - チーム API キー
string. 必須です。

Xamarin Test Cloud Team API キーを指定します。これは、 Teams & Apps の下にあります。 シークレット変数を使用して、この値が公開されないようにします。


email - ユーザーメール
入力エイリアス: user。 string. 必須です。

Xamarin Test Cloud アカウントのメール アドレスを指定します。


devices - デバイス
string. 必須です。

Xamarin Test Cloud によって生成されるデバイス文字列を指定します。 この文字列は、Test Cloud テスト実行の --devices コマンド ライン引数の値として見つけることができます。


series - シリーズ
string. 必須です。 既定値: master。

テスト実行を整理するための系列名を指定します (例: master、 production、 beta)。


testAssemblyDirectory - アセンブリ ディレクトリをテストする
入力エイリアス: testDir。 string. 必須です。

テスト アセンブリを含むフォルダーへの相対パスを指定します(例: SolutionName/TestsProjectName/bin/Release)。


parallelizationOption - 並列
入力エイリアス: parallelization。 string. 必須です。 使用できる値: none、 --fixture-chunk (テスト フィクスチャ別)、 --test-chunk (テスト メソッド別)。 既定値: none。

同時に実行するテストを指定します。


localeOption - システム言語
入力エイリアス: locale。 string. 必須です。 使用できる値: da_DK (デンマーク語 (デンマーク)、 nl_NL (オランダ語 (オランダ語)、 en_GB (英語 (イギリス))、 en_US (英語 (米国)、 fr_FR (フランス語 (フランス))、 de_DE (ドイツ語 (ドイツ))、(日本語 (日本) ja_JP 、 ru_RU (ロシア語 (ロシア))、 es_MX (スペイン語 (スペイン))、 es_ES (スペイン語)、 user (その他)。 既定値: en_US。

言語を指定します。 言語が表示されない場合は、 を選択 Other し、そのロケールを以下に入力します (例: en_US)。


userDefinedLocale - その他のロケール
string. 省略可能。 の場合は locale = userを使用します。

2 文字の ISO-639 言語コードと、任意の 2 文字の ISO 3166 国コードを [language]_[country]( など en_US) の形式で入力します。


testCloudFile - test-cloud.exe の場所
入力エイリアス: testCloudLocation。 string. 必須です。 既定値: **/packages/**/tools/test-cloud.exe。

へのパスを test-cloud.exe指定します。 ワイルドカードは使用できます。ワイルドカードが使用される場合は、 の最初の test-cloud.exe 出現箇所が使用されます。 ファイル マッチング パターンの詳細については、こちらを参照してください。


optionalArgs - 省略可能な引数
string.

に渡される追加の引数を test-cloud.exe指定します。


publishNUnitResults - Azure Pipelines に結果を発行する
boolean. 既定値: true。

--nunit-xml NUnit xml ファイルからの結果が Azure Pipelines にtest-cloud.exe発行されるように、渡すオプションを指定します。


publishNUnitResults - Azure Pipelines/TFS に結果を発行する
boolean. 既定値: true。

--nunit-xml NUnit xml ファイルからの結果が TFS または Azure Pipelines に発行されるように、渡test-cloud.exeすオプションを指定します。


タスク制御オプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。

出力変数

[なし] :

必要条件

要件 説明
パイプラインの種類 YAML、クラシック ビルド、クラシック リリース
上で実行 エージェント、DeploymentGroup
確認要求 なし
Capabilities このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限 Any
設定可能な変数 Any
エージェントのバージョン 1.83.0 以上
タスクのカテゴリ テスト