跳到主要内容
版本:v3

配置 iOS

配置 Info.plist

Info.plist 文件是 iOS 应用的主要配置文件。当 Capacitor 插件需要新设置或权限时,您可能需要编辑此文件。

要修改它,请在 Xcode 中打开您的项目,选择 App 项目和 App 目标,然后点击 Info 标签页。

Xcode info editor

您可以通过在表格中右键单击并勾选上下文菜单中的 Raw Keys & Values 来显示真实的键名。

您也可以手动打开并编辑 ios/App/App/Info.plist 文件以查看原始键值。请参考此官方文档获取可能的键列表。

管理权限

iOS 权限不需要像 Android 那样显式声明。然而,iOS 要求在 Info.plist 中定义“使用描述”。这些设置是当请求特定设备 API 权限时,会向最终用户展示的人类可读描述。

请查阅 Cocoa Keys 列表中包含 UsageDescription 的键,以了解您的应用可能需要的各种使用描述设置。

更多信息,Apple 提供了解决隐私敏感数据应用被拒指南,其中包含了需要提供使用描述的 API 的更多信息。

设置功能

功能用于启用您的应用可能需要的核心特性。当 Capacitor 插件需要时,您可能需要配置它们。

与其他配置选项和使用描述不同,功能 Info.plist 中配置。

要添加新功能,请在 Xcode 中打开您的应用,选择 App 项目和 App 目标,点击标签栏中的 Signing & Capabilities,然后点击 + Capability 按钮。有关 iOS 功能的更多信息,请参阅这篇文章

Xcode Capabilities

重命名您的应用

您不能重命名 App 目录,但可以通过重命名 App 目标来设置应用的名称。

要重命名 App 目标,请在 Xcode 中打开您的项目,选择 App 项目,然后双击 App 目标。

Xcode Target

接着,打开 ios/App/Podfile 并重命名文件底部的当前目标:

-target 'App' do
+target 'MyRenamedApp' do
capacitor_pods
# 在此处添加您的 Pods
end

最后,在 Capacitor 配置文件ios 对象内添加 scheme 属性。

深度链接(又称通用链接)

关于深度链接的指南,请参阅此处