uzkJDopen
论坛示例
为帮助用户更好更快的使用模块,论坛维护了一个示例,示例中包含示例代码、知识点讲解、注意事项等,供您参考。
概述
模块简介
uzkJDopen模块 封装了京东联盟SDK,能够使你的app具备任何京东链接拉起到京东客户端app打开,并具备返回键返回到你的APP的功能。
模块使用攻略
使用之前须在京东联盟-》推广管理-》APP管理,创建应用,并获取 appkey和安全图片。
在使用模块中出现任何问题可以通过邮箱:hkeda@qq.com,或者QQ:474938261与我联系。
准备事项
1.首先在京东联盟创建应用https://union.jd.com/manager/appMng,在京东联盟-》推广管理-》APP管理创建应用获取appkey
注意安卓平台应用要下载下方的小工具来获取MD5和SHA1值,应用创建成功后,等待审核,审核通过后点击应用管理下载SDK。里面安全图片后续要用到。
2.配置 Android 自定义模块:(如 Jdsdkkey)
安卓的安全图片在你应用管理处下载京东联盟的SDK里面,文件在src/main/res/raw/safe.jpg目录下。
首先下载Jdsdkkey模块,将其解压并将Android的安全图片 safe.jpg 放到文件夹 Jdsdkkey\res_Jdsdkkey\res\raw 目录下替换原有图片,重新打包成zip,即可作为自定义模块使用。(自定义模块名称可以更改为你想要的,如目录结构 xxx\res_xxx\res\raw)
6.配置 ios 自定义模块:(如 Jdsdkkey) 苹果的安全图片在你应用管理处下载京东联盟SDK里面,文件名为根目录下的JDSDK.bundle。 首先下载Jdsdkkey模块,将其解压并将ios的安全图片 JDSDK.bundle 放到文件夹 Jdsdkkey\target目录下替换掉,重新打包成zip,即可作为自定义模块使用。(自定义模块名称可以更改为你想要的,如目录结构 xxx\target)
使用此模块之前建议先配置 config.xml 文件,配置完毕,需通过云端编译生效,配置方法如下:
- 名称:安卓:android_uzkJDopen,ios : ios_uzkJDopen
- 参数:urlScheme, querySchemes
- 配置示例:
<preference name="querySchemes" value="openapp.jdmobile,jdlogin"/>
<feature name="android_uzkJDopen">
<param name="appkey" value="填入你的安卓应用appkey"/>
<param name="appsecret" value="填入你的安卓应用appsecret"/>
</feature>
<feature name="ios_uzkJDopen">
<param name="appkey" value="填入你的苹果应用appkey"/>
<param name="appsecret" value="填入你的苹果应用appsecret"/>
<param name="urlScheme" value="sdkback加上你的苹果应用appkey" />
</feature>
- 字段描述:
**querySchemes**:querySchemes参数用于配置可被检测的URL Scheme,多个参数用逗号隔开,本模块需添加openapp.jdmobile,jdlogin两个参数。
模块接口
init
京东联盟SDK模块初始化(使用模块前务必进行一次初始化操作,该方法可以写在入口文件index.html页面)
特别注意:
使用uzkJDopen模块前请务必调用该方法进行初始化操作。
init(callback(ret, err))
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
status: true //布尔型;true||false,true:初始化成功,false:初始化失败
msg:"初始化成功" //字符串类型;初始化成功||初始化失败
}
err:
- 类型:JSON 对象
- 内部字段:
{
}
示例代码
var uzkJDopen = api.require('uzkJDopen');
uzkJDopen.init(function(ret, err) {
if (ret.status) {
alert("初始化成功");
} else {
alert('初始化失败');
}
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
openurl
拉起京东客户端打开任意链接(必须为京东系域名链接无法打开)
openurl({parma},callback(ret, err))
params
url:
- 类型:字符串
- 描述:(必传)需要打开的京东URL,比如优惠券领券页面
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
{
status: true //布尔型;true||false; true:唤端成功,false:唤端失败
msg:"唤端成功" //字符串;内部字段,报错 : "唤端成功"||'呼起异常'||'未安装京东APP'
}
err:
- 类型:JSON 对象
- 内部字段:
{
}
示例代码
var uzkJDopen = api.require('uzkJDopen');
uzkJDopen.openurl({url:'https://u.jd.com/leJkbr'},function(ret, err) {
if (ret.status) {
alert("呼起京东app正常");
} else {
alert(ret.msg);
}
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本