DCloud_App_Array
DCloud_App_Array
  • 发布:2015-10-19 17:21
  • 更新:2024-02-07 15:35
  • 阅读:121750

Android平台设置UrlSchemes,实现被第三方应用调用

分类:HTML5+

此文档不再维护,请参考新文档地址:https://uniapp.dcloud.io/tutorial/app-android-schemes

如果你的App想要在手机系统中注册一个scheme协议,方便其他App调用你的App,那么可以根据本文设置。

设置UrlSchemes

打开项目的manifest.json文件,切换到“代码视图”

  • 5+App项目
    在manifest.json文件的"plus"->"distribute"->"google"下添加schemes节点数据如下:
    "plus": {  
    "distribute": {  
        "google": {  
            "schemes": [  
                "test"  
            ],  
            //...  
        },  
        //...  
    },  
    //...  
    },  
    //...
  • uni-app项目
    把上面的schemes节点数据放到manifest.json的"app-plus"->"distribute"->"android"节点下

值域说明:为字符串数组,每个字符串为一个urlscheme,使用小写字母(不要使用特殊字符、中文),可设置多个。比如设置为test,那么其他App呼起你的app的scheme协议就是test://。

保存后提交App云端打包生效

浏览器中通过href启动应用

安装应用后,我们可以在html页面中,通过href直接调用应用:

<a href="test://abc">test:<a><br/>

5+ APP中处理urlscheme启动传递的参数

在其它应用中通过href调用Url Scheme传递过来的值,可以通过plus.runtime.arguments获取
其值为完整的urlscheme字符串,如上面href的值启动应用后获取的plus.runtime.arguments值为“test://abc”
代码示例如下:

document.addEventListener('plusready',function(){  
    checkArguments();  
},false);  
// 判断启动方式  
function checkArguments(){  
    console.log("plus.runtime.launcher: "+plus.runtime.launcher);  
    var args= plus.runtime.arguments;  
    if(args){  
        // 处理args参数,如直达到某新页面等  
    }  
}  
// 处理从后台恢复  
document.addEventListener('newintent',function(){  
    console.log("addEventListener: newintent");  
    checkArguments();  
},false);

uni-app中处理urlscheme启动传递的参数

在App.vue的onShow里可以直接获取

onShow: function() {  
    var args= plus.runtime.arguments;  
    if(args){  
        // 处理args参数,如直达到某新页面等  
    }  
}

HBuilder/HBuilderX自带真机运行基座的UrlSchemes为"hbuilder://",方便开发者调测。

如果是本地(离线)打包,请自行在原生工程中配置

iOS平台请参考:
iOS平台通过UrlSchemes与第三方应用相互调用

31 关注 分享
BoredApe TommyJin dreamit1986 Trust 雪之梦技术驿站 火岚 8***@qq.com 小明子 mingtianfu 漠 dipper echoer 笑着接受一切 hylong 小诺小言 乐子西 3***@qq.com M***@qq.com 野蛮的橘子 1***@qq.com aliang888 4***@qq.com choin 诸葛逍遥 中项网前端 5***@qq.com 5***@qq.com l***@163.com 1***@qq.com 9***@qq.com fortest

要回复文章请先登录注册

2***@qq.com

2***@qq.com

plus.runtime.arguments。能正常唤起,但是获取不到参数。要hide,再打开才会有参数。这是什么原因?
2019-07-24 18:48
2***@qq.com

2***@qq.com

回复 1***@qq.com :
你设置好了吗 我的H5+APP,设置吊不到应用,求指点
2019-06-18 12:51
2***@qq.com

2***@qq.com

设置了还是打不开 什么问题导致的呢
2019-06-18 12:49
1***@qq.com

1***@qq.com

回复 DCloud_App_Array :
我知道是什么问题了 h5+ 设置 scheme是在plus->distribute->google设置有效,un-app设置scheme在 app-plus->distribute->android 里面有效 ,而文档上只是说吧plus改成app-plus
2019-05-10 13:42
DCloud_App_Array

DCloud_App_Array (作者)

回复 1***@qq.com :
提供下appid(manifest.json中的id字段值)
2019-05-10 11:16
1***@qq.com

1***@qq.com

uni-app中 为什么我设置Schemes后提交云打包,打包好安装到自己的手机上用h5唤起就换不醒(已经排除浏览器问题)
2019-05-10 11:08
xiaohui

xiaohui

回复 1***@qq.com :
在全局的onshow()接受 我的是在app.vue文件的onshow()里面接受的
2019-04-11 16:12
xiaohui

xiaohui

回复 1***@qq.com :
在全局的方法里处理参数
2019-04-11 16:12
xiaohui

xiaohui

plus.runtime.arguments 用完了咋办,可以清空么
2019-04-11 15:59
有问

有问

这个不好用,有BUG,测试多次,本来用变量按类别区分后正常可以打开不同的链接,结果每次一打开,把所有步骤都执行了,if else条件都没用。。。。
2019-04-11 13:20