iOS の機能

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

iOS では、.NET Multi-platform App UI (.NET MAUI) アプリはサンドボックスで実行されます。このサンドボックスでは、アプリケーションと特定のシステムリソースまたはユーザーデータ間のアクセスを制限する一連の規則が提供されます。 Apple は、機能を拡張し、iOS アプリで実行可能な範囲を広げる手段として、アプリサービスとしてよく知られる機能を提供しています。機能を使用すると、Siri との統合など、プラットフォーム機能とのより深い統合をアプリに追加できます。機能の詳細については、developer.apple.com の「機能」をご覧ください。

機能はアプリのプロビジョニングプロファイルに追加され、アプリにコード署名するときに使用されます。プロビジョニングプロファイルには、必要な機能が有効になっているアプリのバンドル識別子と一致するアプリ ID が含まれる必要があります。プロビジョニングプロファイルは、Visual Studio や Visual Studio for Mac で自動的に作成するか、Apple Developer Account で手動で作成できます。

機能はエンタイトルメントの概念と密接に関連しています。どちらの場合も、アプリを実行するサンドボックスの拡張を要求して、追加の機能を提供します。通常、エンタイトルメントはアプリの開発時に追加されますが、機能は通常、配布用にアプリに署名するコード時に追加されます。ただし、自動プロビジョニングが有効になっている場合、アプリに特定のエンタイトルメントを追加すると、そのプロビジョニングプロファイルでアプリの機能も更新されます。エンタイトルメントの詳細については、「エンタイトルメント」をご覧ください。

Visual Studio で機能を追加する

機能は、Visual Studio または Visual Studio for Mac のプロビジョニングプロファイルに追加できます。この方法では、自動プロビジョニングを使用する必要があり、機能のサブセットに対してのみ機能します。自動プロビジョニングの詳細については、「iOS アプリの自動プロビジョニング」をご覧ください。

次の一覧は、Visual Studio または Visual Studio for Mac を使用して自動的にプロビジョニングできる機能を示します。

HealthKit
HomeKit
ホットスポットの構成
アプリ間オーディオ
マルチパス
ネットワーク拡張機能
近距離通信タグリーダー
個人の VPN
Siri
ワイヤレスアクセサリの構成

Visual Studio では、すべての機能はアプリの Entitlements.plist ファイルに追加されます。上記の機能もプロビジョニングプロファイルに追加されます。エンタイトルメントファイルをプロジェクトに追加する方法など、エンタイトルメントの詳細については、「エンタイトルメント」をご覧ください。

Visual Studio
Visual Studio for Mac

Visual Studio で、IDE が Mac ビルドホストとペアリングされていることを確認します。詳細については、「iOS 開発のための Mac とのペアリング」をご覧ください。
Visual Studio で、プロジェクトの自動プロビジョニングを有効にします。詳細については、「自動プロビジョニングを有効にする」をご覧ください。
Visual Studio で、Entitlements.plist ファイルをプロジェクトに追加します。詳細については、「Entitlements.plist ファイルを追加する」をご覧ください。
ソリューションエクスプローラー で、.NET MAUI アプリプロジェクトの Platforms > iOS フォルダーにある Entitlements.plist ファイルをダブルクリックして、エンタイトルメントエディターで開きます。
エンタイトルメントエディターで、アプリに必要なすべてのエンタイトルメントを選択して構成します。
Entitlements.plist ファイルへの変更を保存して、エンタイトルメントキーと値のペアをファイルに追加し、アプリ ID に App Service を追加します。

また、特定の機能のために Info.plist でプライバシーキーを設定する必要がある場合もあります。

Apple Developer Account で機能を追加する

すべての機能は、 Apple Developer Account でアプリのプロビジョニングプロファイルに追加できます。この方法では、手動プロビジョニングを使用する必要があり、すべての機能で動作します。手動でのプロビジョニングの詳細については、「iOS アプリの手動プロビジョニング」をご覧ください。

Apple Developer Account で機能を追加することは、アプリ ID の作成、プロビジョニングプロファイルの作成、手動プロビジョニングの有効化を必要とするマルチステップのプロセスです。

プロビジョニングプロファイルに新しい機能を追加する場合は、アプリの Entitlements.plist ファイルに同じ機能を追加し、アプリがこのファイルを使用していることを確認する必要もあります。詳細については、「エンタイトルメント」をご覧ください。また、特定の機能のために Info.plist でプライバシーキーを設定する必要がある場合もあります。

App Service でアプリ ID を作成する

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

重要

.NET MAUI アプリのバンドル識別子は、アプリケーション ID プロパティとしてプロジェクトファイルに格納されています。

Visual Studio では、ソリューションエクスプローラーで、.NET MAUI アプリプロジェクトを右クリックし、[プロパティ] を選択します。次に、[MAUI 共有] > [全般] タブに移動します。"アプリケーション ID" フィールドにはバンドル ID が一覧表示されます。
Visual Studio for Mac のソリューションウィンドウで、.NET MAUI アプリプロジェクトを右クリックし、[プロパティ] を選択します。次に、[プロジェクトのプロパティ] ウィンドウで、[ビルド] > [アプリ情報] タブを選択します。"アプリケーション ID"フィールドにバンドル識別子が一覧表示されます。

"アプリケーション ID" フィールドの値が更新されると、Info.plist のバンドル識別子の値が自動的に更新されます。

アプリ ID には、明示的なものとワイルドカードの 2 種類があります。明示的なアプリ ID は、1 つのアプリに対して一意であり、通常は com.domainname.myid の形式を使用します。明示的なアプリ ID を使用すると、一致するバンドル識別子を持つ 1 つのアプリをデバイスにインストールできます。アプリ固有の機能を有効にするアプリには、明示的なアプリ ID が必要です。

明示的なアプリ ID は、次の手順で作成できます。

Web ブラウザーで、Apple Developer Account の [識別子] セクションに移動し、[+] ボタンをクリックします。
[新しい ID の登録] ページで、[アプリ ID] を選び、[続行] ボタンをクリックします。
[新しい識別子の登録] ページで、アプリの種類を選択し、[続行] ボタンをクリックします。
[アプリ ID の登録] ページで、[説明] を入力し、[バンドル ID] を [明示的] に設定します。次に、com.domainname.myid の形式でアプリ ID を入力します。
[アプリ ID の登録] ページで、[機能] タブと [App Services] タブで必要な機能を有効にします。
[アプリ ID の登録] ページで、[続行] ボタンをクリックします。
[アプリ ID の確認] ページで情報を確認し、[登録] ボタンをクリックします。アプリ ID が正常に登録されると、Apple Developer Account の [識別子] セクションに戻ります。
[識別子] ページで、先ほど作成したアプリ ID をクリックします。
[アプリ ID 構成の編集] ページで、追加のセットアップを必要とする有効な機能には、[構成] ボタンがあります。

有効な機能を構成するには、[構成] ボタンをクリックします。詳細については、developer.apple.com の「アプリ機能を構成する」をご覧ください。

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

アプリ ID を作成したら、アプリ ID のプロビジョニングプロファイルを作成する必要があります。そのためには、事前に署名証明書を作成し、Apple Developer Account にデバイスを追加する必要があります。詳細については、「署名証明書を作成する」と「デバイスを追加する」をご覧ください。

プロビジョニングプロファイルは、次の手順で作成できます。

Web ブラウザーで、Apple Developer Account の [プロファイル] セクションに移動し、[+] ボタンをクリックします。
[新しいプロビジョニングプロファイルの登録] ページの [開発] セクションで、[iOS アプリ開発] (または [配布] セクションから配布プロファイルのタイプ) を選択し、[続行] ボタンをクリックします。
[プロビジョニングプロファイルの生成] ページで、アプリ ID を選択し、[続行] ボタンをクリックします。
[プロビジョニングプロファイルの生成] ページで、プロビジョニングプロファイルに含める証明書を選択し、[続行] ボタンをクリックします。
[プロビジョニングプロファイルの生成] ページで、アプリがインストールされるデバイスを選択し、[続行] ボタンをクリックします。
[プロビジョニングプロファイルの生成] ページで、プロビジョニングプロファイル名を指定し、[生成] ボタンをクリックします。

手動プロビジョニングを有効にする

プロビジョニングプロファイルを作成したら、Visual Studio でダウンロードし、プロジェクトのプロビジョニングプロファイルとして設定する必要があります。

Visual Studio で、作成したプロビジョニングプロファイルをダウンロードして、アプリの署名に使用できるようにします。詳細については、「プロビジョニングプロファイルを Visual Studio にダウンロードする」をご覧ください。
Visual Studio で、プロジェクトの手動プロビジョニングを有効にします。詳細については、「手動プロビジョニングを有効にする」をご覧ください。

トラブルシューティング

次の一覧では、機能を使用する .NET MAUI iOS アプリを開発するときに問題が発生する可能性がある一般的な問題について詳しく説明します。

正しいアプリ ID が作成され、Apple 開発者アカウントの [識別子] セクションに登録されていることを確認します。
機能がアプリ ID に追加されていること、および機能が正しい値を使用して構成されていることを確認します。
プロビジョニングプロファイルが開発用コンピューターにインストールされていること、およびアプリの Info.plist ファイルで、アプリ ID と同じバンドル識別子が使用されていることを確認します。
アプリの Entitlements.plist ファイルで適切なエンタイトルメントが有効になっていることを確認します。
Info.plist で必要なプライバシーキーが設定されていることを確認します。
アプリが Entitlements.plist ファイルを使用していることを確認します。

次の方法で共有

iOS の機能

Visual Studio で機能を追加する