更新记录
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 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
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');
-
插件初始化 (调用之前必须初始化)
// 先初始化插件 baichuan.init({}, result => {});
-
淘宝授权登录
baichuan.login({}, result => {
// const msg = JSON.stringify(result);
console.log(result);
});
- 退出登录
baichuan.logout({}, result => {
// const msg = JSON.stringify(result);
console.log(result);
});
- 获取用户信息
baichuan.getUserInfo({}, result => {
console.log(result);
});
- 打开商品详情(根据商品ID)
baichuan.detailPage({
"itemid": "XXXXXXXX",
"openType": 1
}, result => {
// const msg = JSON.stringify(result);
console.log(result);
});
- 打开商品详情(根据商品url)
baichuan.detailPage({
url: "https://s.click.taobao.com/KWLkWbu",
"openType": 0
}, result => {
// const msg = JSON.stringify(result);
console.log(result);
});
- 打开店铺
baichuan.shopPage({
shopid: "67907495",
"openType": 0
}, result => {
// const msg = JSON.stringify(result);
console.log(result);
});
- 检查登陆状态
baichuan.checkSession({}, result => {
// const msg = JSON.stringify(result);
console.log(result);
});
- 通过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);
});
- 通过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);
});
- 打开购物车
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单独分离开,如果没有勾选使用官方的支付宝支付,这两个文件需自行添加到目录里
- 试用期间可以跑示例工程测试