文章

为你的 App 添加功能

通过添加功能来配置 Apple 提供的 App 服务,如推送通知或 Apple Pay。

最新英文文章

Adding capabilities to your app


概览

“功能”让你的 App 能够访问 Apple 提供的“App 服务”,如 CloudKit、Game Center 或 App 内购买项目。要使用某些 App 服务,你必须对 App 进行预置,通过 Xcode 的项目编辑器添加功能,而项目编辑器会为你正确配置相应的 App 服务。Xcode 会编辑“Entitlemen”(授权 (英文))信息属性列表 (英文) 文件,添加相关的框架,并配置你的签名素材。

不过,一些 App 服务 (如 Game Center 和 App 内购买项目) 需要在 App Store Connect 和你的开发者账户中进行额外配置。例如,如果 App 使用“地图”为其他 App 提供路线指引,你需要使用 App Store Connect 上传地理覆盖范围文件

App 所面向的平台以及你有无 Apple Developer Program 的会员身份,都可能会限制 App 可使用的功能。有关受支持的功能,请参阅《开发者账户帮助》的“参考”部分。例如,可查阅“受支持的功能 (iOS)”来了解 iOS App 可以使用的功能。

在开始之前,请先添加你的 Apple ID 账户将项目分配给团队,让 Xcode 能预置你的 App。对于 iOS、Apple tvOS 和 watchOS App,请在设备上运行你的 App,以便注册设备并创建开发预置描述文件。

添加功能

你可以使用项目编辑器的“Signing & Capabilities”(签名和功能) 面板来为 App 添加功能。

在主窗口的项目导航器中,选择所需项目 (名称与你的 App 相同的根组),然后在右侧显示的项目编辑器中选择所需目标。从“Project/Targets”(项目/目标) 弹出式菜单或大纲视图的“Targets”(目标) 部分中,选取 App 的目标。然后,点按项目编辑器中的“Signing & Capabilities”(签名和功能) 标签。

截屏中显示了“Signing & Capabilities”(签名和功能) 面板,从该面板你可以选取项目和目标,并可点按来显示该面板。

你也可以选择一个构建配置 (“All”(全部)、“Debug”(调试)、“Release”(发布))。例如,如果你只想将功能添加到“Debug”(调试) 配置,请选择“Debug”(调试);否则,请选择“All”(全部)。

在工具栏中,点按“Library”(资源库) 按钮 (+) 以打开“Capabilities”(功能) 资源库 (也可以点按构建配置左侧的“+ Capability”(+ 功能) 或选取“Editor”(编辑器) >“Add Capability”(添加功能))。“Capabilities”(功能) 资源库仅显示目标平台和你的计划会员资格可以使用的功能。

要查看各项功能的描述,请点按资源库右上角的“Show Details”(显示详情) 按钮。在左侧选择一项功能,即可在右侧阅读对应的描述。

截屏显示了“Signing & Capabilities”(签名和功能) 面板,其中添加了“App Groups”(App 小组) 功能,并显示了用于选择和创建 App 小组的控件,以及用于移除功能的按钮。

要将功能添加到 App 目标中,请在资源库中双击这项功能,或将这项功能从资源库拖到“Signing & Capabilities”(签名和功能) 面板上。这项功能便会显示在“Signing”(签名) 部分下。如果有更多配置步骤,功能会展开来显示其他控件 (请参阅“完成其他配置步骤”)。要移除某项功能,请在“Signing & Capabilities”(签名和功能) 面板中点按该功能右上角的“X”按钮。

显示“Signing & Capabilities”(签名和功能) 面板的截屏,其中选择了一项功能,并显示了你可以从中阅读对应功能描述的详情视图。

如果“Signing”(签名) 部分显示错误,请阅读显示的信息,更正问题,然后点按“Try Again”(重试)。例如,“Signing”(签名) 下“Bundle Identifier”(套装标识符) 栏位中显示的套装 ID (CFBundleIdentifier (英文)) 必须独一无二。套装 ID 的默认值是组织标识符加上你在创建项目时输入的 App 名称。

完成其他配置步骤

对于一些功能,你可能需要在 Xcode、你的开发者账户或 App Store Connect 中完成其他配置步骤。对于另一些功能,你可能需要编写一些代码。

如需特定功能的更多指导,请参阅下表。

另请参阅

项目配置