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。里面安全图片后续要用到。

Image text

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及更高版本