文章

为您的 App 添加功能

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

概览

“功能”让您的 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 中完成其他配置步骤。对于另一些功能,您可能需要编写一些代码。

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

另请参阅

项目配置