基本小组件的“Info.plist”文件包含部分必需键和部分可选键。下表列出了这些键及相应的定义,并以名为“Hello World”的小组件为例展示了一些示例值。
键
示例值
是否必需
定义
CFBundleDevelopmentRegion
English
可选
指定软件包原产地的字符串。这通常对应于软件包创建者的母语。
CFBundleDisplayName
Hello World
必需
包含小组件实际名称的字符串。这将显示在 iBooks Author 和 Apple Books 中。
CFBundleIdentifier
com.apple.widget.HelloWorld
必需
作为小组件唯一标识符的字符串,采用反向域名格式。
CFBundleName
Hello World
可选
包含小组件名称的字符串。它必须与“访达”中小组件软件包的名称相匹配(不包括 .wdgt 文件扩展名)。
CFBundleShortVersionString
1.0
可选
提供小组件精简版本号的字符串。它通常与 CFBundleVersion 相同。
CFBundleVersion
1.0
可选
提供小组件版本号的字符串。
Height
768
可选
表示小组件高度(以像素为单位)的数字。如果未指定,则会使用 Default.png 的高度。
MainHTML
HelloWorld.html
必需
这个字符串提供用于执行小组件的 HTML 文件的名称。
Width
1024
可选
表示小组件宽度(以像素为单位)的数字。如果未指定,则会使用 Default.png 的宽度。
IBNotifiesOnReady
可选
设置为“true”时,小组件会指示 Apple Books 何时从显示 Default.png 切换为显示正在运行的 HTML 小组件。
小组件的完整 Info.plist 文件类似如下所示:
/p>
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
CFBundleDevelopmentRegion
English
CFBundleDisplayName
Hello World
CFBundleIdentifier
com.apple.widget.HelloWorld
CFBundleName
Hello World
CFBundleShortVersionString
1.0
CFBundleVersion
1.0
Height
768
MainHTML
HelloWorld.html
Width
1024
IBNotifiesOnReady