iOS 通用链接未在应用内打开答案

【问题标题】：iOS Universal Links are not opening in-appiOS 通用链接未在应用内打开
【发布时间】：2015-12-21 11:00:55
【问题描述】：

所以我完全按照本教程进行操作，并使用与提供的值相同的值： https://blog.branch.io/how-to-setup-universal-links-to-deep-link-on-apple-ios-9

苹果协会文件也在链接目录中准备好了：
WEB_PAGE:PORT_NUMBER/apple-app-site-association

这边好像什么都设置好了。

我已经添加了权利，更新了配置文件，一切都设置好了。

当我在我的设备上运行应用程序并打开链接 http://WEB_PAGE:PORT_NUMBER 时，这始终会打开 Safari。

我什至在以下方法中有断点：

- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void(^)(NSArray * __nullable restorableObjects))restorationHandler

不过是小菜一碟。

有没有人完善这个？有什么我想念的吗？

【问题讨论】：

在这里结帐以确保您不会错过任何步骤stackoverflow.com/questions/35609667/…

标签： ios objective-c xcode ios9 ios-universal-links

【解决方案1】：

有时我发现关联文件一切正常，但 iOS 决定始终在 Safari 中打开通用链接。为了测试应用程序是否识别应用程序链接，我将 URL 添加到 Notes 或日历条目，然后长按它以显示上下文菜单。如果它显示“在 {YOUR APP} 中打开”，则该链接有效，但 iOS 决定在 Safari 中打开它。点按“在 {YOUR APP} 中打开”将告诉 iOS 从那时起通过您的应用打开有效的通用链接。

【讨论】：

【解决方案2】：

有一种新的文件格式 - 请查看此链接：https://developer.apple.com/documentation/safariservices/supporting_associated_domains_in_your_app?language=objc

我这样更新了我的文件：

"applinks": {
        "apps": [],
        "details": [
            {
                "appID": "APP_ID_PREFIX.BUNDLE_ID",
                "paths": [
                    "*"
                ]
            }
        ]
    },
    "webcredentials": {
        "apps": [
            "APP_ID_PREFIX.BUNDLE_ID"
        ]
    }
}

注意：在模拟器中它不工作，但在设备上工作完美。

【讨论】：

【解决方案3】：

就我而言，我需要让服务器使用内容类型为apple-app-site-association 文件提供服务：application/pkcs7-mime。在 nginx 中，我使用了这种方法：

location ~ /.well-known/apple-app-site-association {
         default_type application/pkcs7-mime;
 }

正如其他人建议的那样，我还必须确保我：

使用iOS新的apple-app-site-association格式https://developer.apple.com/documentation/safariservices/supporting_associated_domains
使用正确的 TEAM ID，使其变为 "appIDs": [ "TEAM_ID.my-app-bundle-id"],
确保在 Xcode 的权利中，应用关联以 applinks: 开头

请注意，我从未在控制台应用程序中看到其他用户的屏幕截图中显示的“成功”消息。在控制台中，我不断收到Entry [...] needs its JSON updated because the app PI changed，但这不是问题。

另请注意，当尝试在浏览器中打开 apple-app-site-association 时，文件会被下载而不是显示，但在我的情况下这不是问题。

和往常一样，使用真实设备，每次更改时重新安装应用程序，可能还会重新启动设备并可能增加应用程序版本号。

【讨论】：

【解决方案4】：

在我的案例中，它没有醒来，因为我有 2 件物品

<plist version="1.0">
<dict>
    <key>aps-environment</key>
    <string>development</string>
    <key>com.apple.developer.associated-domains</key>
    <array>
        <string>applinks:urlOne</string>
        <string>applinks:urlTwo</string>
    </array>
</dict>
</plist>

当我将数组减少到只有一项时，它开始工作。

【讨论】：

【解决方案5】：

对于 ios13，有一种新格式 - 在这里查看 https://developer.apple.com/documentation/safariservices/supporting_associated_domains_in_your_app?language=objc

我将文件更新为如下所示：

 {
  "applinks": {
    "apps": [],
    "details": [
        {
          "appIDs": ["1234.app.company.appname"],
          "appID": "1234.app.company.appname",
          "components": [
            {
              "/": "/login"
            }
         ],
           "paths": [ "/login" ]
        }
    ]
  },
  "webcredentials": {
    "apps": ["1234.app.company.appname"]
  }
}

【讨论】：

您需要将"exclude": true 添加到components 对象才能使comment 为真
@SurjeetRajput 我已经更新了我的答案，我从我的一个生产项目中复制了文件。这对我有用。

【解决方案6】：

在我的例子中，原因是 JSON 无效。

没有使用“但是”，因为我是从某篇文章中抄来的，文章的“专家”作者在上面加上了这样的符号，我从他那里抄来的。

顺便说一句，目标站点上仍然没有信息框，例如“您可以使用应用程序打开它”，但如果我单击链接，例如从 Notes 应用程序打开应用程序。

错误：

{
    “applinks”: {
        “apps”: [],
        “details”: [
            {
                “appID”: “T5TQ36Q2SQ.com.reddit.production”,
                “paths”: [“*”],
            }
        ]
    }
}

好：

{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "T5TQ36Q2SQ.com.reddit.production",
                "paths": ["*"],
            }
        ]
    }
}

【讨论】：

【解决方案7】：

我没有看到有人为 Flask 提供解决方案。

这对我有用。

编辑：经过两次投票后，我想澄清一下，几个月后我仍然使用这个确切的解决方案。它确实有效，但还有其他原因可能无法立即对您的应用程序有效。这包括您将不得不多次删除应用程序并重新启动手机。最终，它链接。我不确定为什么这么难，但这个解决方案确实有效。所以请继续尝试，如果您有任何问题，请随时发表评论，以便我可以提供帮助。

如果您使用的是 Flask，请将“apple-app-site-association”放在您的静态文件夹中，然后将其添加到您的 application.py 文件中。

@application.route('/apple-app-site-association', methods=['GET'])
def apple_app_site_association():
    return application.send_static_file('apple-app-site-association')

【讨论】：

投反对票的人，请解释您投反对票的原因，以便如果答案不准确，我们可以改进答案。

【解决方案8】：

对我来说，在实现了上面的所有答案并测试了 AASA 文件确实正在使用 mpoisot 的答案下载之后，我的问题是在 Xcode 中我将关联的域添加为：

applinks:example.com

在我尝试使用的笔记应用中：

Https://example.com

因为我的 AASA 没有签名，我想确保我通过 HTTPS 提供服务。所以它在我尝试使用的笔记应用程序中起作用：

example.com

它适用于我在物理设备上，使用 iOS 12.1.2 以及来自 Xcode 的开发版本或来自 Testflight 的分发版本

【讨论】：

【解决方案9】：

花了一天时间试图让它工作后，重新启动我的手机解决了这个问题。

卸载/重新安装应用程序也不起作用。

【讨论】：

【解决方案10】：

为帮助调试此问题，请在安装应用时在设备的控制台输出中搜索“swcd”，以查看注册通用链接是否有效。

使用实际设备，而不是模拟器。
从您的设备中删除该应用程序。
将设备连接到您的计算机，并在 xcode 中查看设备的控制台输出。（窗口 -> 设备 -> [您的设备] -> 打开控制台）。保持此窗口打开。
安装您的应用并让它启动。
将控制台输出过滤为“swcd”。如果成功，您将看到类似于以下屏幕截图的内容。如果它失败了，你会看到别的东西。如果您没有看到任何内容，则说明您搞砸了一些基本内容，例如添加关联域权利。

【讨论】：

很好的提示！我将 https:// 添加到 applinks: entitlement 并指定了我想听的完整路径，这两个都是错误的。我指定了example.com/path*，我应该只指定我的 domain.com 和 example.com 上的 AASA 文件，然后根据我的应用程序包 id 指定路径
我可以给你电汇现金红利吗？我花了 2 天时间完成了这个该死的通用链接设置的每一步，在我尝试了你的方法之前没有任何帮助。我真的很不幸将我的关联文件托管在我的域的firebase的根文件夹中，结果发现Apple首先查询.well-known/子目录，而firebase似乎用他们自己的（！）正确的关联文件来响应它没有应用链接。天哪，Apple，我应该怎么找到这个？
啊，很好的提示！我不知道这个设备控制台，只是看 Xcode 控制台输出。我的问题是 3 个深度链接域中有 2 个有效，但不是最后一个。在控制台中，我看到对于我的最后一个域，我拼错了“appllinks:”（2 L's）哦，伙计……无论如何，再次感谢您提供了一种检查通用链接是否实际注册的好方法！（我发现控制台日志在卸载应用程序时也删除了链接：+1）
默认情况下应该那么冗长吗？因为我没有得到这么详细的日志。。这是否意味着操作不成功？
没有 swcd 过滤我仍然看到很多不相关的行

【解决方案11】：

如果您在 Firebase 上托管您的 apple-app-site-association，请确保将其放在 /.well-known/ 子目录中！ Xcode 似乎首先查询该 URL，如果成功，它不会尝试查询根目录中的 apple-app-site-association。出于某种原因，Firebase 工程师让托管网站自动响应 /.well-known/apple-app-site-association，并使用一个空的（但格式正确的）关联文件覆盖您的自定义文件，让您不知道为什么没有任何效果！

【讨论】：

终于！非常感谢。是写在什么地方吗？ Firebase 应该在某处记录。

【解决方案12】：

希望这对某人有所帮助，因为我花了大约两天时间才弄清楚。

我们必须在.entitlements 文件中将www. 添加到associated-domains。

        <string>applinks:www.yourdomain.com</string>
        <string>activitycontinuation:www.yourdomain.com</string>

因为如果我们使用yourdomain.com 而不是www.yourdomain.com，我们的服务器会执行重定向-> 304，然后不包含content-type: application/json 的apple-app-site-association file。

注意通用链接仍然适用于 yourdomain.com 和 www.yourdomain.com

【讨论】：

【解决方案13】：

我还将记录故障排除。

基本上我们有 2 个部分，它们应该链接在一起：1) 网站 网站和 2) iOS 应用程序。

web 站点只有一个问题：apple-app-site-association 文件的 MIME 类型不是 application/json。

API Validation Tool 也没有帮助我们，因为test 它所说的环境

错误没有具有域权利的应用程序用于验证深度链接双重身份验证的权利数据来自您应用的当前发布版本。此数据可能需要 48 小时才能更新。

但最终网站还可以。

我们检查了网络日志，看到了对 apple-app-site-association 文件的 GET 请求，并决定切换到 iOS 应用。

为了处理 iOS 应用程序设置，最好让 Console 应用程序运行，并过滤以仅显示 swcd 进程，正如本线程中已经提到的那样。

在我们的例子中，问题是我们依赖通配符 URL，格式为：applinks:*.prod_site_name.com，认为 * 将涵盖所有测试环境前置，例如 https://test_env.num4.prod_site_name.com，但这不起作用。控制台显示：

已开始对域“*.prod_site_name.com”、URL“https://prod_site_name.com/.well-known/apple-app-site-association”的请求

因此，我们的解决方案是为应用的测试目标提供特定于测试的应用链接，例如：applinks:test_env.num4.prod_site_name.com

【讨论】：

【解决方案14】：

经过两天的彻底绝望，我想我终于修好了。这是我的解决方案：

似乎较旧的应用程序使用的应用程序前缀与较新的应用程序不同。较新的应用程序仅将团队 ID 用于此目的。如果app前缀和团队ID不相同，似乎需要在apple app站点关联文件中指定activity continuation字段：

{
    "activitycontinuation": {
        "apps": [
            "YOUR_APP_PREFIX.de.company.app"
        ]
   },
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "YOUR_APP_PREFIX.de.company.app",
        "paths": ["/*"]
      }
    ]
  }
}

我在地狱之旅中经历的另一件事是删除应用程序并重新启动设备似乎是强制刷新此文件的唯一方法。

【讨论】：

“对于 2011 年之后创建的应用程序，您的应用程序 ID 前缀是您的团队 ID。但是，对于 2011 年或之前创建的应用程序，可能有不同的应用程序 ID 前缀。”

【解决方案15】：

就我而言，AASA 文件的请求位于：https://example.com/apple-app-site-association

被重定向到：https://www.example.com/apple-app-site-association

关键是 -- 这在 iOS 11 上运行良好，但在 iOS 9.3.5 上失败。 去看看。

解决方案：apple-app-site-association 文件不得位于 iOS 9 的 302 或 301 重定向后面。（公平地说，这在 UL troubleshooting page 上注明。）

【讨论】：

【解决方案16】：

就我而言，我的错误是将查询参数放在路径中：

{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "TEAM_ID.BundleIdentifier",
                "paths": [ "/auth-ui/hub?target=confirm&*" ]
            }
        ]
    }
}

当我从路径中删除 '?target=confirm&*' 时，它开始工作

【讨论】：

【解决方案17】：

对于需要轻松测试打开（通用）链接的任何人，您还可以使用以下命令从终端打开模拟器中的链接：

xcrun simctl openurl booted yourapp_or_http://yourlink

例如：

xcrun simctl openurl booted https://www.google.com

【讨论】：

我没有让这个工作，它总是只是打开 Safari。不过，当我在实际设备上运行时，它们确实有效。任何想法都会受到赞赏，因为在没有模拟器的情况下调试/开发会更加痛苦。

【解决方案18】：

我能够使用日历应用在 iOS 模拟器中测试通用链接。

我刚刚创建了一个事件，并在事件的URL 字段中添加了我想测试的 URL。然后，在查看创建的事件时，您只需点击 URL 链接即可打开您的应用。

【讨论】：

这似乎对我不起作用，我已经尽一切努力让它们在模拟器中工作但无济于事。它们在实际设备上运行良好，但这并不适合开发/调试。我试过长按链接，没有“在应用程序中打开”选项。

【解决方案19】：

两天后我发现，这些链接（来自分支）

applinks:xxxx.app.link

仅在将应用程序存档（也是 Ad-hoc）并将其安装到手机后才能工作。

【讨论】：

【解决方案20】：

对于找到此页面的未来读者...

我也遇到过类似的情况。然而，在我的情况下，iOS10 工作正常，无论我做什么（碰撞内部版本号、删除/重新安装等），iOS9 似乎都拒绝工作。

我是从 iOS10 开始的，需要支持 iOS9。当时，这里的文档 - https://developer.apple.com/library/content/documentation/General/Conceptual/AppSearch/UniversalLinks.html - 明确指出该文件可以放置在 Web 服务器的根目录（例如 /apple-app-site-association）或 .well-known 文件夹中（例如 /.well-known/apple-app-site-association）。因为我也支持 Android，它也使用 .well-known 文件夹来存放类似的文件，所以我决定将两者都放在那里。

对于iOS10上的全新安装，它清楚地请求根文件，失败，然后请求.well-known文件，并成功。

对于iOS9，它明确地请求根文件，失败，没有别的。

解决方法：如果你支持iOS9，请将文件放在/apple-app-site-association。

【讨论】：

【解决方案21】：

还没有真正看到完全相同的问题/解决方案组合让它对我有用，所以不妨添加我的，以防有人遇到同样的问题！

对于我的应用，我正在使用自定义 URL 方案（在 APP_TARGET > Info > URL Types 中设置）并将 URL 方案从此处设置到 Firebase 控制台以匹配但仍然无法正常工作。

我的问题其实是两个问题：

注意是否检查自动管理签名

如果您像我一样检查 Xcode 的“自动管理签名”设置，因为我只是想制作一个快速演示应用程序，您需要确保使用的 TeamID 与 Firebase 控制台中的匹配。我最初去我的 Apple Developer Account 并从我的 Membership 页面复制了团队 ID，但后来发现 Xcode 使用的实际 ID 不同。（你可以在 APP_TARGET > General > Signing > Signing Certificate. 中找到它，对我来说，它看起来像 iPhone Developer: My Name (TEAM_ID)）。

在您的 URL 类型中将您的 TeamID 添加到您的捆绑标识符中

在我的 Firebase 控制台和 Xcode 中确保这些匹配后，我的下一个问题是我的 URL 方案的标识符。通常在此处使用您的包标识符，但 Firebase 实际上会使用您在 Firebase 控制台中提供的团队 ID 作为前缀，因此我也必须将其添加到 Xcode 中 URL 类型部分中的标识符的前缀。

经过这两个修复并重新下载 GoogleService-Info.plist 文件后，我打开动态链接没有问题。

【讨论】：

【解决方案22】：

最常见的原因是用户点击右上角，从而告诉 iOS 以后不要打开应用程序（在这种情况下是 Uber）。

要修复，请下拉以显示智能横幅并点击打开：

这将随后“记住”打开应用程序。

【讨论】：

【解决方案23】：

我们已将 apple-app-site-association 文件添加到此位置：

https://example.com/apple-app-site-association

在 iOS 9 上运行良好，但在 iOS 10 上却无法运行。

看来问题出在 .well-known 路径上：

https://example.com/.well-known/apple-app-site-association

因为https://example.com/.well-known/apple-app-site-association路径重定向到https://example.com

<Notice>: Allowing redirect 'https://example.com/.well-known/apple-app-site-association' -> 'https://example.com/'
<Notice>: ### Rejecting AASA file size 154466 for URL https://example.com/.well-known/apple-app-site-association

在我看来，如果 .well-known 路径无法正常工作，它会破坏通用链接。

【讨论】：

手册明确指出“该文件需要通过 HTTPS 访问——无需任何重定向”。
手册中还明确表示“对于运行在iOS 9.3.1及更高版本的应用程序，apple-app-site-association文件的未压缩大小必须不大于128 KB，无论文件是否已签名。”此文件为 154 KB。
在 iOS11 上，您的服务器应显式返回 404 状态：example.com/.well-known/apple-app-site-association，然后 swcd 使用回退到根目录：example.com/apple-app-site-association。您可以使用 Postman 等工具快速检查返回的 HTTP 状态

【解决方案24】：

如果您将链接粘贴到浏览器 URL 字段中，通用链接将不起作用。
通用链接工作与用户驱动的<a href="..."> 元素点击跨域。示例：如果 google.com 上有指向 bnc.lt 的通用链接，它将打开应用程序。
万能链接将不起作用，用户驱动的<a href="..."> 元素点击同一域。示例：如果 google.com 上的通用链接指向 google.com 上的不同通用链接，则不会打开应用。
通用链接不能通过 Javascript 触发（在 window.onload 中或通过对 <a> 元素的 .click() 调用），除非它是用户操作的一部分。

来源：https://dev.branch.io/getting-started/universal-app-links/support/ios/#appsbrowsers-that-support-universal-links

第三颗子弹花了我大约一天的时间才弄明白。

【讨论】：

第三个子弹，同样的：浪费了很多时间来弄清楚。 Apple 甚至有一个非常愚蠢的解释：“iOS 尊重用户最可能的意图，并在 Safari 中打开链接”看你自己here。
第三弹 TOP ！
第三个子弹应该是正确的答案！我只花了4个小时在这上面。谢谢

【解决方案25】：

对我来说，我的错误是我们的网站将 www.domain.com 重定向到 domain.com，因此所有 www.domain.com/* 都会因此而失败。希望对您有所帮助。

【讨论】：

【解决方案26】：

只是想我会添加一些我发现的东西，以防更多人将来遇到与我相同的问题。这些大多与身份验证错误有关。

即使苹果没有明确说明，apple-app-site-association 文件也必须通过 https 提供，即使已签名。用于 https 的证书也必须得到苹果的信任。因此，虽然在设置 -> 常规 -> 配置文件中添加到设备的证书将允许 https 在 safari 中使用，但它不允许通用链接工作。

在设备日志中，在设备和服务器之间出现身份验证错误时，将打印一个类似"TrustResultValue" : 4 的值。 TrustResultValue 为 5 表示证书用于错误的域（例如，从 www.test.com 提供的 test.com）。 TrustResultValue 为 4 表示此用途不信任该证书。

可能有一些有助于调试here 的步骤。 “测试对 apple-app-site-association 的访问”部分是关于如何确保设备获取apple-app-site-association 文件的分步指南。步骤归结为：

卸载应用程序。这是必要的，因为文件是在安装时下载的。
阻止服务器正常服务apple-app-site-association。
在 xcode 中，打开 Window -> Devices，然后选择您的设备。
通过单击窗口底部的三角形打开设备日志。
通过单击垃圾箱来清除日志以清除任何可能相关的以前的日志。
点击播放按钮用 xcode 重新安装应用程序。
应用启动后，如果设备正确请求文件，则设备日志应包含可通过搜索“apple-app-site-association”找到的错误。

如果apple-app-site-association 文件正确提供（步骤2 被省略），那么应该没有错误。如果这是问题所在，则可能会显示身份验证错误。

【讨论】：

我正在使用 Charles Proxy 进行 SSL 欺骗，这导致信任值为 4。当我关闭代理时，它成功了。

【解决方案27】：

有很多方法可能会出错。有两点给我带来了麻烦：

在 Xcode 中，当您添加 Associated Domains 权利时，每个条目需要以 applinks: 开头，然后是您的域名。例如。 applinks:www.apple.com.
虽然 Xcode 为我创建了一个权利文件，但它并未包含在我的构建中：我必须手动单击该框。

是的，在这样做之后，没有必要签署apple-app-site-association 文件：它只是纯文本，只要它通过 HTTPS 提供，它就可以工作。（不过，如果您支持 iOS 8，您仍然需要签名。）

【讨论】：

我还必须从测试设备中完全删除该应用程序，然后在它最终运行之前再次构建和运行。
你救了我的命，这是我的问题，虽然 XCode 为我创建了一个权利文件，但它没有包含在我的构建中：我必须手动单击该框。
在构建中包含权利文件也为我解决了这个问题。值得注意的是，在 Xcode 8 中，文件检查器中的目标成员资格复选框实际上是禁用的。我必须转到构建设置并将权利文件添加到复制资源阶段。
@cham：你们能否详细说明“虽然 XCode 为我创建了一个权利文件，但它并未包含在我的构建中：我必须手动单击该框。”
@AwaisFayyaz 转到构建阶段 > 复制捆绑资源。单击加号，然后添加您的授权文件。

【解决方案28】：

在集成通用链接后增加项目版本或内部版本号也非常重要。即使您删除/重新安装，iOS 也不会获取链接，除非您升级版本。

【讨论】：

这个！捆绑版本完全是导致我的测试失败的原因，因为我会通过上述所有建议，并且我的链接仍然会启动 Safari，因为 iOS 正在使用来自先前版本的 apple-app-site-association 的缓存结果，该版本具有错误的 appId 前缀
凯尔，我想我爱你！这个答案节省了一天，谢谢！
这是我的秘诀！谢谢谢谢谢谢！
哇哦，这就是废墟中的钻石！谢谢！！

【解决方案29】：

如果这里的人们正在寻找其他解决方案，我们会逐步整理出调试通用链接的整个步骤，因为我们已经看到了很多问题弹出，引起了很多麻烦。

检查一下：

Universal Links Debugging Guide

如果您只是想重新设置通用链接，本指南非常有用：

iOS Deep Linking Setup Guide

希望对您有所帮助！

【讨论】：

非常有帮助，谢谢！在实际设备上运行时为我工作，但不是 iOS 模拟器。
链接不再有效。图像是现在唯一有用的东西。

【解决方案30】：

我的问题原来是apple-app-site-association 文件。根据 Apple 的文档，只需要 applinks 参数。我添加了activitycontinuation 参数并且它起作用了。

{
  "activitycontinuation": {
    "apps": [
      "9JA89QQLNQ.com.apple.wwdc"
    ]
  },
  "applinks": {
    "apps": [],
    "details": [{
        "appID": "9JA89QQLNQ.com.apple.wwdc",
        "paths": [ "/wwdc/news/", "/videos/wwdc/2015/*" ]
      }]
  }
}

【讨论】：

3 年后，我们遇到了这个确切的问题。添加activitycontinuation 为我们解决了这个问题。