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 Test タスクの横にある Add をクリックします。 画面の左側で、追加した Test with Visual Studio App Center タスクをクリックして選択し、変更します。 App Center Test タスクはセクションに分かれています。
上部のセクションで、アプリ バイナリ (.apk
または .ipa
) へのパスを Binary アプリケーション ファイル パス フィールドに挿入します。
App Center テストへの接続
サービスを使用する前に App Center にサインインします。使用できる認証方法は 2 つあります。
最初のメソッドは API トークンを使用します。アカウントの API トークンを取得するには:
- App Center にサインインし、App Center ポータルの左上隅にあるユーザー設定アイコンをクリックします。
- 表示されるメニューで、 Account 設定を選択します。
- Settings パネルで、API トークンを選択します。
- パネルの右上隅にある New API トークン ボタンをクリックします。
- 新しい API トークンに名前を付けます。たとえば、Azure DevOps 呼び出すことができます。 今後、この名前は、サービスを使用しているサービスを識別するのに役立ちます。
- [新しい 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 接続] フィールドに表示されていることを確認します。
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 テスト タスクをビルド定義に追加します。
[テストの準備] セクションで、 [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
- 送信ページでは、アプリ の slug が
--app
パラメーターです。 App Slug フィールドに挿入します。 - デバイスの選択は、
--devices
パラメーターです。 Devices フィールドに挿入します。 - テスト系列 は自由形式のテキスト フィールドです。何でもかまいません。
--test-series
パラメーターです。 - システム言語 はドロップダウン メニューです。 [その他 を選択すると、その他のロケールフィールドが表示され、言語と国コードを次の形式で入力できます:
en_US
。
構成を保存すると、ビルドと App Center テストの実行を開始するように設定されます。
エスプレッソ
- テストの実行を作成する前に、このガイドの「開始する前に」セクションの手順を完了してください。
- App Center テスト、エスプレッソ テスト用にリポジトリを準備する方法について説明します。
エスプレッソ用の Azure Pipelines の構成
最初に、「 Azure Pipelines の一般的な構成で説明したように、App Center テスト タスクをビルド定義に追加します。
[テストの準備] セクションで、 [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
- 送信ページでは、アプリ の 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 テスト タスクをビルド定義に追加します。
[テストの準備] セクションで、 [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
- 送信ページでは、アプリ の 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 テスト タスクをビルド定義に追加します。
[テストの準備] セクションで、 [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
- 送信ページでは、アプリ の slug が
--app
パラメーターです。 App Slug フィールドに挿入します。 - デバイスの選択は、
--devices
パラメーターです。 Devices フィールドに挿入します。 - テスト系列 は自由形式のテキスト フィールドです。何でもかまいません。
--test-series
パラメーターです。 - システム言語 はドロップダウン メニューです。 [その他 を選択すると、その他のロケールフィールドが表示され、言語と国コードを次の形式で入力できます:
en_US
。
構成を保存すると、ビルドと App Center テストの実行を開始するように設定されます。