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,编译时,安卓必须使用"升级环境编译" 否则会载入不了插件(京东方面限制了,导致必须要用升级环境编译)

##创建自定义插件 流程简要说明

├─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(注明 京东插件) 非技术人员,或闲聊者勿扰.

是否仍需要帮助? 请保持联络!
最后更新于 2024/04/8