ホット再起動を使用して iOS アプリをデプロイする

[アーティクル]
05/14/2024

通常、アプリをビルドするときに、コードがコンパイルされ、他のプロジェクトリソースと組み合わされて、シミュレーターまたはデバイスにデプロイされるアプリバンドルがビルドされます。このモデルでは、アプリを変更するときに、新しいアプリバンドルをビルドしてデプロイする必要があります。インクリメンタルビルドはコンパイル時間を短縮するのに役立ちますが、通常、デプロイには変更のサイズに関係なく同じ時間がかかります。

.NET マルチプラットフォームアプリ UI (.NET MAUI) のホット再起動を使用すると、Mac ビルドホストを必要とせずに、Visual Studio 2022 から 64 ビットローカル iOS デバイスに .NET MAUI アプリをすばやくデプロイできます。これにより、ローカルに接続された iOS デバイスに既に存在する既存のアプリバンドルに変更をプッシュすることで、完全なアプリバンドルの再構築が不要になります。コードファイル、リソース、プロジェクトの参照の変更をサポートしているため、開発中にアプリの変更をすばやくテストできます。

重要

ホット再起動は、Mac ビルドホストによって提供される完全なビルド環境の代わりではありません。たとえば、デプロイできるのはデバッグビルド構成を使用するアプリのみであり、静的ライブラリとフレームワーク、XCFrameworks、またはバインドリソースパッケージはサポートされません。詳細については、制限に関するページを参照してください。

ローカルに接続された iOS デバイスに .NET MAUI アプリをデプロイするには、ホット再起動を使用するために満たす必要がある要件がいくつかあります。

Visual Studio 2022 のバージョｘンは 17.3 以上である必要があります。
開発用コンピューターに iTunes (Microsoft Store または 64 ビットバージョン) がインストールされている必要があります。
Apple Developer Account と有料の Apple Developer Program に登録する必要があります。

セットアップ

ホット再起動を設定するには、次の手順を実行します。

Visual Studio のツールバーで、[デバッグターゲット] ドロップダウンを使用して [iOS ローカルデバイス]、[ローカルデバイス] エントリの順に選択します。
Visual Studio のツールバーで、[ローカルデバイス] を選択します。

[ホット再起動のセットアップ] セットアップウィザードが表示されます。これにより、ホット再起動の展開用にローカル iOS デバイスを設定する手順が示されます。
[ホット再起動のセットアップ] セットアップウィザードで、[次へ] を選択します。
iTunes がインストールされていない場合は、セットアップウィザードでインストールするように求められます。 [ホット再起動のセットアップ] セットアップウィザードで、iTunesのダウンロード を選択します。

Note

iTunes は、Microsoft Store からインストールすることも、Apple からダウンロードすることもできます。

iTunes がダウンロードされ、インストールされるのを待ちます。 Microsoft Store からインストールする場合は、インストールが完了したら開いてください。次に、追加のプロンプトに従って、ローカルに接続されているデバイスを検出できるようにします。
[ホット再起動のセットアップ] セットアップウィザードで、[次へ] を選択して、ローカル iOS デバイスの接続を求めるメッセージが表示されるウィザードの次の手順に進みます。
USB ケーブルを使用して、デバイスを iOS 開発用コンピューターに接続します。開発用コンピューターを信頼するように求めるプロンプトがデバイスに表示されることがあります。デバイスで、[信頼] をクリックし、追加のデバイスプロンプトに従います。
[ホット再起動のセットアップ] セットアップウィザードで、ローカル iOS デバイスが検出されたら、[次へ] を選択します。

Note

セットアップウィザードでローカルの iOS デバイスが検出されない場合は、ローカル iOS デバイスを開発用コンピューターから再接続します。さらに、iTunes がローカルの iOS デバイスを認識していることを確認します。
[ホット再起動のセットアップ] セットアップウィザードで、[個人アカウントでサインイン] ハイパーリンクをクリックして、個々の Apple 開発者 Program アカウントを使用するようにホット再起動を構成します。

[個別アカウント] ダイアログが表示されます。

Note

または、エンタープライズの Apple 開発者アカウントを使用するようにホット再起動を構成するには、[エンタープライズアカウントでサインイン] をクリックし、表示されるダイアログに資格情報を入力します。その後、ステップ 12 に進みます。
App Store Connect API キーを作成する。これには、Apple 開発者アカウントと有料の Apple Developer Program 登録が必要になります。 App Store Connect API キーの作成の詳細については、developer.apple.com の「App Store Connect API の API キーの作成」をご覧ください。
[個人アカウント] ダイアログで、App Store Connect API のキーデータを入力します。

名前、発行者 ID、キー ID などのデータは、App Store Connect で [ユーザーとアクセス] を選択し、[キー] タブを選択することで確認できます。秘密キー は、次の場所からダウンロードすることもできます。
[個人アカウント] ダイアログで、[追加] ボタンをクリックします。 [個別アカウント] ダイアログボックスが閉じます。
[ホット再起動のセットアップ] のセットアップウィザードで、[完了] ボタンをクリックします。

Apple Developer Program アカウントが Visual Studio に追加され、ホット再起動のセットアップ のセットアップウィザードが閉じます。
ソリューションエクスプローラーで、プロジェクトを右クリックして [プロパティ] を選択します。
プロジェクトのプロパティで、[iOS] を展開し、[バンドル署名] を選択します。 [スキーム] ドロップダウンを使用して [自動プロビジョニング] を選択し、[自動プロビジョニングの構成] ハイパーリンクをクリックします。

[自動プロビジョニングの構成] ダイアログが表示されます。
[自動プロビジョニングの構成] ダイアログで、Connect API キーのチームを選択します。

Visual Studio は、自動プロビジョニングプロセスを完了します。次に、[OK] ボタンをクリックして、[自動プロビジョニングの構成] ダイアログを閉じます。

Note

自動プロビジョニングを使用することをお勧めします。これにより、追加の iOS デバイスを簡単に配置用に構成できるようになります。ただし、適切なプロビジョニングプロファイルが存在する場合は、これを無効にして、手動プロビジョニングの使用を続行することができます。

ホット再起動を使用したデプロイとデバッグ

初期セットアップを実行後、接続されている iOS デバイスが [デバッグターゲット] ドロップダウンメニューに表示されます。アプリケーションをデプロイしてデバッグするには:

ローカルに接続されている iOS デバイスのロックが解除されていることを確認します。
Visual Studio のツールバーで、デバッグターゲットドロップダウンでローカルに接続されている iOS デバイスを選択し、[実行] ボタンをクリックしてアプリをビルドし、ローカルの iOS デバイスにデプロイします。
アプリをデプロイすると、Visual Studio に [デバッガーの接続] ダイアログが表示されます。

デバイスでアプリを起動すると、Visual Studio によって実行中のアプリにデバッガーが接続され、[デバッガーの接続] ダイアログが閉じます。

アプリのデバッグ中に、C# コードを編集して Visual Studio ツールバーの再起動ボタンを押すと、新しい変更が適用されたデバッグセッションを再起動できます。

コードが実行されるのを防ぐ

HOTRESTART プリプロセッサシンボルを使用して、ホット再起動でデバッグするときに特定のコードが実行されないようにすることができます。

#if !HOTRESTART
  // Code here won't be executed when debugging with hot restart
#endif

ホット再起動を有効にする

Visual Studio 2022 では、ホット再起動が既定で有効になっています。以前に無効にされている場合は、Visual Studio のメニューバーから [ツール > オプション] を選択して有効にすることができます。次に、[オプション] ダイアログボックスで Xamarin を展開し、[iOS 設定] を選択します。次に、[ホット再起動を有効にする] がオンになっていることを確認します。

Visual Studio 内でホット再起動を有効にする方法のスクリーンショット。

制限事項

ホット再起動を使用する場合は、次の制限があります。

デバッグビルド構成を使用するアプリのデプロイにのみ使用できます。運用目的でアプリをビルド、署名、デプロイするには、引き続き Mac ビルドホストが必要です。
ストーリーボードと XIB のファイルはサポートされていません。これらを実行時に読み込もうとすると、アプリがクラッシュする可能性があります。
静的な iOS ライブラリと静的なライブラリを含むフレームワークはサポートされていません。アプリがこれらを読み込もうとすると、ランタイムエラーまたはクラッシュが発生する可能性があります。
XCFrameworks およびバインドリソースパッケージは、静的 iOS ライブラリまたは静的ライブラリを含むフレームワークが含まれていない限り、サポートされます。
アセットカタログはサポートされていません。ホット再起動を使用すると、アプリには .NET アイコンと起動画面が表示されます。

トラブルシューティング

iOS は、アプリの起動時間と応答性を監視し、応答しないアプリを終了するウォッチドッグを使用します。たとえば、ウォッチドッグは、メインスレッドを長時間ブロックするアプリを終了します。古い iOS デバイスでは、デバッガーが接続する前に、ホット再起動を使用して展開されたアプリがウォッチドッグによって終了される場合があります。回避策として、アプリのスタートアップパスで実行される処理の量を減らし、より新しい iOS デバイスを使用します。

その他の問題を報告するには、[ヘルプ]> [フィードバックの送信]> [問題の報告] からフィードバックツールを使用してください。

次の方法で共有