微信中通过页面(H5)直接打开本地app的解决方案

小鱼儿 2023-10-17 21:02 92阅读 0赞

## 简述 ##

微信中通过页面直接打开app分为安卓版和IOS版，两个的实现方式是完全不同的。

安卓版实现：使用腾讯的应用宝，只要配置了“微下载”之后，打开链接腾讯会帮你判断本地是否已经安装了app，如果本地安装就直接打开，没有安装的话就是腾讯微下载的页面进行app下载，当然微下载的页面腾讯提供了几个模板，可以自己选择和修改。

IOS实现：ios像直接点击链接打开本地app就难了，有两种方式可供我们选择：

1.腾讯深度合作的公司，微信可以帮你打开app；

2.使用IOS9+的新功能“Universal Links”（通用链接）；

很显然，第二种方式更适合我们普通的公司。

## 效果展示 ##

![172074-20170908184846866-1740885915.gif][]

## 实现步骤 ##

**1.配置https（必须是https）网站支持；**

创建“apple-app-site-association”文件，注意不带后缀，放到网站根目录，确保可以使用：https://xxx.xxx.xxx/apple-app-site-association直接可以访问，apple-app-site-association文件内容如下：

{
        "applinks": {
            "apps": [],
            "details": [
                {
                    "appID": "*****.com.gangguwang.yewugo",
                    "paths": [ "/app/*" ]
                }
            ]
        }
    }

其中appId是你的Prefix + ID，如图：

![172074-20170909093700304-647720603.png][]

paths为你链接拦截的地址，比如我上面填写的是“/app/\*”,就是当我访问https://xxx.xxxx.xxx/app/x的时候，会打开本地app，其他连接时候则为正常显示，这个地址可以配置成多个，也可以直接写\*；

**2.配置苹果证书，开启“Associated Domains”，如下图：**

Identifiers - App IDs –Edit 然后开启打钩 Associated Domains 后保存，配置地址：[https://developer.apple.com/account/ios/identifier/bundle][https_developer.apple.com_account_ios_identifier_bundle]

![172074-20170909093316866-1821926562.png][]

**3.配置你的App的Universal Links（通用链接）**

如果你是普通的ios项目的的话，配置如下：项目 targets->Capabilities->Associated Domains，如图填写你的链接域名

![172074-20170909094233085-1546217956.png][]

域名的格式必须为：applinks:你的域名（ex:applinks:www.domain.com）,可以配置多个;

如果你是Xamarin项目的话，需要选择Entitlements.plist配置关联域，如图：

![172074-20170909094959741-1009707371.jpg][]

这样配置完之后，打包即可测试你的应用咯。

官方配置文件：[https://developer.apple.com/library/content/documentation/General/Conceptual/AppSearch/UniversalLinks.html\#//apple\_ref/doc/uid/TP40016308-CH12-SW2][https_developer.apple.com_library_content_documentation_General_Conceptual_AppSearch_UniversalLinks.html_apple_ref_doc_uid_TP40016308-CH12-SW2]

## 扩展知识（关于Xamarin） ##

如果你要处理链接打开本地app并跳转到相应的详情页的话，需要这样实现：

1.在你的xxx.iOS项目打开“AppDelegate.cs”文件；

2.重写方法，代码如下：

public override bool ContinueUserActivity(UIApplication application, NSUserActivity userActivity, UIApplicationRestorationHandler completionHandler)
    {
        if (userActivity.ActivityType == NSUserActivityType.BrowsingWeb)
        {
            string url = userActivity.WebPageUrl.ToString(); //全地址
            if (!string.IsNullOrEmpty(url))
            {
                //你的业务处理
            }
        }
        return true;
    }

参考文档：[https://components.xamarin.com/gettingstarted/googleiosappindexing][https_components.xamarin.com_gettingstarted_googleiosappindexing]

## 注意事项 ##

1.配置的网站必须是https，不能为http；

2.**\[重要\]**展示地址和打开的地址不能在一个域名下（作者测试发现放在同一服务器下都不行），比如展示页的地址是https://a.domain.com/?id=10，打开的如果是https://a.domain.com/app/?id=10，系统默认是打开页面，而不是触发通用链接打开app；

3.**\[重要\]**配置玩证书之后需要更新证书，才能内部打包和提测上传成功；

4.通用链接可被屏蔽，点击右上角配置的链接之后，通用链接就失效了，解决方案详见：[《iOS通用链接（Universal Links）突然点击无效的解决方案》][iOS_Universal Links]。

如果觉得本文对你有帮助，请点击右下角“推荐”按钮，谢谢！

[172074-20170908184846866-1740885915.gif]: https://images2017.cnblogs.com/blog/172074/201709/172074-20170908184846866-1740885915.gif
[172074-20170909093700304-647720603.png]: https://images2017.cnblogs.com/blog/172074/201709/172074-20170909093700304-647720603.png
[https_developer.apple.com_account_ios_identifier_bundle]: https://developer.apple.com/account/ios/identifier/bundle
[172074-20170909093316866-1821926562.png]: https://images2017.cnblogs.com/blog/172074/201709/172074-20170909093316866-1821926562.png
[172074-20170909094233085-1546217956.png]: https://images2017.cnblogs.com/blog/172074/201709/172074-20170909094233085-1546217956.png
[172074-20170909094959741-1009707371.jpg]: https://images2017.cnblogs.com/blog/172074/201709/172074-20170909094959741-1009707371.jpg
[https_developer.apple.com_library_content_documentation_General_Conceptual_AppSearch_UniversalLinks.html_apple_ref_doc_uid_TP40016308-CH12-SW2]: https://developer.apple.com/library/content/documentation/General/Conceptual/AppSearch/UniversalLinks.html#//apple_ref/doc/uid/TP40016308-CH12-SW2
[https_components.xamarin.com_gettingstarted_googleiosappindexing]: https://components.xamarin.com/gettingstarted/googleiosappindexing
[iOS_Universal Links]: http://www.cnblogs.com/vipstone/p/7505571.html