アドホック配布用の iOS アプリを発行する

[アーティクル]
02/13/2024

アドホック配布は、主に幅広いユーザーグループ内のアプリのテストに使用され、Apple Developer Program と Apple Developer Enterprise Program で利用できます。アドホック配布のもう 1 つのユースケースは、App Store Connect がオプションではない場合の社内での配布です。

アドホック配布には、Apple Configurator を使用してアプリをインストールすることで、App Store の承認を必要としないという利点があります。ただし、開発と配布の両方で、メンバーシップ年あたり 100 台のデバイスに制限されており、デバイスを Apple Developer アカウントに追加する必要があります。

iOS アプリを配布するには、プロビジョニングプロファイルを使用してアプリをプロビジョニングする必要があります。プロビジョニングプロファイルは、コード署名情報だけでなく、アプリケーションの ID と使用する配布メカニズムも含むファイルです。

.NET マルチプラットフォームアプリ UI (.NET MAUI) iOS アプリを配布するには、それに固有の配布プロビジョニングプロファイルを構築する必要があります。このプロファイルを使用すると、アプリをリリース用にデジタル署名して、iOS デバイスにインストールできるようになります。アドホック配布プロビジョニングプロファイルには、アプリ ID、配布証明書、アプリをインストールできるデバイスの一覧が含まれます。テスト用にアプリをデバイスにデプロイしたときと同じアプリ ID を使用できます。ただし、配布証明書がまだない場合は、自分または組織を識別するための配布証明書を作成する必要があります。

アドホック配布プロビジョニングプロファイルを作成するプロセスは次のとおりです。

配布する証明書の作成詳細については、「配布証明書を作成する」を参照してください。
Apple Developer Account にデバイスを追加します。詳細については、「デバイスの追加」を参照してください。
アプリ ID を作成する詳細については、「アプリ ID を作成する」を参照してください。
プロビジョニングプロファイルを作成します。詳細については、「プロビジョニングプロファイルの作成」を参照してください。

配布する証明書の作成

配布証明書は、ID を確認するために使用されます。ディストリビューション証明書を作成する前に、Apple Developer アカウントを Visual Studio に追加していることを確認する必要があります。詳細については、「Apple アカウントの管理」をご覧ください。

配布証明書を作成する必要があるのは、まだ作成していない場合のみです。ディストリビューション証明書は、Apple Developer アカウントの Apple ID を使用して作成する必要があります。

配布証明書を作成するには:

Visual Studio
Visual Studio for Mac

Visual Studio で、[ツール > オプション>] Xamarin > Apple アカウントに移動します。
[Apple Developer Accounts]\(Apple 開発者アカウント\) ダイアログでチームを選択し、[View Details...]\(詳細の表示\)ボタンをクリックします。
[詳細] ダイアログで、[証明書の作成] をクリックし、[iOS ディストリビューション] を選択します。正しいアクセス許可を持っている場合は、新しい署名 ID が作成され、Apple と同期されます。

重要

IDE がペアリングされている場合、署名 ID を構成する秘密キーと証明書も Mac ビルドホストのキーチェーンアクセスにエクスポートされます。詳細については、「iOS 開発のための Mac とのペアリング」をご覧ください。

証明書キーペアについて

ディストリビューションプロファイルには、証明書、関連付けられているキー、および Apple Developer アカウントに関連付けられているプロビジョニングプロファイルが含まれています。ディストリビューションプロファイルには 2 つのバージョンがあります。1 つは Apple Developer アカウントに存在し、もう 1 つはローカルコンピューターに存在します。 2 つの違いは、含まれるキーの種類です。Apple Developer Account のプロファイルには証明書に関連付けられているすべての公開キーが含まれますが、ローカルコンピューター上のコピーにはすべての秘密キーが含まれています。証明書を有効にするには、キーペアが一致している必要があります。

警告

証明書と関連付けられているキーを失うと、既存の証明書を失効させ、プロビジョニングプロファイルを再作成する必要があるため、非常に混乱を招く可能性があります。

配布プロファイルの作成

アドホック配布プロビジョニングプロファイルを使用すると、.NET MAUI iOS アプリをリリース用にデジタル署名できるため、特定の iOS デバイスにインストールできます。アドホック配布プロビジョニングプロファイルには、アプリ ID、配布証明書、アプリをインストールできるデバイスの一覧が含まれます。サポートするデバイスは、Xcode でサポートされているバージョンの iOS を実行している必要があります。

デバイスを追加する

プロビジョニングプロファイルを作成するときは、アプリを実行できるデバイスをプロファイルに含める必要があります。プロビジョニングプロファイルに追加するデバイスを選択する前に、まず Apple Developer アカウントにデバイスを追加する必要があります。次の手順でデバイスを追加できます。

ローカル Mac にプロビジョニングするデバイスを USB ケーブルで接続します。
Xcode を開き、ウィンドウ > デバイスとシミュレーターに移動します。
Xcode で、[デバイス] タブを選択し、接続されているデバイスの一覧からデバイスを選択します。
Xcode で、識別子の値をクリップボードにコピーします。
Web ブラウザーで、Apple Developer Account の [デバイス] セクションに移動し、+ ボタンをクリックします。
[新しいデバイスの登録] ページで、適切なプラットフォームを設定し、新しいデバイスの名前を指定します。次に、クリップボードの識別子をデバイス ID (UDID) フィールドに貼り付け、[続行] をクリックします。
[新しいデバイスの登録] ページで情報を確認し、[登録] をクリックします。

.NET MAUI iOS アプリをデプロイする iOS デバイスについて、前の手順を繰り返します。

アプリ ID を作成する

配布するアプリを識別するには、アプリ ID が必要です。アプリ ID は逆引き DNS 文字列に似ています。これはアプリを一意に識別するもので、アプリのバンドル識別子と同じである必要があります。テスト用にアプリをデバイスにデプロイしたときと同じアプリ ID を使用できます。

アプリ ID には 2 種類あります。

ワイルドカード。ワイルドカードアプリ ID を使用すると、1 つのアプリ ID を使用して複数のアプリを照合できます。通常は com.domainname.* の形式を使用します。ワイルドカードアプリ ID を使用して、複数のアプリを配布できます。アプリ固有の機能を有効にしないアプリに使用する必要があります。
明示。明示的なアプリ ID は、1 つのアプリに対して一意であり、通常は com.domainname.myid の形式を使用します。明示的なアプリ ID を使用して、バンドル識別子が一致する 1 つのアプリを配布できます。明示的なアプリ ID は、通常、Apple Pay や Game Center などのアプリ固有の機能を有効にするアプリに使用されます。機能の詳細については、「機能」をご覧ください。

新しいアプリ ID の作成方法:

Apple 開発者アカウントで、証明書、ID、プロファイルに 移動します。
[証明書]、[識別子]、[プロファイル] ページで、[識別子] タブを選択します。
[識別子] ページで 、ボタンを + クリックして新しいアプリ ID を作成します。
[新しい識別子の登録] ページで、[続行] ボタンをクリックする前に、[アプリ ID] ラジオボタンを選択します。
[新しい識別子の登録] ページで、[続行] ボタンをクリックする前に [アプリ] を選択します。
[アプリ ID の登録] ページで説明を入力し、[明示的] または [ワイルドカード] バンドル ID ラジオボタンを選択します。次に、アプリのバンドル ID を逆引き DS 形式で入力します。
重要

入力するバンドル ID は、アプリプロジェクトの Info.plist ファイルのバンドル識別子に対応している必要があります。

.NET MAUI アプリのバンドル識別子は、アプリケーション ID プロパティとしてプロジェクトファイルに格納されます。
- Visual Studio では、ソリューションエクスプローラーで、.NET MAUI アプリプロジェクトを右クリックし、[プロパティ] を選択します。次に、[MAUI 共有]> [全般] タブに移動します。"アプリケーション ID" フィールドにバンドル識別子が一覧表示されます。
- Visual Studio for Mac のソリューションウィンドウで、.NET MAUI アプリプロジェクトを右クリックし、[プロパティ] を選択します。次に、[プロジェクトのプロパティ] ウィンドウで、[ビルド]> [アプリ情報] タブを選択します。"アプリケーション ID" フィールドにバンドル識別子が一覧表示されます。
"アプリケーション ID" フィールドの値が更新されると、Info.plist のバンドル識別子の値が自動的に更新されます。
[アプリ ID の登録] ページで、アプリで使用する機能を選択します。すべての機能は、このページとアプリプロジェクトの Entitlements.plist ファイルの両方で構成する必要があります。詳細については、「機能」と「エンタイトルメント」をご覧ください。
[アプリ ID の登録] ページで、[続行] ボタンをクリックします。
[アプリ ID の確認] ページで、[登録] ボタンをクリックします。

プロビジョニングプロファイルを作成する

アプリ ID が作成されたら、配布プロビジョニングプロファイルを作成する必要があります。このプロファイルを使用すると、アプリをリリース用にデジタル署名して、iOS デバイスにインストールできるようになります。

アドホック配布のプロビジョニングプロファイルを作成するには:

Apple Developer Account の [Certificates, Identifiers & Profiles]\(証明書、識別子、プロファイル\) ページで、[Profiles]\(プロファイル\) タブを選択します。
[プロファイル] タブで、[+] ボタンをクリックして新しいプロファイルを作成します。
[新しいプロビジョニングプロファイルの登録] ページで、[続行] ボタンをクリックする前に [アドホック] ラジオボタンを選択します。
[プロビジョニングプロファイルの生成] ページの [アプリ ID] ドロップダウンで、前に作成したアプリ ID を選択し、[続行] ボタンをクリックする前にオフラインプロファイルを作成するかどうかを選択します。
[プロビジョニングプロファイルの生成] ページで、配布証明書に対応するラジオボタンを選択してから、[続行] ボタンをクリックします。
[プロビジョニングプロファイルの生成] ページで、アプリがインストールされるデバイスを選択し、[続行] ボタンをクリックします。
[プロビジョニングプロファイルの生成] ページで、[生成] ボタンをクリックする前にプロビジョニングプロファイルの名前を入力します。

Note

プロビジョニングプロファイル名は、アプリの署名時に必要になりますので、メモしておきます。
[プロビジョニングプロファイルの生成] ページで、必要に応じて [ダウンロード] ボタンをクリックしてプロビジョニングプロファイルをダウンロードします。

Note

プロビジョニングプロファイルを今すぐダウンロードする必要はありません。代わりに、Visual Studio でこれを行います。

プロビジョニングプロファイルを Visual Studio にダウンロードする

Apple Developer アカウントでディストリビューションプロビジョニングプロファイルを作成した後、Visual Studio はそれをダウンロードして、アプリに署名できるようにします。

Visual Studio
Visual Studio for Mac

Visual Studio で、[ツール > オプション>] Xamarin > Apple アカウントに移動します。
[Apple Developer Accounts]\(Apple 開発者アカウント\) ダイアログで、チームを選択し、[View Details]\(詳細の表示\) をクリックします。
[詳細] ダイアログで、[プロビジョニングプロファイル] の一覧に新しいプロファイルが表示されることを確認します。場合によって Visual Studio を再起動して、リストを最新の情報に更新する必要があります。
[詳細] ダイアログで、[すべてのプロファイルのダウンロード] をクリックします。

プロビジョニングプロファイルは Windows にダウンロードされ、IDE がペアリングされている場合は Mac ビルドホストにエクスポートされます。詳細については、「iOS 開発のための Mac とのペアリング」をご覧ください。

アプリの発行

Visual Studio では、アドホック配布用の .NET MAUI iOS アプリを発行できます。コマンドラインインターフェイス (CLI) を使用して iOS アプリを発行する方法については、「コマンドラインを使用した iOS アプリの発行」を参照してください。

Visual Studio
Visual Studio for Mac

Visual Studio で、IDE が Mac ビルドホストとペアリングされていることを確認します。詳細については、「Xamarin.iOS 開発のための Mac とのペアリング」を参照してください。
Visual Studio のツールバーで、[デバッグターゲット] ドロップダウンを使用して、iOS リモートデバイスとリモートデバイスを選択します。
Visual Studio のツールバーで、[ソリューション構成] ドロップダウンを使用して、デバッグ構成からリリース構成に変更します。
ソリューションエクスプローラーで、.NET MAUI アプリプロジェクトを右クリックし、[プロパティ] を選択します。次に、iOS バンドル署名タブに移動し、スキームが手動プロビジョニングに設定され、署名 ID がディストリビューション (自動) に設定され、プロビジョニングプロファイルが自動に設定されていることを確認します。

これらの設定により、Info.plist のバンドル識別子 (プロジェクトファイル内のアプリケーション ID プロパティの値と同じ) に基づいて、Visual Studio によって正しいプロビジョニングプロファイルが選択されるようになります。または、署名 ID を適切な配布証明書に設定し、プロビジョニングプロファイルを Apple Developer アカウントで作成したプロファイルに設定します。
ソリューションエクスプローラーで、.NET MAUI アプリプロジェクトを右クリックし、[発行...] を選択します。

アーカイブマネージャーが開き、Visual Studio によってアプリバンドルのアーカイブが開始されます。

アーカイブプロセスは、選択したソリューション構成の [iOS バンドル署名] タブで 指定した証明書とプロビジョニングプロファイルを使用してアプリに署名 します。
アーカイブマネージャーで、アーカイブが正常に完了したら、アーカイブが選択されていることを確認し、[配布] ボタンを選択して、配布用にアプリをパッケージ化するプロセスを開始します。

[ 配布 - チャネル の選択] ダイアログが表示されます。

[分散 - チャネルの選択] ダイアログで、[アドホック] ボタンを選択します。
[配布 - 署名 ID] ダイアログで、署名 ID とプロビジョニングプロファイルを選択します。

Note

アプリ用に作成された署名 ID とプロビジョニングプロファイルと、選択した配布チャネルを使用する必要があります。
[配布 - 署名 ID] ダイアログで、[名前を付けて保存] ボタンを選択し、ファイル名を入力します。その後、アプリは再署名され、ファイルシステム上の .ipa ファイルに発行されます。