jdapp
京东联盟概述
京东联盟集成京东官方移动开放SDK
适合不同场景下的入口链接嵌入,方便灵活的配置,满足不同场景下需求,可享受京东全品类实物商品、优惠券和营销工具,合作方可任意组合自己的商品页面。
便捷灵活的搭建电商系统和使用营销工具,可实现场景内交易闭环和外呼交易闭环,享受京东标准配送服务和售后服务。
当前模块在2020.08月(1.3.0)已更新为京东联盟SDK(之前是开普列SDK) 两者的安全图片不可共用,而且京东联盟SDK需要先申请后使用 如果还需要用旧版(开普列SDK)只能在选择模块时选择版本(1.2.x) 更新原因: 开普列SDK,官方长期不更新,且一直存在Uiwebview,而且要人工申请返回APP的小把手, 联盟SDK无此问题,直接带小把手,而且无uiwebview问题
模块配置
使用此模块之前建议先配置 config.xml 文件,配置完毕,需通过云端编译生效,配置方法如下:
- 名称:jdapp
- 配置示例:
<feature name="jdapp">
<param name="urlScheme" value="sdkback328e4a9843d3458000000000000" />
<param name="ios_appkey" value="328e4a9843d3458000000000000" />
<param name="ios_secretKey" value="b15acfcd1dca4654b00000000" />
<param name="android_appkey" value="328e4a9843d3458000000000000" />
<param name="android_secretKey" value="b15acfcd1dca4654b00000000" />
</feature>
- 字段描述:
- urlScheme:(必须配置) sdkback加appkey 不配置则IOS返回不了你的APP
- ios_appkey:(必须配置) 在京东联盟申请的当前APP的appkey
- ios_secretKey:(必须配置) 在京东联盟申请的当前APP的secretKey
- android_appkey:(必须配置) 在京东联盟申请的当前APP的appkey
- android_secretKey:(必须配置) 在京东联盟申请的当前APP的secretKey
- 申请教程见最下方(注意:申请时android必须用正式签名证书和包名申请,ios必须用正式的BundleID)
<preference name="querySchemes" value="jdlogin,openapp.jdmobile"/>
字段描述:
querySchemes:(必须配置) 调用京东登录和检测京东是否安装
- 如果您的APP本身有设定了querySchemes,可以value后面加上jdlogin,openapp.jdmobile,多个以英文豆号格开
- 如tbopen,weixin,wechat,alipay,jdlogin,openapp.jdmobile
模块提供的方法
init
初始化sdk
init({}, callback(ret, err))
callback(ret, err)
ret:
- 类型:JSON对象
- 内部字段:
根据ret中的status的值决定是否初始化成功,此值只有初始化成功才会是true,其它都是false data有可能是错误code,有可能是错误信息,也可能是空信息
{ status:false, msg:"初始化失败", data:101 }
err:
- 类型:JSON对象
- 内部字段:
{ }
示例代码
var jdapp= api.require('jdapp');
jdapp.init({}, function (rs, err) {
alert(JSON.stringify(rs));
})
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
open_url
打开一个京东内部网址
open_url(callback(ret, err))
params
url:
- 类型:字符串
- 描述:商品链接地址,只能同京东域名下的网址
- 必填: 是
callback(ret, err)
无
示例代码
var jdapp= api.require('jdapp');
jdapp.open_url({ url: "https://item.jd.com/24216236517.html" });
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
API申请教程
- 1,打开并登录https://union.jd.com/manager/appMng
- 2,右侧栏找到APP管理,右上角点击创建APP(按照自己APP的真实信息填写,必须使用正式签名的APP信息,填写后无法修改,请一次填写正确)
- 3,填写完当前APP的信息,会进行审核1-3个工作日
- 4,审核通过,如下图
- 5,点击下载SDK
- 6,获取safe.jpg,单独做一个自定义模块上传,用来合并文件到模块中
- android : 打开下载的SDK解压,进入目录\src\main\res\raw\下面会有一个safe.jpg
- ios : 打开下载的SDK解压,进入目录\JDSDK.bundle\下面的safe.jpg
- 7,编译时,安卓必须使用"升级环境编译" 否则会载入不了模块(京东方面限制了,导致必须要用升级环境编译)
创建自定义模块
流程简要说明
- 1,下载专用的模块包,下载链接地址:链接:https://pan.baidu.com/s/1zAdGzVakkvtBuJG4rQdrEw 提取码:ms9f
2,解压后得到模块结构
├─Android │ └─jdapp_hongbao │ │ module.json │ │ │ └─res_jdapp_hongbao │ │ AndroidManifest.xml │ └─res │ └─raw │ safe.jpg (将下载的京东android SDK中的\src\main\res\raw\safa.jpg拿过来替换掉这个文件) │ └─iOS └─jdapp_hongbao │ module.json │ └─target └─JDSDK.bundle safe.jpg (将下载的京东ios SDK中的\JDSDK.bundle\safe.jpg拿过来替换掉这个文件)
3,替换完成后,压缩对应的两个目录(Android\jdapp_hongbao) 和 (iOS\jdapp_hongbao),如下图,得到了两个zip文件
- 4,在控制台上传自定义模块包如下图
- 5,如果一切不出错,那么就可以添加这个模块,进行编译了,可先尝试自定义loader编译(安卓必须选中使用升级环境编译)
反馈和建议
如遇技术原因可加QQ群 865279417(注明 京东模块) 非技术人员,或闲聊者勿扰.