更新记录

1.0.1(2020-06-15)

安卓对应阿里百川官网4.0.0.8,ios对应官网4.0.0.16(已经完全解决Wkwebview)


平台兼容性

Android Android CPU类型 iOS
armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择


一、准备事项

1.到百川控制台申请应用https://console.baichuan.taobao.com/applications.htm,获取到appkey。

Image text

2.在百川控制台->我的产品后台申请开通百川电商权限

3.在百川控制台->套件申请,申请开通套件

Image text

4.获取安全图片

二、创建插件目录

1.在插件页面的右上角下载插件示例代码,将插件目录Lingqun-Alibc,拷贝到你的项目中的nativeplugins目录里。如果没有这个目录可以自行创建。

2.替换安全图片,将插件目录下的安全图片替换为你在百川控制台获取到的安全图片

  • android安全图片路径
    nativeplugins/Lingqun-Alibc/android/res/drawable/yw_1222.jpg
  • IOS安全图片路径
nativeplugins/Lingqun-Alibc/ios/yw_1222_baichuan.jpg

3.ios端配置URL Typese和urlschemewhitelist参数。

Image text

注意:如果不配置这个会导致ios初始化失败和无法拉起手淘,或者拉起手淘后无法回到自己的app。

4.兼容支付宝sdk 如果你的项目中有使用到支付宝sdk,需要删除插件目录的相应文件,见下方截图

image text

如果使用了支付宝sdk,没有删除这两个文件,将会打包失败。

三、试用或者购买插件

1.在插件页面点击试用按钮,选择需要试用的项目。

2.在你的项目中切换到manifest.json->APP原生插件配置->选择云端插件->选择Lingqun-Alibc插件,即可在你的项目中使用插件

Image text

3.以上步骤全部操作完成后即可进行打包自定义基座进行调试。

  • 1.在Hbuildx里点击运行->运行到手机或者模拟器->制作自定义基座->输入包名签名等信息进行打包

Image text

  • 2.打包成功后->点击运行->运行到手机或者模拟器->运行基座选择->自定义调试基座

Image text

四、在需要用到插件的页面引入

const plug= uni.requireNativePlugin('Lingqun-Alibc');

五、插件接口

1.初始化百川SDK

    plug.initSdk(res=>{
      console.log(JSON.stringify(res));                 
    });  
  • 初始化失败原因

  • android : 检查当前使用的包名签名文件是否和在百川创建应用时候填的appeky一致,并且还需要和生成安全图片的时候上传的apk的包名签名文件一致。否则一定会初始化失败。

  • ios :检查当前使用 的包名是否和生成安全图片的时候输入的包名一致,并且确保URL Types里面填写的appkey是否一致,否则一定会初始化失败。

2.拉起手机淘宝进行授权登录

plug.authLogin(res=>{
 console.log(JSON.stringify(res));  
}) 

3.获取授权登录用户信息

plug.getUserInfo(res=>{
console.log(JSON.stringify(res));
})

4.退出登录

plug.logOut(res=>{
console.log(JSON.stringify(res));
})

5.打开优惠券页面

plug.openByUrl({
 url:"我是淘客优惠券链接"
})

6.渠道备案

plug.openByQdUrl({url:"我是H5授权登录链接"},res=>{
 console.log(JSON.stringify(res));
})

7.打开店铺首页

plug.openByshop({shop_id:"我的店铺id"})

8.打开我的购物车页面

plug.openBycart()

9.打开指定商品ID

plug.openBydetail({item_id:"我是商品ID"})

六.作者QQ

在插件使用过程中有任何问题可以加我QQ:1545776613。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件自身不采集任何数据,插件使用的getutdid方法 SDK会采集手机相关信息。

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

暂无用户评论。

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问