Xamarin.iOS アプリの準備

  • [アーティクル]

このガイドでは、App Center Test にアップロードするために Xamarin.UITests を準備する手順について説明します。 開始するプラットフォームを選択します。

Xamarin.iOS アプリでは、Xamarin Test Cloud Agent がアプリの .ipa ファイルにリンクされている必要があります。 Xamarin Test Cloud エージェントは、Xamarin.UITests が iOS ユーザー インターフェイスと対話できるようにする、特殊な埋め込み HTTP サーバーです。 テスト クラウド エージェントは、NuGetを使用して iOS プロジェクトに追加されます。

ヒント

Xamarin 以外の iOS アプリも Xamarin.UITest でサポートされていますが、Xamarin Test Cloud エージェントの代わりに 、Calabash をリンクする必要があります。

Visual Studio for Mac

Visual Studio for Macの iOS プロジェクトの場合は、[パッケージ] フォルダーを右クリックし、[パッケージの追加] を選択します。 Xamarin Test Cloud エージェントを検索し、[パッケージの追加] をクリックします。

Adding the Xamarin Test Cloud Agent (macOS)

Visual Studio (Windows)

重要

iOS アプリの Xamarin.UITests は、Windowsではローカルで実行できません。 引き続き、Windowsから App Center Test を作成、コンパイル、アップロードできます。

WindowsのVisual Studioの iOS プロジェクトの場合は、プロジェクトを右クリックし、コンテキスト メニューから [NuGet パッケージの管理] を選択します。 NuGet パッケージ マネージャーXamarin Test Cloud エージェントを検索し、[OK] をクリックしてそのパッケージをインストールします。

Adding the Xamarin Test Cloud Agent (windows)

Xamarin Test Cloud エージェントを初期化する

iOS プロジェクトに Xamarin Test Cloud Agent を追加した後、iOS アプリの起動時に Xamarin Test Cloud エージェントを初期化する必要があります。 AppDelegate クラスを編集し、次のスニペットをメソッドにFinishedLaunching追加します。

#if ENABLE_TEST_CLOUD
Xamarin.Calabash.Start();
#endif

警告

Xamarin Test Cloud エージェントを含むアプリを送信した場合、Apple はアプリを拒否します。 Xamarin Test Cloud エージェントは、開発プロビジョニング プロファイルで署名されたアプリでのみサポートされます。 App Center Test に送信されると、可能であれば、いずれかの開発プロビジョニング プロファイルで IPA が自動的に再署名されます。

ENABLE_TEST_CLOUD条件付きコンパイル ステートメントで初期化コードを囲むと、Xamarin リンカーは、ENABLE_TEST_CLOUD フラグを使用するビルド内の Xamarin Test Cloud エージェントを残します。 通常は ビルドをデバッグ しますが、リリース ビルドは デバッグ しません。 Visual Studioで作成された新しい Xamarin.iOS アプリは、このアプローチを使用します。

アップロード コマンドの生成

テスト スイートが準備されたら、 テストをアップロードして実行するためのテスト実行をセットアップ できます。 このプロセスでは、次のようなプロトタイプコマンド ラインが生成されます。

appcenter test run uitest --app "MyOrg/MyApp" --devices "MyOrg/MyDeviceSet" --app-path pathToFile.ipa --test-series "main" --locale "en_US" --build-dir pathToUITestBuildDir

コマンド ラインには、いくつかの変更が必要です。

  1. 引数のパスを指定する--app-path&--build-dir必要があります。
  2. CLI で自動的に見つからない場合は、使用している UITest パッケージを指定する必要 がある場合があります 。 --uitest-tools-dir /Users/{your username}/.nuget/packages/xamarin.uitest/{UITest version}/tools