情報プロパティ一覧
情報プロパティ リスト ファイルは、iOS および Mac Catalyst 上の .NET Multi-Platform App UI (.NET MAUI) アプリの構成情報を含む Unicode UTF-8 を使用してエンコードされた XML ファイルです。 ファイルのルート ノードはディクショナリであり、アプリの構成を定義するキーと値のセットが含まれています。 情報プロパティ リスト ファイルの名前は Info.plist で、大文字と小文字が区別されます。 すべての .NET MAUI iOS および Mac Catalyst アプリには、アプリを記述する Info.plist ファイルが含まれている必要があります。
.NET MAUI では、プロジェクト テンプレートから .NET MAUI アプリを作成するときに、iOS および Mac Catalyst 用の Info.plist ファイルを作成します。 これらのファイルは Platforms/iOS および Platforms/Mac Catalyst フォルダーにあり、プロパティ リスト キーの初期リストが設定されます。
アプリをビルドすると、コードがバンドルに署名する前に、.NET MAUI によって Info.plist ファイルがコンパイル済みバンドルにコピーされます。 コピー操作中、.NET MAUI はビルド プロパティを使用して変数の置換を実行します。 また、他の方法で指定された構成を表す追加のキーを挿入することもできます。 このため、アプリ バンドルに付属する情報プロパティ リスト ファイルは、プロジェクト内のソース ファイルと同じではありません。
エディターで情報プロパティ リストを編集する
Info.plist ファイルをダブルクリックすると、Visual Studio の Info.plist エディターで開きます。
Visual Studio の Info.plist エディターには、次の 2 つのデータ ビューが含まれています。
アプリケーションでは、一般的なアプリのプロパティを設定できます。
Note
[アプリケーション名]、[バンドル識別子]、[バージョン]、および [ビルド] フィールドの値は、アプリのプロジェクト ファイルから取得されます。 詳細については、「アプリ情報を提供する」をご覧ください。
詳細では、サポートされているドキュメントの種類、ユニバーサル型識別子 (UTI)、および URL の種類を指定できます。
情報プロパティ リストのソースを編集する
Info.plist ファイルを外部エディターで開き、その XML ソースを編集することもできます。 アプリを構成するためのキーと値は、次のカテゴリに対して追加できます。
- バンドルの構成は、バンドルの名前、種類、バージョンなど、バンドルの基本的な特性を構成します。 詳細については、developer.apple.com の「バンドル構成」をご覧ください。
- ユーザー インターフェイスは、アプリのシーン、アイコン、フォントを構成します。 詳細については、developer.apple.com の「ユーザー インターフェイス」をご覧ください。
- アプリの実行では、アプリの起動、実行、終了を構成します。 詳細については、developer.apple.com の「アプリの実行」をご覧ください。
- 保護されたリソースでは、保護されたサービスとユーザー データへのアプリのアクセスを制御します。 詳細については、developer.apple.com の「保護されたリソース」をご覧ください。
- データとストレージでは、アプリのデータ管理機能を構成します。 詳細については、developer.apple.com の「データとストレージ」をご覧ください。
- アプリ サービスでは、アプリが提供するサービスを構成します。 詳細については、developer.apple.com の「アプリ サービス」をご覧ください。
- カーネルとドライバーでは、アプリによって提供されるデバイス ドライバーを構成します。 詳細については、developer.apple.com の「Kernel and drivers」をご覧ください。
アプリ情報を指定する
Info.plist エディターは、Info.plist ファイルに直接格納するのではなく、アプリのプロジェクト ファイルから基本的なアプリ データを取得します。 ビルド時に、.NET MAUI は、アプリ バンドルに付属する Info.plist ファイルにこのデータをコピーします。
アプリケーション名
.NET MAUI アプリのアプリケーション名は、アプリのプロジェクト ファイルに ApplicationTitle ビルド プロパティとして格納されます。
ソリューション エクスプローラーで、.NET MAUI アプリ プロジェクトを右クリックし、[プロパティ] を選択します。 次に、[MAUI 共有] >[全般] タブに移動します。"アプリケーション タイトル" フィールドにアプリケーション名が一覧表示されます。
"アプリケーション タイトル" フィールドの値が更新されると、Info.plist ファイル内のアプリケーション ビューの "アプリケーション名" フィールドの値が自動更新されます。
アプリケーション ID
.NET MAUI アプリのバンドル識別子は、アプリのプロジェクト ファイルに ApplicationId ビルド プロパティとして格納されます。
ソリューション エクスプローラーで、.NET MAUI アプリ プロジェクトを右クリックし、[プロパティ] を選択します。 次に、[MAUI 共有 > 一般] タブに移動します。[アプリケーション ID] フィールドにはバンドル識別子がリストされます。
"アプリケーション ID" フィールドの値が更新されると、Info.plist ファイル内のアプリケーション ビューの "バンドル識別子" フィールドの値が自動更新されます。
アプリケーション表示バージョン
.NET MAUI アプリのアプリケーション表示バージョンは、アプリのプロジェクト ファイルに ApplicationDisplayVersion ビルド プロパティとして格納されます。
ソリューション エクスプローラーで、.NET MAUI アプリ プロジェクトを右クリックし、[プロパティ] を選択します。 次に、[MAUI 共有] >[全般] タブに移動します。"アプリケーション表示バージョン" フィールドに、アプリケーション表示バージョンが一覧表示されます。
"アプリケーション表示バージョン" フィールドの値が更新されると、Info.plist ファイル内のアプリケーション ビューの "バージョン" フィールドの値が自動更新されます。
アプリケーションのバージョン
.NET MAUI アプリのアプリケーション バージョンは、アプリのプロジェクト ファイルに ApplicationVersion ビルド プロパティとして格納されます。
ソリューション エクスプローラーで、.NET MAUI アプリ プロジェクトを右クリックし、[プロパティ] を選択します。 次に、[MAUI 共有] >[全般] タブに移動します。"アプリケーション バージョン" フィールドに、アプリケーション バージョンが一覧表示されます。
"アプリケーションのバージョン" フィールドの値が更新されると、Info.plist ファイルのアプリケーション ビューの "ビルド" フィールドの値が自動更新されます。
関連項目
- developer.apple.com の 情報プロパティ リスト
.NET MAUI
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示