最新版阿里百川SDK对接uniapp教程超级详细 支持IOS18体系 ...

前言：制止到写这边文章的时间，目前阿里百川sdk的插件最新版为
Android 标准版：4.1.0.9；iOS标准版：4.1.0.4 以下教程围绕该版本编写。
一、使用前的预备工作

首先到 阿里百川网站 ->注册->新建应用->填写好相关应用的包名-> 获取应用的 安全图片 用于验证应用使用的合法性
二、必须要开通《 百川电商SDK 》 ，否则授权会出问题，假如不做返利模式,直接打开领券页面的可以忽略此步调

三、获取应用安全图片

• 选择本身要使用的应用,生成对应的安全图片.
  
• 目前安卓端阿里百川必要使用V6.1的安全图 IOS端使用V6.0的安全图
  
• 安卓 Android 必要上传apk 安装包来获取安全图片,apk安装包, 使用你的安卓证书, 提交云打包生成apk 安装包后,再到百川上传来获取安全图片.如包名或证书有更改 都必要重新获取安全图片,不然会初始化会失败,这里上传的时间可以直接上传空包,百川只校验署名信息
  
• ios只必要输入包名即可获取安全图
  

必要通过这个新百川地址来获取安卓6.1的安全图 https://suite.baichuan.taobao.com/#/sdk

四、插件设置

• 打开插件地址，点击试用，
  
  
  
• 选择一个要绑定的项目,然后输入APP的包名
  
  
  
  
• 在uniapp项目根目录下创建nativeplugins 插件文件夹, 主要是存放安全图和插件的其他文件,包含 ios 和 android 子目录, 插件名称:xiguazhu-baichuan 文件夹名不能修改, 具体看图片所示.
  按照图中创建文件夹
  
  
  
  

提示：

假如必要使用付出宝功能，要把插件包中的 UTDID.framework 和 utdid4all-1.5.3_proguard.jar 文件删除掉，假如不必要则保留一起打包. UTDID.framework文件和 utdid4all-1.5.3_proguard.jar文件以及整个目录可以问百川插件作者要，大概插件示例工程可以本身下载
第一种环境.

必要使用uniapp 官方的付出宝功能时百川设置阐明IOS 苹果在插件目录下保留安全图片即可:yw_1222_baichuan.jpg (名字必须叫这个)Android 安卓在插件目录下保留安全图片即可:yw_1222_baichuan.jpg (名字必须叫这个) 第二种环境.

未使用uniapp 官方的付出宝功能时百川设置阐明IOS 苹果在插件目录下保留文件: UTDID.framework +yw_1222_baichuan.jpg (名字必须叫这个)Android 安卓在插件目录下保留文件:utdid4all-1.5.3_proguard.jar + yw_1222_baichuan.jpg(名字必须叫这个)

• IOS 端唤起淘宝客户端必要特别设置下,在设置 manifest.json 文件中,找到 ios 项,参加以下代码
  

1. "ios" : {
2.                 "urltypes" : [
3.                     {
4.                         "urlschemes" : [ "tbopen32470416" ] //tbopen+您应用的AppKey
5.                     }
6.                 ],
7.                 "urlschemewhitelist" : "tbopen,tmall"
8.             }

复制代码

如下图:

urlschemes 的名称设置是 tbopen+AppKey, AppKey是百川AppKey ,一串数字,不要填错,否则会初始失败

旧版阿里百川

新版的
五、阿里百川插件方法介绍

方法名阐明login()淘宝授权登录logout()退出登录detailPage()打开淘宝任意页面shopPage()打开店铺页面OpenMyCart()打开淘宝购物车getUserInfo()获取用户授权信息checkSession()检查用户登录状态taobaoOauth()渠道授权getUtdid()获取手机设备 UTDID 唯一码 六、使用案例

1. 实例化插件 ,在必要用到插件的页面引入

1. const baichuan = uni.requireNativePlugin('xiguazhu-baichuan');

复制代码

2. 插件初始化 (调用之前必须初始化)

1. // 先初始化插件
2. baichuan.init({}, result => {});

复制代码

2.淘宝授权登录 login() , 传入参数: 无

1.         baichuan.login({},result=>{
2.                 console.log(result);                               
3.         });  

复制代码

• 授权成功后,返回数据格式
  

1. {
2.         "userinfo": {
3.                 "topAccessToken": "63001084681b15666d9b50a0f64193354e0267457c2ba7b34****",
4.                 "topExpireTime": "7776000",
5.                 "userid": "3401100915",
6.                 "avatarUrl": "https://wwc.alicdn.com/avatar/getAvatar.do?userIdStrV2=31CMmjAGPUw03*cOYWkyYNTT&type=taobao",
7.                 "openSid": "9b7b973a1ab23f0de168318640cc8199fa353b470622d8e1195394718f531f8****",
8.                 "topAuthCode": "bPDMxNN3UAEKu1cEbDrRSPhK30****",
9.                 "openId": "AAHpJD0KANVDozhKB****",
10.                 "nick": "c7****"
11.         },
12.         "code": 0,
13.         "msg": "登录成功"
14. }

复制代码

3.退出登录 logout() , 传入参数: 无

• 用户取消 返回数据
  

1. {
2.         "code": 10004,
3.         "msg": "用户取消登录"
4. }

复制代码

4.打开商品详情页 detailPage() , 打开商品详情页有两种方式

• openType=> 参数是打开的方式: 0=> 使用url打开,1=>使用ID打开
  
• itemid=> 商品 ID
  
• url=>商品链接
  

第一种,通过 商品 ID ,来打开详情页

1.            baichuan.detailPage({
2.                                            "itemid": "562161593312",
3.                                            "openType": 1
4.                                    }, result => {
6.                                    });

复制代码

第二种,通过商品链接,来打开详情页

1.    baichuan.detailPage({
2.                                                 url: "https://s.click.taobao.com/KWLkWbu",
3.                                                 "openType": 0
4.                                         }, result => {
6.                                         });

复制代码

5.打开店铺 shopPage()

• openType => 参数是打开页面的方式: 0=> 使用APP端打开
  
• shopid=> 店铺ID
  

1. baichuan.shopPage({
2.                                         shopid: "67907495",
3.                                         "openType": 0
4.                                 }, result => {
5.                                         console.log(result);
6.                                 });

复制代码

6. 打开我的购物车 shopCar()

1. baichuan.shopCar();               

复制代码

7. 检查授权登录状态,checkSession() 传入参数:无

1. baichuan.checkSession({}, result => {
2.                                                 console.log(result);
3.                                         });

复制代码

• 返回数据参数
  

1.已经登录

1. {
2.    "code": 0,
3.    "msg": "登录成功"
4. }

复制代码

2.登录失效

1. {
2.    "code": 1,
3.    "msg": "未登录"
4. }

复制代码

8.获取用户已经授权的信息,getUserInfo() 传入参数:无

1. {
2.         baichuan.getUserInfo({}, result => {
3.                                                 console.log(result);
4.                                         });
5. }

复制代码

• 返回数据参数
  

1.成功获取

1. {
2.         "userinfo": {
3.                 "topAccessToken": "63025041498269f01a2dbbe6c5448cee6122d3ed1****",
4.                 "topExpireTime": "7776000",
5.                 "userid": "3401100915",
6.                 "avatarUrl": "https://wwc.alicdn.com/avatar/getAvatar.do?userIdStrV2=31CMmjAGPUw03*cOYWkyYNTT&type=taobao",
7.                 "openSid": "af3afc198f6f4e4ea542bfb3423ee996edb3f58c84a44d1eda173d45f8ea1e6d2****",
8.                 "topAuthCode": "2qdoIZJcrf00mhyTIvF7J2****",
9.                 "openId": "AAHpJD0KANVDozhK****",
10.                 "nick": "c7****"
11.         },
12.         "code": 0,
13.         "msg": "登录成功"
14. }

复制代码

2.获取失败

1. {
2.         "code": 1,
3.         "msg": "未登录"
4. }

复制代码

9.获取用户设备 UTDID 码

1. baichuan.getUtdid(result => {
2.                                         console.log(result);
3.                                 });

复制代码

• 返回数据
  

1. {
2.         "utdid": "YSRqDyGmBjADADi5****"
3. }

复制代码

九、淘宝渠道授权阐明(返利功能必要用到渠道ID跟踪订单的)

1. H5 使用 code 方式授权

1. https://oauth.taobao.com/authorize?response_type=code&client_id=2948****&redirect_uri=http://你的域名/&state=1212&view=wap

复制代码

把网址中的参数，更换成本身的即可.

1. baichuan.taobaoOauth({
2.                                      "url": "https://oauth.taobao.com/authorize?response_type=code&client_id=294****&redirect_uri=http://你的域名/&state=1212&view=wap"
3.                                              }, result => {
4.                                                      console.log(result);
5.                                              });

复制代码

链接获取授权码参数

参数名字参数选项参数值参数释义client_id必选联盟媒体keyresponse_type必选coderedirect_uri必选拜见redirect_uri的界说state必选传入值与返回值保持同等。view必选默以为web移动端 wap 1.授权成功 返回参数:

1. 暂无

复制代码

2. 其他的返回

1. 暂无

复制代码

2. H5 使用 token 方式授权(保举使用)

授权网址

1. https://oauth.taobao.com/authorize?response_type=token&client_id=2948****&state=1212&view=wap

复制代码

链接获取授权码参数

参数名字参数选项参数值参数释义client_id必选联盟媒体keyresponse_type必选tokenstate必选传入值与返回值保持同等。view必选默以为web移动端 wap 1.授权成功 返回参数:

1. {
2.         "info": {
3.                 "expires_in": "2592000",
4.                 "taobao_open_uid": "AAEAWObHANZeVL1YKsd****",
5.                 "r1_expires_in": "1800",
6.                 "w2_expires_in": "0",
7.                 "refresh_token": "6101303057813b26f0954a9a5acd7194fff62be3e9390493****",
8.                 "access_token": "6101d0302741aab1596335b19cee233835e8641e285b5****",
9.                 "state": "1212",
10.                 "top_sign": "59C789C51A82C6D1F6DEAB9375****",
11.                 "taobao_user_id": "3401100****",
12.                 "taobao_user_nick": "c7****",
13.                 "w1_expires_in": "1800",
14.                 "re_expires_in": "2592000",
15.                 "r2_expires_in": "0",
16.                 "token_type": "Bearer"
17.         },
18.         "code": 0,
19.         "msg": "授权成功"
20. }

复制代码

2. 其他的返回

1. 无

复制代码

注意事项

• 安卓的安全图要使用v6.1版本的，申请地址https://suite.baichuan.taobao.com
  
• 只要设置精确，淘宝登录和渠道授权都是面输入密码的，假如必要输入密码，请检查安全图
  
• 修改安全图后必要重新打包，原生插件的改动，都必要打包
  
• 示例工程里已经将安卓的utdid4all-1.5.3_proguard.jar和IOS端的UTDID.framework单独分离开，假如没有勾选使用官方的付出宝付出，这两个文件需自行添加到目录里
  
• 试用期间可以跑示例工程测试
  
• 新版本的HX打包时间，必要关闭res混淆，否则拉不起手淘，https://doc.dcloud.net.cn/uni-app-x/collocation/manifest.html#enableresourceoptimizations
  

uniapp 原生插件如何使用，可以参考这个：https://ask.dcloud.net.cn/article/36106
拉起手淘失败,一样平常是安全图片的问题，更新安全图片之后再尝试一下

有不懂的可以加微 shenlailai6 咨询，
加挚友备注csdn阿里百川咨询,否则不通过
作者简介:从事淘客行业多年~

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。