Universal Links API
借助 Apple Universal Links,将指向您域名的链接直接在 iOS 应用中打开——设置、AASA 文件与故障排除。
Universal Links API 可简化跳转至应用内特定内容的过程,为用户提供更无缝、更原生的体验。WebViewGold 允许您配置自己的域名,让来自 Mail、Safari 等应用的链接自动在基于 WebViewGold 的应用中打开——无需额外的确认弹窗。
注意:此功能生效的前提是用户设备上已经安装了该应用。
另外,也可以使用我们的 Deep Linking API。两者的工作方式类似,但使用不同的语法。不过值得注意的是,Universal Links API 的语法比 Deep Linking API 更为常见。对于大多数应用来说,建议在两者中选择其一,而不要同时使用。
要在您的 iOS 应用中设置 Universal Links,请按以下步骤操作:
- Apple Developer Center 设置:
- 登录您的 Apple Developer Center 账户。
- 点击 “Certificates, Identifiers & Profiles”。
- 在 “Identifiers” 中,选择 “App IDs”,然后从列表中选择您应用的 ID。
- 在 “App Services” 部分下,勾选 “Associated Domains” 选项,并保存更改。
- Xcode 设置:
- 在 Xcode 中打开您的应用工程。
- 选择对应的 target(多数情况下为 “WebViewGold”)。在 “Signing & Capabilities” 选项卡中,进入 “Associated Domains” 部分。点击 “+” 添加一个域名。您的域名前需加上 “applinks:” 前缀,例如:
applinks:example.org和applinks:www.example.org:
- 在 Config.swift 中,将 ShowExternalLink 设置为 true。
- 请注意子域名的区分。“www.*” 与非 “www” 域名之间存在差异(建议同时添加两者)。请确保您的 provisioning profile 已包含 “Associated Domains” 功能。如果没有,Xcode 应会提示您进行修复。
- 服务器端设置:
- 在您的网站服务器上,需要将 Apple App Site Association(AASA)文件托管在服务器根目录下,或使用
/.well-known/前缀。例如:https://example.org/.well-known/apple-app-site-association - AASA 文件应包含关于应用及其关联域名的详细信息。请参阅官方文档了解具体结构。请确保 apple-app-site-association 文件托管在支持 HTTPS 的服务器上,而不仅仅是 HTTP。
完成!:-) 在模拟器中测试的效果不如在真机上明显。为获得最佳效果,请使用实体 iPhone 或 iPad 测试。