友盟微信、QQ等分享提示未验证应用配置

确认微信App版本是否支持Universal Links

首先，确认微信(7.0.7或以上版本)的Universal Links在设备上正常，以确保openSDK与微信双向使用Universal Links通信 Safari输入https://help.wechat.com/app/

Safari 加载完成后需要下拉到顶，查看是否有打开微信入口(如下图)。若无入口，可能是由于系统拉取微信Universal Links失败，请检查手机网络状态是否正常，或更新/重装微信

配置我们App的苹果Universal Links

请按照以下步骤将您的应用和网站相关联以获取Universal Links：

• 将添加Associated Domains Entitlement到您的应用。使用applinks服务前缀包含您的应用程序将支持的所有域。请参阅添加关联的域权利。

• 将Apple App Site Association文件添加到您的网站。请参阅添加Apple App Site Association文件。

• 将applinks密钥添加到Apple App Site Association文件中。指定每个应用程序将处理的网站部分。

具体操作

1. 登录苹果开发者后台，在设置证书的页面找到 Identifiers -> App ID（设置包名）里，在对应的BundleId下勾选 Associated Domains如下图

名）里，在对应的BundleId下勾选 Associated Domains如下图

保存设置，然后重新生成配置文件。

2. 在Xcode(11)里面添加Associated Domains

按照图中的步骤添加好Universal Links

注意点:在 Associated Domains里面配置的Universal Links必须要以applinks:开头，后面写上域名不要加paths，例如

applinks:www.apple.com

3. 配置apple-app-site-association

自己创建一个名叫 apple-app-site-association的json格式文件，注意文件命不需要添加的后缀。apple官方参照地址

{
    "applinks": {
        "apps": [],
        "details": [{
            "appID": "D3KQX62K1A.com.example.photoapp",
            "paths": ["/albums"]
            },
            {
            "appID": "D3KQX62K1A.com.example.cameraapp",
            "paths": ["*"]
            }
    }
}

• details-- 键的值添加为字典数组的JSON表示，每个应用程序一个字典。对于每个特定于应用程序的词典(上面就表示了同一个teamid下的4个不同的应用)，包括 和 键：appIDpaths

• appID-- 将处理格式为的链接的应用程序的标识TeamIdentifier.bundle identifier(开发者账号teamID.app的bundle identifier)。

• paths-- 应用程序支持的网站各个部分，以路径字符串数组形式指定。只有这些指定的路径的链接，才能被app所处理, *符号写法代表了可识别域名下所有链接 建议Universal Links配置path，例如/app/*, 避免全域命中Universal Links跳转。我之前就是用全域通配，提供给合作方的H5页面，在某些情况（微信浏览然后通过Safari加载的时候；合作方App加载H5的时候）下会打开或者跳转到自己App。遇到这种情况只能重新配置apple-app-site-association文件的paths，而且分享还会出现异常。

• 例如： 附加 * 到特定的网址（例如/ videos/samples/2015/*）以指定/下的所有路径videos/samples/2015/。使用 ? 匹配任何单个字符，如/photography/*/samples/201?/mypage。使用独立* 网站来指定整个网站。
  通过“NOT ”在路径字符串的开头添加（包括T后面的空格）来标识不应处理的区域。
  注意 用于在paths 数组中指定网站路径的字符串 区分大小写。仅将URL的路径部分用于比较。其他组件（例如查询字符串或片段标识符）将被忽略。

4.上传apple-app-site-association到服务器(服务器需要支持https)

上传 apple-app-site-association文件到域名的根目录或者.well-known子目录下
能打开https:///apple-app-site-association 或 https:///.well-known/apple-app-site-association
当我们的App在设备上第一次运行时，如果支持Associated Domains功能，那么iOS会自动去获取域名下的apple-app-site-association文件

• 上传成功后，我们可以用苹果提供的验证网址来直接验证apple-app-site-association设置是否生效。

注意事项 ： iOS 9.2之前，不用跨域都可以跳转， iOS 9.2之后，必须跨域才能进行跳转到原生app上。
iOS只会在App第一次启动时请求一次apple-app-site-association文件，服务器上该文件的更新不会让iOS本地的文件同步更新。

5. 工程中添加处理方法

现在用户点击我们配置的域名下的匹配的链接,直接可以进我们的app了。但是,如果想要能够获取到用户进来的链接,根据链接来处理,需要展示给用户的信息
那么需要在工程里的 AppDelegate 里实现 方法

- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray *))restorationHandler
{
    if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) {
        NSURL *webpageURL = userActivity.webpageURL;
        NSString *host = webpageURL.host;
        if ([host isEqualToString:@"apple..com"]) {
            //进行我们需要的处理
        }
        else {
            [[UIApplication sharedApplication]openURL:webpageURL];
        }
    }
    return YES;
}

当 userActivity 是 NSUserActivityTypeBrowsingWeb 类型, 则意味着它是由Universal Links进来,也就是处理逻辑的时候。

确认App的Universal Links配置成功

用xcode 跑一个debug 包（卸载之前包），通过 Safari输入Universal Links(包括完整路径)+随机字符串(例如: abc)，因为第三方分享会在后面添加参数，所以添加随机字符，加载完成后，入口默认是在最顶上看不到，需要往上滑顶才能看到，如果能展示你的App就代表通配符*配置成功了。

集成微信分享的配置和Universal Links配置

集成微信SDK（ 如果已经集成了分享功能，可以忽略部分步骤）

• 在 Xcode 中，选择你的工程设置项，选中“TARGETS”一栏，在“info”标签栏的“URL type“添加“URL scheme”为你所注册的应用程序 id

  
  
  添加微信URL scheme

• 在Xcode中，选择你的工程设置项，选中“TARGETS”一栏，在 “info”标签栏的“LSApplicationQueriesSchemes“添加weixin 和weixinULAPI（ 如果已经集成了分享功能，应该已经配置好了）
  

  添加白名单

• 注册微信、实现微信代理等操作 （如果是集成了友盟按照友盟注册和实现代理）

• 微信开发者后台添加Universal Links （这步官网没有提示很容易遗漏）
  

  微信后台添加Universal Links

• 最后可以使用WXApi新增了自检函数checkUniversalLinkReady: 自检函数排查接入问题

//在register之前打开log, 后续可以根据log排查问题
[WXApi startLogByLevel:WXLogLevelDetail logBlock:^(NSString *log) {
    NSLog(@"WeChatSDK: %@", log);
}];

//务必在调用自检函数前注册
[WXApi registerApp:APP_ID universalLink:UNIVERSAL_LINK];

//调用自检函数
[WXApi checkUniversalLinkReady:^(WXULCheckStep step, WXCheckULStepResult* result) {
    NSLog(@"%@, %u, %@, %@", @(step), result.success, result.errorInfo, result.suggestion);
}];

WXULCheckStep值说明:
step = WXULCheckStepParams: 参数检查 step = WXULCheckStepSystemVersion: 当前系统版本检查 step = WXULCheckStepWechatVersion: 微信客户端版本检查 step = WXULCheckStepSDKInnerOperation: 微信SDK内部操作检查 step = WXULCheckStepLaunchWechat: App拉起微信检查 step = WXULCheckStepBackToCurrentApp: 由微信返回当前App检查 step = WXULCheckStepFinal: 最终检查 会依次回调这7个step，当回调了WXULCheckStepFinal，说明检测通过，SDK接入成功。 任一step回调的result.success为NO, 流程终止，后续不再回调，可以根据result.errorInfo的查看当前步骤错误的原因，根据result.suggestion修复问题.

以上微信相关配置来自以 微信官方文档

配置中遇到坑

• 我的工程是集成了友盟精简版微信分享，友盟版本需要6.9.7以上才支持了WechatOpenSDK 1.8.6，而且需要完整版，所以用精简版的同学需要更换为完整版。
  

  image.png

• 我的项目集成了微信支付，微信和友盟完整版分享会有冲突，那就不能用cocoapods 集成了，需要更换为手动集成微信SDK和友盟分享??。在友盟SDK中删除libWeChatSDK.a WXApiObject.h 最后如下图
  

  微信

• 所有都集成好了，调试手机微信分享没有提示未验证?，打包测试安装后还是未验证，各种排查，各种查资料?，原来授权不是及时的，到了第二天才生效了。

• 还有测试直接不能分享，授权页面就直接自动返回App。又是各种排查????，最后重启手机问题解决了。

• 旧版本没有正确接入新版OpenSDK（有分享二跳，授权登录二次确认的情况），新版 本刚修复这个问题。需要等新版本放量上去让整体错误率下降到90%以下才会从未验证应用中移除。
  例：前一天你的App总共分享了100次消息到微信（微信以AppID来统计，只计算1.8.6以及以上版本的分享），其中正确的次数必须要高于10次。

• paths用全域通配"paths": ["*"]， 导致全域命中Universal Links跳转。提供给合作方的H5页面，在某些情况（微信浏览然后通过Safari加载的时候；合作方App加载H5的时候）下会打开或者跳转到自己App。各方合作方都来投诉，没办法只能重新配置apple-app-site-association文件的"paths": ["/app/*"],修改完成后，重新卸载安装App测试发现不会再跳转了，线上App微信分享也正常，感觉事情就要结束了?。告诉合作方已经修改好了，但是他们手机安装我们的App已经授权，缓存了Universal Link记录，依然会跳转到我们的App，于是就各种查资料、看官方文档没有关于缓存时间和触发apple-app-site-association更新的时机?。经过自己的测试只有卸载重装、更新App会触发apple-app-site-association更新的时机，新的Universal Links才会生效。反复折腾了一天，只希望苹果明天会更新缓存（我知道这个是不能的，只是幻想）。

• 第二天，没有等来更新缓存的好消息，却给我迎头一棒，在系统 iOS 14以上的新用户微信无法分享，正在连接，就直接跳回App，导致无法分享。iOS 14 以下可以正常使用。

  
  
  image.png

后面更新了微信后台的Universal Link，发现线上用户都无法使用微信分享，提示Universal Link验证失败?，赶紧恢复了之前的Universal Link。只能等待新版上线开启新的Universal Link，到时候老版本都会无法分享，有投诉就只能让用户更新App。感觉微信太不厚道了，appid已经配置了，你不能分享失败啊！回到以前分享成功显示未验证，我也能接受啊！