社内配布用の iOS アプリを発行する

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

社内配布を使用すると、Apple Developer Enterprise Program のメンバーは、同じ組織の他のメンバーにアプリを内部で配布できます。これには、App Store のレビューを必要とせず、アプリをインストールできるデバイスの数に制限がないという利点があります。ただし、Apple Developer Enterprise Program のメンバーは App Store Connect にアクセスできないため、ライセンシーはアプリの配布を担当します。

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

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

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

配布する証明書の作成詳細については、「配布証明書を作成する」を参照してください。
アプリ 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 アプリをリリース用にデジタル署名できます。社内配布プロビジョニングプロファイルには、アプリ ID と配布証明書が含まれています。

アプリ 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 ラジオボタンを選択します。次に、逆引き DNS 形式でアプリのバンドル ID を入力します。
重要

入力するバンドル 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 の確認] ページで、[登録] ボタンをクリックします。

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

アプリ 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 ファイルに発行されます。

社内アプリは、セキュリティで保護された Web サイトまたはモバイルデバイス管理 (MDM) 経由で配布できます。どちらの方法でも、マニフェストの準備を含む配布用にアプリを準備する必要があります。詳細については、support.apple.com の「Apple デバイスに社内専有アプリを配付する」をご覧ください。

社内配布用の iOS アプリを発行する