Xamarin.iOS应用中的iTunesMetadata.plist文件

本文介绍了 iTunesMetadata.plist 文件&＃xff0c;该文件用于向 iTunes 提供 iOS 应用程序使用 Ad Hoc 分发进行测试或企业部署的相关信息。 

在 iTunes Connect 中创建 iOS 应用程序&＃xff08;无论是用于在 iTunes App Store 中销售还是免费发布&＃xff09;时&＃xff0c;开发人员可指定应用程序类型、子类型、版权声明、支持的 iOS 设备和必需设备功能等信息。 对于通过 Ad Hoc 分发传递给测试员或企业用户的 iOS 应用程序&＃xff0c;缺少此信息。

若要向 Ad Hoc 分发提供缺少的信息&＃xff0c;可选择创建可选的 iTunesMetadata.plist 文件&＃xff0c;然后将其包含在应用程序 IPA 文件中。 此 plist 文件是特殊格式的 XML 文件&＃xff08;详情请参阅属性列表编程指南&＃xff09;&＃xff0c;其中包含定义给定 iOS 应用程序相关信息的键/值对。

iTunesMetadata.plist 内容

以下示例介绍了典型的 iTunesMetadata.plist 文件&＃xff0c;该文件用于定义 Ad Hoc 分发所需的 iTunes 信息&＃xff1a;

下面将详细介绍各个键的值。

UIRequiredDeviceCapabilities

通过 UIRequiredDeviceCapabilities 键&＃xff0c;iTunes 可了解 iOS 应用程序需要哪些设备特定的功能才可在给定的 iOS 设备上安装。 其提供作为功能 (...) 和各功能布尔值的字典 (...)。 如果某功能的值为 true&＃xff0c;则必须显示该功能。 若为 false&＃xff0c;则不可在设备上显示该功能。 例如:

指定 iOS 设备必须在支持 ARM7 指令集并拥有前置摄像头后才可安装该应用程序。 有关允许值的完整列表&＃xff0c;请参阅 Apple 的 UIRequiredDeviceCapabilities 文档。

artistName 和 playlistArtistName

artistName 和 playlistArtistName 键用于定义创建要在 iTunes 内显示的 iOS 应用程序的公司名称。 示例&＃xff1a;

bundleDisplayName、itemName 和 playlistName

bundleDisplayName、itemName 和 playlistName 键用于定义将在 iTunes 中显示的 iOS 应用程序的名称。 示例&＃xff1a;

bundleShortVersionString 和 bundleVersion

bundleShortVersionString 和 bundleVersion 键用于定义将在 iTunes 中显示的 iOS 应用程序版本号。 示例&＃xff1a;

softwareVersionBundleId

softwareVersionBundleId 键用于指定 iOS 应用程序的程序包 ID。 示例&＃xff1a;

copyright

copyright 键用于定义 iTunes 中显示的版权声明。 示例&＃xff1a;

releaseDate

releaseDate 键用于提供要在 iTunes 中显示的 iOS 应用程序的发布日期。 示例&＃xff1a;

softwareIconNeedsShine

softwareIconNeedsShine 键用于就 iOS 应用程序图标是否需要对 iOS 6&＃xff08;及先前版本&＃xff09;使用高亮突出显示 通知 iTunes。 示例&＃xff1a;

gameCenterEnabled 和 gameCenterEverEnabled

gameCenterEnabled 和 gameCenterEverEnabled 键用于就此 iOS 应用程序是否支持 Apple Game Center 通知 iTunes 。 示例&＃xff1a;

genre、genreId 和 subgenres

genre 和 genreId 键用于就此 iOS 应用程序属于哪种类型通知 iTunes。 示例&＃xff1a;

subgenres 键可选择性地用于进一步定义 iOS 应用程序的子类型&＃xff08;最多两个&＃xff09;。 示例&＃xff1a;

对于 iOS 应用程序&＃xff0c;Apple 当前定义以下的类型和类型 ID&＃xff1a;

游戏 (6014) 子类型&＃xff1a;

Newstand (6021) 子类型&＃xff1a;

有关详细信息&＃xff0c;请参阅 Apple 的 Genre IDs Appendix&＃xff08;类型 ID 附录&＃xff09;文档。

softwareSupportedDeviceIds

softwareSupportedDeviceIds 键用于就此 iOS 应用程序支持哪些 iOS 设备通知 iTunes。 示例&＃xff1a;

其中以下值可用&＃xff1a;

• 1 – 经典 iPhone
• 2 – iPod Touch
• 4 – iPad
• 9 – 新型 iPhone

标准键

以下键内附在 iOS 应用程序的所有 iTunesMetadata.plist 文件中&＃xff0c;且始终使用相同的值&＃xff1a;

创建 iTunesMetadata.plist 文件

• Visual Studio for Mac
• Visual Studio

在 Visual Studio for Mac 中使用 iTunesMetadata.plist 文件时&＃xff0c;有两种选择&＃xff1a;

• 使用 Visual Studio for Mac 的可视化 plist 编辑器创建和维护文件。
• 在纯文本编辑器中创建和维护文件。

下面将详细介绍这两种选择。

使用可视化 Plist 编辑器

请执行以下操作&＃xff1a;

1. 在“解决方案资源管理器” 中&＃xff0c;右键单击 Xamarin.iOS 项目文件&＃xff0c;再依次选择“添加” > “新文件...” 

2. 在“新文件”对话框中&＃xff0c;依次选择“iOS” > “属性列表” &＃xff1a;

   

3. 对“名称” 输入 iTunesMetadata&＃xff0c;然后单击“新建” 按钮。

4. 在“解决方案资源管理器” 中&＃xff0c;双击打开 iTunesMetadata.plist 文件进行编辑&＃xff1a;

   

5. 单击绿色的“&＃43;” 新建条目&＃xff0c;再输入“UIRequiredDeviceCapabilities”作为键名称&＃xff1a;

   

6. 单击“字符串” 值类型&＃xff0c;再从弹出列表中选择“字典” &＃xff1a;

   

7. 单击属性名左侧的折叠图标&＃xff0c;以显示字典条目&＃xff1a;

   

8. 依次单击“添加新条目” 文本和绿色的“&＃43;” &＃xff0c;向字典添加条目&＃xff1a;

   

9. 输入“armv7”作为键名称&＃xff0c;选择“布尔” 类型&＃xff0c;再输入“Yes” 作为值&＃xff1a;

   

10. 重复上述步骤&＃xff0c;直到已使用所有必需键/值对填充 iTunesMetadata.plist 文件&＃xff08;有关详细信息&＃xff0c;请参阅上方的 iTunesMetadata.plist 内容部分&＃xff09;。

11. 保存对 plist 文件的更改。

使用纯文本编辑器

请执行以下操作&＃xff1a;

1. 在纯文本编辑器中&＃xff0c;新建文本文件并将其命名为 iTunesMetadata.plist。
2. 复制上面的 iTunesMetadata.plist 内容中的示例内容。
3. 将内容粘贴到文件并按需进行编辑。
4. 保存文件并返回 Visual Studio for Mac。
5. 在“解决方案资源管理器” 中&＃xff0c;右键单击 Xamarin.iOS 项目文件&＃xff0c;再依次选择“添加” > “现有文件...” 。
6. 在“打开文件”对话框中&＃xff0c;选择上面创建的 iTunesMetadata.plist 文件&＃xff0c;然后单击“确定” 按钮。
7. 将此文件的“生成操作” 保留设置为“无” 。

稍后&＃xff0c;准备在 IDE 中生成 IPA 时&＃xff0c;请选择此 iTunesMetadata.plist 文件。

总结

本文介绍了 iTunesMetadata.plist 文件&＃xff0c;该文件可用于就 Ad Hoc 分发的 iOS 应用程序通知 iTunes。 它还介绍了 plist 文件中的标准键&＃xff0c;以及如何在 Visual Studio 和 Visual Studio for Mac 中创建和维护该文件。