更新记录

2.3(2025-03-31)

支持ios 18的系统 SDK更新到 Android   标准版:4.1.0.9;iOS标准版:4.1.0.4

2.1(2024-12-14)

安卓端百川sdk更新到 4.1.0.7版本,安卓端百川图片请使用6.1版本,另外打包时关闭res资源混淆,否则会提示初始化是吧 https://doc.dcloud.net.cn/uni-app-x/collocation/manifest.html#enableresourceoptimizations

2.0(2023-08-30)

IOS和安卓都需要初始化了 另外安卓升级到utdid4all-1.5.3_proguard.jar 稍后会更新文件 初始化参考这个 1.9的版本 https://blog.csdn.net/shenlailai/article/details/131001904

查看更多

平台兼容性

Android Android CPU类型 iOS
适用版本区间:4.4 - 14.0 armeabi-v7a:支持,arm64-v8a:支持,x86:未测试 适用版本区间:9 - 17

原生插件通用使用流程:

  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原生插件配置”->”云端插件“列表中删除该插件重新选择


新手必读

  • 百川插件2.3版本正在提交审核,2.3版本对应Android   标准版:4.1.0.9;iOS标准版:4.1.0.4
  • 当插件页面版本显示2.3,代表插件市场审核成功
  • 以下教程以及案例均是根据最新2.3版本编写
  • 此插件作者也在使用,能兼容大多数人的需求,不像其他插件一样,作者自己不使用,平时也不会及时更新;如果要评论咨询,请五星好评咨询
  • 插件支持免费试用,试用满意后在购买,试用不满意的不要购买,市场没有退款机制。
  • 此版本兼容ios18系统

版本说明

  • 20250304-v2.3 支持ios18,sdk更新 Android   标准版:4.1.0.9;iOS标准版:4.1.0.4

SDK使用流程以及封装的方法

先引入插件

const baichuan = uni.requireNativePlugin('xiguazhu-baichuan');
  1. 插件初始化 (调用之前必须初始化)

    // 先初始化插件
    baichuan.init({}, result => {});
  2. 淘宝授权登录

baichuan.login({}, result => {
    // const msg = JSON.stringify(result);
    console.log(result);
});
  1. 退出登录
 baichuan.logout({}, result => {
    // const msg = JSON.stringify(result);
    console.log(result);
});
  1. 获取用户信息
baichuan.getUserInfo({}, result => {
    console.log(result);
});
  1. 打开商品详情(根据商品ID)
baichuan.detailPage({
    "itemid": "XXXXXXXX",
    "openType": 1
}, result => {
    // const msg = JSON.stringify(result);
    console.log(result);
});
  1. 打开商品详情(根据商品url)
baichuan.detailPage({
    url: "https://s.click.taobao.com/KWLkWbu",
    "openType": 0
}, result => {
    // const msg = JSON.stringify(result);
    console.log(result);
});
  1. 打开店铺
baichuan.shopPage({
    shopid: "67907495",
    "openType": 0
}, result => {
    // const msg = JSON.stringify(result);
    console.log(result);
});
  1. 检查登陆状态
baichuan.checkSession({}, result => {
    // const msg = JSON.stringify(result);
    console.log(result);
});
  1. 通过token授权
baichuan.taobaoOauth({
    "url": "https://oauth.taobao.com/authorize?response_type=token&client_id=29487613&state=1212&view=wap"
}, result => {
    // const msg = JSON.stringify(result);
    console.log(result);
});
  1. 通过code授权
baichuan.taobaoOauth({
    "url": "https://oauth.taobao.com/authorize?response_type=code&client_id=29487613&redirect_uri=http://admin.xxxxx.com/oauth/&state=1212&view=wap"
}, result => {
    // const msg = JSON.stringify(result);
    console.log(result);
});
  1. 打开购物车
baichuan.shopCar();

一般大家的需求都是让用户做渠道授权后,拿到用户的rid,然后做订单追踪,那么只需要调用这两个即可(具体的授权业务逻辑参考百川以及淘宝)

baichuan.login({}, result => {
    baichuan.taobaoOauth({
        "url": "https://oauth.taobao.com/authorize?response_type=token&client_id=29487613&state=1212&view=wap"
    }, result => {
// const msg = JSON.stringify(result);
        console.log(result);
    });
});

注意事项

  • 安卓的安全图要使用v6.1版本的,申请地址https://suite.baichuan.taobao.com
  • 只要配置正确,淘宝登录和渠道授权都是面输入密码的,如果需要输入密码,请检查安全图
  • 修改安全图后需要重新打包,原生插件的改动,都需要打包
  • 示例工程里已经将安卓的utdid4all-1.5.3_proguard.jar和IOS端的UTDID.framework单独分离开,如果没有勾选使用官方的支付宝支付,这两个文件需自行添加到目录里
  • 试用期间可以跑示例工程测试

隐私、权限声明

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

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

插件本身不采集数据,插件使用的 阿里百川会采集数据,详情参考:https://baichuan.taobao.com/docs/doc.htm?treeId=129&articleId=118101&docType=1 ,百川本身不提供隐私政策和协议。请自行在自己的隐私政策协议中说明。

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

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