DCloud_App_Array
DCloud_App_Array
  • 发布:2014-09-24 16:08
  • 更新:2024-11-18 13:26
  • 阅读:116335

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

分类:HTML5+

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

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

设置UrlSchemes

可视化界面配置

打开项目的manifest.json文件,在“App常用其它设置”页面“iOS设置”下的UrlSchemes中配置scheme字段:

注意:多个scheme使用','分割

代码视图配置

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

  • 5+App项目
    在manifest.json文件的"plus"->"distribute"->"apple"节点下添加urltypes数据
  • uni-app项目
    在manifest.json的"app-plus"->"distribute"->"ios"节点下添加urltypes数据

urltypes节点数据如下:

"plus": {  
    "distribute": {  
        "apple": {  
            "urltypes": [  
                    {  
                        "urlidentifier":"com.xxx.test",  
                        "urlschemes": [  
                            "test"  
                        ]  
                    }  
            ],  
            //...  
        },  
        //...  
    },  
    //...  
},  
//...

值域说明:urlidentifier为标识,可自定义,格式为反向域名格式;
urlschemes为要指定的scheme值,字符串数组,使用小写字母,可设置多个。 比如设置为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 中onLaunch 里获取

onLaunch: function() {  
      plus.globalEvent.addEventListener('newintent', (e)=>{  
            var args= plus.runtime.arguments;  
        if(args){  
                // 处理args参数,如直达到某新页面等  
        }  
        });  
}   

在App.vue的onShow里获取

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

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

如果是离线打包,自行在原生工程中配置

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

26 关注 分享
dreamboycx Trust 2***@qq.com 8***@qq.com 知行合一 dipper echoer hylong 1***@qq.com 陈锐 Potato1314 小诺小言 3***@qq.com 3***@qq.com skysowe 1***@163.com Smart900zhang i***@163.com aliang888 我不是大v 诸葛逍遥 123wangyi 大图APP 六七四十二 5***@qq.com s***@163.com

要回复文章请先登录注册

1***@qq.com

1***@qq.com

回复 猎宝 :
没有
2020-01-02 10:01
猎宝

猎宝

回复 1***@qq.com :
老哥,解决了没?
2019-12-31 20:20
猎宝

猎宝

回复 4***@qq.com :
老哥,请问你最后清空掉了吗?我也遇到同样的问题
2019-12-31 19:36
猎宝

猎宝

回复 Iversong23 :
我也是同样的问题,希望官方能够修复
2019-12-31 19:35
1***@qq.com

1***@qq.com

回复 Iversong23 :
同样的问题
2019-12-17 14:47
Iversong23

Iversong23

IOS环境:云打包后的app,通过H5在第一次通过urlscheme打开app时获取不到plus.runtime.arguments的值,再次唤醒就可以取到了。

```
// uniapp
onShow: function() {
console.log('App Show')
var args= plus.runtime.arguments;
console.log(JSON.stringify(args))
}

// H5代码
<a href="hbuilder://pages/user/certification">唤起测试<a>
```

![image](https://snage-image.oss-cn-hangzhou.aliyuncs.com/imgextra/WX20191203-145236%402x.png)
2019-12-03 15:05
今天回复我了吗

今天回复我了吗

回复 8***@qq.com :
我也是,换成ali 或者淘宝的在微信内部浏览器好像也打不开
2019-11-20 20:03
8***@qq.com

8***@qq.com

这个是不是在微信打开不了?我配置了然后safari可以打开,,但是分享到微信然后这样跳转,,这个打不开自己的app
2019-09-05 15:09
4***@qq.com

4***@qq.com

1.plus.runtime.arguments用完怎么清空,如果不清空APP不杀死后台再次打开APP还是会获取到plus.runtime.arguments;
2.自定义基座打包测试微信分享 分享完调起APP第一次获取不到值,如果杀死APP 再用分享链接调起也获取不到值 是因为自定义基座的原因吗?
2019-08-01 13:36
4***@qq.com

4***@qq.com

楼主您好,我想请问下,在ios下,我成功的调用打开了第三方的app,但是在我方app调用打开第三方的app,打开会第三方app会出现白屏现象(我需要调用的第三方app)。但是如果我调用打开淘宝之类的就正常。
如果单独打开第三方app,不会出现这个现象。
2019-07-31 15:24