信息属性列表

信息属性列表文件是使用 Unicode UTF-8 编码的 XML 文件,其中包含 iOS 和 Mac Catalyst 上 .NET Multi-platform App UI (.NET MAUI) 应用的配置信息。 文件的根节点是一个字典,其中包含一组用于定义应用配置的键和值。 信息属性列表文件的名称为 Info.plist,区分大小写。 所有 .NET MAUI iOS 和 Mac Catalyst 应用都必须包含描述应用的 Info.plist 文件。

从项目模板创建 .NET MAUI 应用时,.NET MAUI 会为 iOS 和 Mac Catalyst 创建 Info.plist 文件。 这些文件位于 Platforms/iOSPlatforms/Mac Catalyst 文件夹中,并填充了属性列表键的初始列表。

生成应用时,.NET MAUI 会将 Info.plist 文件复制到编译的捆绑包中,然后再对捆绑包进行代码签名。 复制操作期间,.NET MAUI 使用生成属性执行一些变量替换。 它还可以插入其他键,代表以其他方式指定的配置。 因此,应用捆绑包中附带的信息属性列表文件与项目中的源文件不同。

编辑编辑器中的信息属性列表

双击 Info.plist 文件将在 Visual Studio 的 Info.plist 编辑器中打开该文件,其中包含两个数据视图:

  • 应用程序,可用于设置常见的应用属性:

    Visual Studio Info.plist 编辑器中应用程序选项卡的屏幕截图。

    注意

    “应用名称”“捆绑标识符”“版本”“生成”字段的值将从应用的项目文件中获取。 有关详细信息,请参阅提供应用信息

  • 高级,可用于指定受支持的文档类型、通用类型标识符 (UTI) 和 URL 类型:

    Visual Studio Info.plist 编辑器中高级选项卡的屏幕截图。

编辑信息属性列表源

Info.plist 文件也可在外部编辑器中打开,以编辑其 XML 源文件。 可为以下类别添加用于配置应用的键和值:

  • 捆绑包配置,用于配置捆绑包的基本特征,例如名称、类型和版本。 有关详细信息,请参阅 developer.apple.com 上的捆绑包配置
  • 用户界面,用于配置应用的场景、图标和字体。 有关详细信息,请参阅 developer.apple.com 上的用户界面
  • 应用执行,用于配置应用启动、执行和终止。 有关详细信息,请参阅 developer.apple.com 上的应用执行
  • 受保护的资源,用于控制应用对受保护服务和用户数据的访问。 有关详细信息,请参阅 developer.apple.com 上的受保护资源
  • 数据和存储,用于配置应用的数据管理功能。 有关详细信息,请参阅 developer.apple.com 上的数据和存储
  • 应用服务,用于配置应用提供的服务。 有关详细信息,请参阅 developer.apple.com 上的应用服务
  • 内核和驱动程序,用于配置应用提供的设备驱动程序。 有关详细信息,请参阅 developer.apple.com 上的内核和驱动程序

提供应用信息

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 文件中应用视图中的“生成”字段的值将自动更新。

另请参阅