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,审核通过,如下图

Alt text

Alt text

  • 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文件 Alt text

  • 4,在控制台上传自定义模块包如下图 Alt text
  • 5,如果一切不出错,那么就可以添加这个模块,进行编译了,可先尝试自定义loader编译(安卓必须选中使用升级环境编译)

反馈和建议

如遇技术原因可加QQ群 865279417(注明 京东模块) 非技术人员,或闲聊者勿扰.