为 iOS 设置通用链接
深度链接允许应用用户通过 URI 启动应用。此 URI 包含方案(scheme)、主机(host)和路径(path),并能将应用打开到特定屏幕。
通用链接是一种 iOS 设备独有的深度链接类型,它只使用 http
或 https
协议。
要设置通用链接,您需要拥有一个 Web 域。作为临时解决方案,可以考虑使用 Firebase Hosting 或 GitHub Pages。
设置深度链接后,您可以对其进行验证。要了解更多信息,请参阅 验证深度链接。
创建或修改 Flutter 应用
#编写一个能够处理传入 URL 的 Flutter 应用。
此示例使用 go_router 包来处理路由。go_router
包由 Flutter 团队维护。它提供了一个简单的 API 来处理复杂的路由场景。
要创建新应用,请输入
flutter create <app-name>
。flutter create deeplink_cookbook
要将
go_router
包作为依赖项包含在内,请运行flutter pub add
flutter pub add go_router
要处理路由,请在
main.dart
文件中创建一个GoRouter
对象main.dartdartimport 'package:flutter/material.dart'; import 'package:go_router/go_router.dart'; void main() => runApp(MaterialApp.router(routerConfig: router)); /// This handles '/' and '/details'. final router = GoRouter( routes: [ GoRoute( path: '/', builder: (_, __) => Scaffold( appBar: AppBar(title: const Text('Home Screen')), ), routes: [ GoRoute( path: 'details', builder: (_, __) => Scaffold( appBar: AppBar(title: const Text('Details Screen')), ), ), ], ), ], );
调整 iOS 构建设置
#启动 Xcode。
打开 Flutter 项目
ios
文件夹内的ios/Runner.xcworkspace
文件。
添加关联域
#如有必要,启动 Xcode。
点击顶级的 Runner。
在编辑器中,点击 Runner 目标。
点击 Signing & Capabilities。
要添加新域,请在 Signing & Capabilities 下点击 + Capability。
点击 Associated Domains。
在 Associated Domains 部分,点击 +。
输入
applinks:<web domain="">
。将<web domain="">
替换为您自己的域名。
在您偏好的编辑器中打开
ios/Runner/Runner.entitlements
XML 文件。在
<dict>
标签内添加一个关联域。xml<!--?xml version="1.0" encoding="UTF-8"?--> <plist version="1.0"> <dict> <key>com.apple.developer.associated-domains</key> <array> <string>applinks:example.com</string> </array> </dict> </plist>
保存
ios/Runner/Runner.entitlements
文件。
要检查您创建的关联域是否可用,请执行以下步骤
如有必要,启动 Xcode。
点击顶级的 Runner。
在编辑器中,点击 Runner 目标。
点击 Signing & Capabilities。域应显示在 Associated Domains 部分。
您已完成深度链接的应用配置。
将您的应用与您的 Web 域关联
#您需要在 Web 域中托管一个 apple-app-site-association
文件。此文件会告诉移动浏览器打开哪个 iOS 应用而不是浏览器。要创建此文件,请查找您在上一节中创建的 Flutter 应用的 appID
。
定位 appID
的组成部分
#Apple 将 appID
格式化为 <team id>.<bundle id>
。
- 在 Xcode 项目中定位 bundle ID。
- 在 开发者账户 中定位团队 ID。
例如:假设团队 ID 为 S8QB4VV633
,bundle ID 为 com.example.deeplinkCookbook
,您将输入 appID
条目 S8QB4VV633.com.example.deeplinkCookbook
。
创建并托管 apple-app-site-association
JSON 文件
#此文件使用 JSON 格式。保存此文件时,不要包含 .json
文件扩展名。根据 Apple 的文档,此文件应类似于以下内容
{
"applinks": {
"apps": [],
"details": [
{
"appIDs": [
"S8QB4VV633.com.example.deeplinkCookbook"
],
"paths": [
"*"
],
"components": [
{
"/": "/*"
}
]
}
]
},
"webcredentials": {
"apps": [
"S8QB4VV633.com.example.deeplinkCookbook"
]
}
}
将
appIDs
数组中的一个值设置为<team id>.<bundle id>
。将
paths
数组设置为["*"]
。paths
数组指定了允许的通用链接。使用星号*
会将所有路径重定向到 Flutter 应用。如果需要,请将paths
数组值更改为更适合您应用的设置。将文件托管在类似于以下结构的 URL 上。
<webdomain>/.well-known/apple-app-site-association
验证您的浏览器可以访问此文件。
测试通用链接
#使用实体 iOS 设备或模拟器测试通用链接。
测试前,请在 iOS 设备或模拟器上安装 Flutter 应用,并在目标设备上使用
flutter run
。完成后,Flutter 应用会显示在 iOS 设备或模拟器的主屏幕上。
如果您使用模拟器进行测试,请使用 Xcode CLI
xcrun simctl openurl booted https://<web domain>/details
如果您使用实体 iOS 设备进行测试
- 启动 备忘录 应用。
- 在 备忘录 应用中输入 URL。
- 点击生成的链接。
如果成功,Flutter 应用将启动并显示其详细信息屏幕。
查找源代码
#您可以在 GitHub 仓库中找到 deeplink_cookbook 示例的源代码。