UI テストに Azure DevOps を使用する

  • [アーティクル]

重要

Visual Studio App Center は、2025 年 3 月 31 日に廃止される予定です。 完全に廃止されるまで Visual Studio App Center を引き続き使用できますが、移行を検討できる推奨される代替手段がいくつかあります。

サポートタイムラインと代替方法の詳細をご確認ください。

このガイドでは、アプリケーション バイナリ (.apk または .ipa ファイル) を作成する既存の Azure Pipelines ビルドを変更して、App Center Test でテスト スイートを実行する App Center テスト タスクを追加する方法について説明します。

Azure Pipelines は、Azure DevOps Services の一部として利用できます。 Azure Pipelines は、任意のアプリのビルド、テスト、配置パイプラインを実装するのに役立ちます。 Azure DevOps Services または Azure Pipelines の詳細については、 Azure DevOps のドキュメント または Azure Pipelines をそれぞれ参照してください。

Azure Pipelines の App Center テスト タスクを使用すると、App Center Test でテスト スイートを実行できます。 Appium、XCUItest、Espresso、Xamarin.UITest フレームワークを使用できます。 フレームワークの詳細については、「 App Center Test Supported frameworks 」ページを参照してください。

各フレームワークには、このガイドの独自のセクションがあり、Azure Pipelines で App Center Test タスク定義を設定するための基本的な要件について説明します。

一般的な構成手順

開始する前に

テストを開始する前に、次のものが必要です。

  • アプリケーション バイナリ (.apk または .ipa ファイル) を作成する Azure Pipelines ビルド。
  • アクティブな App Center テスト アカウント。 App Center テストの試用版は、 App Center でアクティブ化できます。 まずアプリを選択し、左側のメニューで [テスト] を選択します。
  • Node 10.x.x. を使用するようにパイプラインを構成するAzure DevOps のドキュメントを読むドキュメントは Javascript に関する内容ですが、この原則もここに適用されます。

Azure Pipelines の一般的な構成

Azure Pipelines プロジェクトを見つけて、 Edit 用に開きます。 [ + ] をクリックして新しいタスクを追加し、 App center を検索します。 App Center テストの Azure Pipelines 検索画面

App Center Test タスクの横にある Add をクリックします。 画面の左側で、追加した Test with Visual Studio App Center タスクをクリックして選択し、変更します。 App Center Test タスクはセクションに分かれています。 App Center テスト タスクの一般的なセクション

上部のセクションで、アプリ バイナリ (.apk または .ipa) へのパスを Binary アプリケーション ファイル パス フィールドに挿入します。

App Center テストへの接続

サービスを使用する前に App Center にサインインします。使用できる認証方法は 2 つあります。

最初のメソッドは API トークンを使用します。アカウントの API トークンを取得するには:

  • App Center にサインインし、App Center ポータルの左上隅にあるユーザー設定アイコンをクリックします。
  • 表示されるメニューで、 Account 設定を選択します。
  • Settings パネルで、API トークンを選択します。
  • パネルの右上隅にある New API トークン ボタンをクリックします。
  • 新しい API トークンに名前を付けます。たとえば、Azure DevOps 呼び出すことができます。 今後、この名前は、サービスを使用しているサービスを識別するのに役立ちます。 生成された API トークンを示す画面
  • [新しい API トークンの追加] ボタンをクリックします。 ポップアップに新しい API トークンが表示されます。このポップアップは 時間です App Center はこのトークンを表示します。 クリップボード ボタンをクリックして、API トークンをブラウザーのクリップボードにコピーします。 必要に応じて後で再度安全に参照できる API トークンをどこか (Azure Key Vault など) に保存します。

クリップボードの API トークンを使用します。

  • Azure DevOps Services ウィンドウに切り替えます。 App Center 接続フィールドの App Center テスト タスクの Run セクションで、[追加] ボタンをクリックします。
  • フォームの Name フィールドに接続の適切な名前を設定します (例: App Center)。
  • App Center API トークンを API トークン フィールドに貼り付けます。
  • [閉じる] をクリックしてセットアップを完了します。

新しく作成した接続が [App Center 接続] フィールドに表示されていることを確認します。 [実行] セクションの App Center テスト認証

2 番目の方法では、App Center アカウントの資格情報を使用します。

  • Authentication メソッドドロップダウン メニューから Credentials を選択します。
  • App Center ユーザー名と App Center パスワードフィールドに、App Center アカウントの資格情報を入力します。

Note

App Center のユーザー名は、 App Center アカウント プロファイルにあります。 Microsoft の資格情報を使用してサインインする場合は、パスワードを使用してアカウントを設定するか、タスクがログインできません。 App Center でパスワードを設定。

Appium

  • テストの実行を作成する前に、このガイドの「開始する前に」セクションの手順を完了してください。
  • App Center テスト、Appium テスト用にリポジトリを準備します。

Appium の Azure Pipelines 構成

最初に、「 Azure Pipelines の一般的な構成で説明したように、App Center テスト タスクをビルド定義に追加します。

Appium フレームワークのテスト セクションを準備する

[テストの準備] セクションで、 [Prepare テスト ] チェック ボックスがオンになっていることを確認し、 Test Framework の場合appium テスト フレームワーク 選択します。 Appium のテスト クラス、dependency-jars、および pom.xml ファイルへのパスを Build ディレクトリ フィールドに挿入します。 通常、これら 3 つの成果物は upload フォルダーにあります。

これで、テストの実行を構成できます。 必要なすべての情報は、App Center の [テスト] で新しいテストを作成することで見つかります。 テスト実行の開始の手順に従います。 送信ページ (テスト実行セットアップの最後のページ) を開いたままにして、App Center テスト タスクを設定するときにその情報を使用できるようにします。

appcenter test run appium --app "username/appname" --devices 209ed689
 --app-path pathToFile.apk --test-series "main" --locale "en_US"
  --build-dir target/upload

App Center テスト タスクの [実行] セクション

  • 送信ページでは、アプリ の slug が --app パラメーターです。 App Slug フィールドに挿入します。
  • デバイスの選択は、 --devices パラメーターです。 Devices フィールドに挿入します。
  • テスト系列 は自由形式のテキスト フィールドです。何でもかまいません。 --test-series パラメーターです。
  • システム言語 はドロップダウン メニューです。 [その他 を選択すると、その他のロケールフィールドが表示され、言語と国コードを次の形式で入力できます:en_US。

構成を保存すると、ビルドと App Center テストの実行を開始するように設定されます。

エスプレッソ

  • テストの実行を作成する前に、このガイドの「開始する前に」セクションの手順を完了してください。
  • App Center テスト、エスプレッソ テスト用にリポジトリを準備する方法について説明します。

エスプレッソ用の Azure Pipelines の構成

最初に、「 Azure Pipelines の一般的な構成で説明したように、App Center テスト タスクをビルド定義に追加します。

Espresso フレームワークのテスト セクションを準備する

[テストの準備] セクションで、 [Prepare テスト ] チェック ボックスがオンになっていることを確認し、 Test Framework の場合Espresso Test Framework 選択します。

これで、テストの実行を構成できます。 必要なすべての情報は、App Center の [テスト] で新しいテストを作成することで見つかります。 テスト実行の開始の手順に従います。 送信ページ (テスト実行セットアップの最後のページ) を開いたままにして、App Center テスト タスクを設定するときにその情報を使用できるようにします。

appcenter test run espresso --app "username/appname" --devices 209ed689
 --app-path pathToFile.apk --test-series "main" --locale "en_US"
  --build-dir pathToEspressoBuildFolder

App Center テスト タスクの [実行] セクション

  • 送信ページでは、アプリ の slug が --app パラメーターです。 App Slug フィールドに挿入します。
  • デバイスの選択は、 --devices パラメーターです。 Devices フィールドに挿入します。
  • テスト系列 は自由形式のテキスト フィールドです。何でもかまいません。 --test-series パラメーターです。
  • システム言語 はドロップダウン メニューです。 [その他 を選択すると、その他のロケールフィールドが表示され、言語と国コードを次の形式で入力できます:en_US。

構成を保存すると、ビルドと App Center テストの実行を開始するように設定されます。

Xamarin.UITest

  • テストの実行を作成する前に、このガイドの「開始する前に」セクションの手順を完了してください。
  • App Center Test、Xamarin.UITest テスト用に Xamarin.Android リポジトリを準備する方法について説明します。
  • App Center Test、Xamarin.UITest テスト用に Xamarin.iOS リポジトリを準備する方法について説明します。

Xamarin.UITest の Azure Pipelines 構成

最初に、「 Azure Pipelines の一般的な構成で説明したように、App Center テスト タスクをビルド定義に追加します。

Xamarin.UITest フレームワークのテスト セクションを準備する

[テストの準備] セクションで、 [Prepare テスト] チェック ボックスがオンになっていることを確認し、Test Framework で [Xamarin UI テストが選択されていることを確認します。 ビルド ディレクトリへのパスを挿入します。ほとんどの場合、ビルド フォルダーは <ProjectName>/bin/<configuration> です。

これで、テストの実行を構成できます。 必要なすべての情報は、App Center の [テスト] で新しいテストを作成することで見つかります。 テスト実行の開始の手順に従います。 送信ページ (テスト実行セットアップの最後のページ) を開いたままにして、App Center テスト タスクを設定するときにその情報を使用できるようにします。

appcenter test run uitest --app "username/appname" --devices 209ed689
 --app-path pathToFile.apk --test-series "main" --locale "en_US"
  --build-dir pathTUITestBuildDir

App Center テスト タスクの [実行] セクション

  • 送信ページでは、アプリ の slug が --app パラメーターです。 App Slug フィールドに挿入します。
  • デバイスの選択は、 --devices パラメーターです。 Devices フィールドに挿入します。
  • テスト系列 は自由形式のテキスト フィールドです。何でもかまいません。 --test-series パラメーターです。
  • システム言語 はドロップダウン メニューです。 [その他 を選択すると、その他のロケールフィールドが表示され、言語と国コードを次の形式で入力できます:en_US。

構成を保存すると、ビルドと App Center テストの実行を開始するように設定されます。

XCUITest

  • テストの実行を作成する前に、このガイドの「開始する前に」セクションの手順を完了してください。
  • App Center Test、XCUITest テスト用にリポジトリを準備する方法について説明します。

Note

パイプラインでは、App Center テスト タスクの前に、 Xcode タスク ステップと、テストに必要なテスト ランナー アプリをビルドするための build-for-testing のアクションが必要です。 このタスクでは、Advanced セクションの Arguments で、通常は -derivedDataPath DerivedData を使用して派生データ パスを指定します。 また、アプリケーションの .ipa file も必要になります。 .ipa fileは、同じXcode build-for-testingタスクでCreate app packageオプションをオンにするか、別のXcodeビルドステップまたはBashスクリプトステップでビルドできます。

XCUITest の Azure Pipelines 構成

最初に、「 Azure Pipelines の一般的な構成で説明したように、App Center テスト タスクをビルド定義に追加します。

XCUITest フレームワークのテスト セクションを準備する

[テストの準備] セクションで、 [Prepare Tests] チェック ボックスがオンになっていることを確認し、Test Framework で [XCUITest が選択されていることを確認します。 Xcode build-for-testing ステップからビルド ディレクトリへのパスを挿入します。 通常、ビルド フォルダーは DerivedData/Build/Products/Debug-iphoneos/ です。

これで、テストの実行を構成できます。 必要なすべての情報は、App Center の [テスト] で新しいテストを作成することで見つかります。 テスト実行の開始の手順に従います。 送信ページ (テスト実行セットアップの最後のページ) を開いたままにして、App Center テスト タスクを設定するときにその情報を使用できるようにします。

appcenter test run xcuitest --app "username/appname" --devices 209ed689 --test-series "main" --locale "en_US" --build-dir pathToXCUItestBuildFolder

App Center テスト タスクの [実行] セクション

  • 送信ページでは、アプリ の slug が --app パラメーターです。 App Slug フィールドに挿入します。
  • デバイスの選択は、 --devices パラメーターです。 Devices フィールドに挿入します。
  • テスト系列 は自由形式のテキスト フィールドです。何でもかまいません。 --test-series パラメーターです。
  • システム言語 はドロップダウン メニューです。 [その他 を選択すると、その他のロケールフィールドが表示され、言語と国コードを次の形式で入力できます:en_US。

構成を保存すると、ビルドと App Center テストの実行を開始するように設定されます。