次の方法で共有

Xamarin.iOS アプリの準備

  • [アーティクル]

重要

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

サポートタイムラインと代替手段の詳細については、こちらを参照してください。

このガイドでは、App Center テストにアップロードするために 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 エージェントを検索し、[パッケージの追加] をクリックします。

Xamarin Test Cloud Agent (macOS) の追加

Visual Studio (Windows)

重要

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

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

Xamarin Test Cloud エージェントの追加 (ウィンドウ)

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

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

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

警告

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

ENABLE_TEST_CLOUD条件付きコンパイル ステートメントで初期化コードを囲むと、Xamarin リンカーは、ENABLE_TEST_CLOUD フラグを使用するビルドで Xamarin Test Cloud Agent を残します。 通常、 ビルドをデバッグ しますが、リリース ビルドは デバッグ しません。 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