什么是 URL Scheme?
android中的scheme是一种页面内跳转协议,是一种非常好的实现机制,通过定义自己的scheme协议,可以非常方便跳转app中的各个页面;通过scheme协议,服务器可以定制化告诉App跳转那个页面,可以通过通知栏消息定制化跳转页面,可以通过H5页面跳转页面等。
URL Scheme应用场景:
客户端应用可以向操作系统注册一个 URL scheme,该 scheme 用于从浏览器或其他应用中启动本应用。通过指定的 URL 字段,可以让应用在被调起后直接打开某些特定页面,比如商品详情页、活动详情页等等。也可以执行某些指定动作,如完成支付等。也可以在应用内通过 html 页来直接调用显示 app 内的某个页面。综上URL Scheme使用场景大致分以下几种:
服务器下发跳转路径,客户端根据服务器下发跳转路径跳转相应的页面
H5页面点击锚点,根据锚点具体跳转路径APP端跳转具体的页面
APP端收到服务器端下发的PUSH通知栏消息,根据消息的点击跳转路径跳转相关页面
APP根据URL跳转到另外一个APP指定页面
URL Scheme协议格式:
先来个完整的URL Scheme协议格式:
openapp://thisapp:8888/content?Id=10011002
通过上面的路径 Scheme、Host、port、path、query全部包含,基本上平时使用路径就是这样子的。(Scheme和Host是必要的)
openapp代表该Scheme 协议名称(相当于http这样的协议头)
thisapp代表Scheme作用于哪个地址域(相当于baidu.com这样的域名格式,当然,可以不需要.com这样的后缀)
content代表Scheme指定的页面(相当于 baidu.com/css 这样的路径,然后在app内打开相关的页面)
Id代表传递的参数(相当于 https://www.baidu.com/s?wd=12312 这样的GET参数)
8888代表port该路径的端口号
URL Scheme如何使用:
1.在AndroidManifest.xml中对 < activity / > 标签 增加 < intent-filter /> 设置Scheme
<activity            android:name=".GoodsDetailActivity"            <!--Activity的名称-->            android:theme="@style/AppTheme">             <!--Activity的主题-->            <!--要想在别的App上能成功调起App,必须添加intent过滤器-->            <intent-filter>                                <data android:scheme="openapp" android:host="thisapp" android:path="/content" android:port="8888"/>                                <category android:name="android.intent.category.DEFAULT"/>                <action android:name="android.intent.action.VIEW"/>                <category android:name="android.intent.category.BROWSABLE"/>            </intent-filter></activity>
2.JAVA获取Scheme跳转的参数
Uri uri = getIntent().getData();if (uri != null) {        String url = uri.toString();    Log.e(TAG, "url: " + uri);        String scheme = uri.getScheme();    Log.e(TAG, "scheme: " + scheme);        String host = uri.getHost();    Log.e(TAG, "host: " + host);        int port = uri.getPort();    Log.e(TAG, "host: " + port);        String path = uri.getPath();    Log.e(TAG, "path: " + path);    List<String> pathSegments = uri.getPathSegments();        String query = uri.getQuery();    Log.e(TAG, "query: " + query);        String goodsId = uri.getQueryParameter("Id");    Log.e(TAG, "Id: " + Id);}
3.调用方式
HTML网页
<a href="openapp://thisapp:8888/content?Id=10011002">打开商品详情</a>
原生调用
  Intent intent = new Intent(Intent.ACTION_VIEW,Uri.parse("xl://goods:8888/goodsDetail?goodsId=10011002"));  startActivity(intent);
4.如何判断一个Scheme是否有效
PackageManager packageManager = getPackageManager();Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse("xl://goods:8888/goodsDetail?goodsId=10011002"));List<ResolveInfo> activities = packageManager.queryIntentActivities(intent, 0);boolean isValid = !activities.isEmpty();if (isValid) {    startActivity(intent);}
如果手机内没有安装该APP则JS跳转至下载页面
 <!DOCTYPE html>    <html lang="en">    <head>    <title>h5跳原生</title>    </head>    <body></body>    <script>    (function(){        var ua = navigator.userAgent.toLowerCase();        var t;        var config = {                scheme_IOS: 'openapp://',                scheme_Adr: 'openapp://thisapp:8888/content?Id=10011002',                download_url: 'http://www.baidu.com',                                timeout: 600        };        function openclient() {            var startTime = Date.now();            var ifr = document.createElement('iframe');            ifr.src = ua.indexOf('os') > 0 ? config.scheme_IOS : config.scheme_Adr;            ifr.style.display = 'none';            document.body.appendChild(ifr);            var t = setTimeout(function() {                var endTime = Date.now();
                if (!startTime || endTime - startTime < config.timeout + 200) {                    window.location = config.download_url;                } else {                }            }, config.timeout);            window.onblur = function() {                clearTimeout(t);            }        }         openclient();    })()</script>    </html>
第二种
<!DOCTYPE html><html xmlns:th="http://www.thymeleaf.org"><head><meta charset="utf-8" /><title>文档标题</title></head><body>    <div style="font-size: 68px;">        <a href="javascript:open_or_download_app();">打开APP</a>        <span id="device"></span>    </div>    <script type="text/javascript">        function open_or_download_app() {        var device = document.getElementById("device");        if (navigator.userAgent.match(/(iPhone|iPod|iPad);?/i)) {            device.innerHTML = "ios设备";                        var loadDateTime = new Date();                      window.setTimeout(function() {                var timeOutDateTime = new Date();                if (timeOutDateTime - loadDateTime <2200) {                    window.location = "xxxxxxxx";                  } else {                    window.close();                }            },2000);             window.location = "openapp://thisapp:8888/content?Id=10011002";          } else if (navigator.userAgent.match(/android/i)) {            device.innerHTML = "Android设备";                                    var loadDateTime = new Date();                      window.setTimeout(function() {                var timeOutDateTime = new Date();                if (timeOutDateTime - loadDateTime < 2200) {                    window.location = "xxxxxxxx";                   } else {                    window.close();                }            },2000);             window.location = "openapp://thisapp:8888/content?Id=10011002";          }     }     </script></body></html>
总结:
Scheme的基本使用也就这么多了,其他的使用在以后用到的时候再做总结。
该文章在 2025/8/5 18:39:24 编辑过