Universal Links

简介

大家好!我是Tony,一个热爱技术,希望运用技术改变生活的的追梦男孩。本文是对Universal Link的总结,参考资料来自苹果开发文档(command+shift+0可以打开)。内容主要包含三部分:

  1. 开启Universal Links
  2. 处理Universal Links
  3. 自定义URLs

Universal Links的能力

让其他运用程序或者websites可以打开你的app,完成用户的某项需求。

开启Universal Links

开启的步骤如下:

设置app的Associated Domains

我的Xcode版本是11.1,在工程的target->signing&Capabilities->Capability,设置格式:
以添加带有webcredentials:前缀的占位符域。 将占位符替换为您网站的域,并保留前缀。


image.png
添加apple-app-site-association文件到websites
  1. 新建文件apple-app-site-association(无后缀扩展名),添加内容如下:
{
   "webcredentials": {
       "apps": [    "D3KQX62K1A.com.example.DemoApp",
                    "D3KQX62K1A.com.example.DemoAdminApp" ]
    }
}

apps字段中各个App的格式如下.
将此文件放置在您网站的.well-known目录中,或直接放置在其根目录中。 如果使用.well-known目录,则文件的URL应与以下格式匹配:
https:///.well-known/apple-app-site-association。

注意事项

  • 您必须使用带有有效证书的https://且不使用任何重定向来托管文件。
  • 在iOS 9.3.1和更高版本中,文件不得大于128 KB(未压缩)。 如果您的应用程序在iOS 8中运行,则该文件必须具有MIME类型application / pkcs7-mime,并且必须是由有效TLS证书进行CMS签名的文件。

验证Apple App网站关联文件

  1. 如果发生以下情况,验证可能会失败,并且关联将被拒绝:
    JSON文件无效或不包含应用程序标识符。
  • 服务器返回300-499码。 这包括重定向。
  • 如果服务器返回500-599码,则系统认为该文件暂时不可用,然后重试。 默认情况下,系统每三小时重试一次,最多八次。
  1. 应用程序成功与域关联后,它将保持关联状态,直到从设备中删除该应用程序为止。 在开发过程中,每次更新关联文件以立即查看所做的更改时,请从测试设备中删除您的应用程序。

自定义URLs

尽管自定义URL方案是可接受的深层链接形式,但强烈建议将Universal Link作为最佳实践。
自定义URL scheme需要完成如下步骤:

  1. 定义应用程序URL的格式
  2. 注册scheme,以便系统将适当的URL定向到您的应用程序。
  3. 处理您的应用程序收到的URL。
定义应用程序URL的格式

eg: myphotoapp:albumname?name=”albumname”

注册scheme
image.png
处理您的应用程序收到的URL
func application(_ application: UIApplication,
                 open url: URL,
                 options: [UIApplicationOpenURLOptionsKey : Any] = [:] ) -> Bool {
    
    // Determine who sent the URL.
    let sendingAppID = options[.sourceApplication]
    print("source application = \(sendingAppID ?? "Unknown")")
    
    // Process the URL.
    guard let components = NSURLComponents(url: url, resolvingAgainstBaseURL: true),
        let albumPath = components.path,
        let params = components.queryItems else {
            print("Invalid URL or album path missing")
            return false
    }
    
    if let photoIndex = params.first(where: { $0.name == "index" })?.value {
        print("albumPath = \(albumPath)")
        print("photoIndex = \(photoIndex)")
        return true
    } else {
        print("Photo index missing")
        return false
    }
}

你可能感兴趣的:(Universal Links)