阿里百川电商SDK(3.1)接入与使用

Blog: reezy.me/2016-12-20/…
简书: www.jianshu.com/p/e8d1fad84…

接入

接入准备

参考
baichuan.taobao.com/docs/doc.ht…

1. 申请百川无线应用
2. 下载安全图片
3. 开通业务产品的使用权限
4. 使用优惠券组件

添加安全图片

将安全图片放在/res/drawable目录下&＃xff0c;如果已经有安全图片&＃xff0c;就替换。

Gradle配置

repositories { maven { url "http://repo.baichuan-android.taobao.com/content/groups/BaichuanRepositories/" }
}
dependencies {// 授权登陆 (MemberSDK)compile &＃39;com.ali.auth.sdk:alibabauth_core:1.2.4&＃64;jar&＃39;compile &＃39;com.ali.auth.sdk:alibabauth_ui:1.2.4&＃64;aar&＃39;compile &＃39;com.ali.auth.sdk:alibabauth_ext:1.2.4&＃64;jar&＃39;// fastjsoncompile &＃39;com.alibaba:fastjson:1.2.9&＃39;// 基础电商组件(AlibcTradeSDK, AlibcTrade, AlibcLogin)// 包含打开detail,淘客分润,jsbridge注入等功能compile &＃39;com.alibaba.sdk.android:alibc_trade_sdk:3.1.1.20&＃64;aar&＃39;// 集成支付宝(可选)compile &＃39;com.alibaba.alipay:alipaySingle:20160825&＃64;jar&＃39;// 组件可用性统计compile &＃39;com.alibaba.mtl:app-monitor-sdk:2.5.1_for_bc&＃39;// 基础安全组件compile &＃39;com.taobao.android:securityguardaar3:5.1.96&＃64;aar&＃39;// 网关compile &＃39;com.taobao.android:mtopsdk_allinone_open:1.3.0&＃64;jar&＃39;// 手机淘宝与三方app之间的往返跳转compile &＃39;com.taobao.android:alibc_applink:2.0.0.9&＃64;jar&＃39;// deviceID&＃xff0c;主要用于计算设备的uttid&＃xff0c; 设备唯一标识compile &＃39;com.taobao.android:utdid4all:1.1.5&＃39;
}

Proguard 规则

-keepattributes Signature
-keep class sun.misc.Unsafe { ; }
-keep class com.taobao.* {*;}
-keep class com.alibaba.** {*;}
-keep class com.alipay.** {*;}
-dontwarn com.taobao.**
-dontwarn com.alibaba.**
-dontwarn com.alipay.**
-keep class com.ut.** {*;}
-dontwarn com.ut.**
-keep class com.ta.** {*;}
-dontwarn com.ta.**
-keep class org.json.** {*;}
-keep class com.ali.auth.** {*;}

使用电商SDK(3.1)

初始化

在应用的入口方法&＃xff08;比如Application的onCreate&＃xff09;中初始化百川SDK

AlibcTradeSDK.asyncInit(this, new AlibcTradeInitCallback() {&＃64;Overridepublic void onSuccess() {// 初始化成功&＃xff0c;设置相关的全局配置参数// 是否使用支付宝AlibcTradeSDK.setShouldUseAlipay(true);// 设置是否使用同步淘客打点AlibcTradeSDK.setSyncForTaoke(true);// 是否走强制H5的逻辑&＃xff0c;为true时全部页面均为H5打开AlibcTradeSDK.setForceH5(true);// 设置全局淘客参数&＃xff0c;方便开发者用同一个淘客参数&＃xff0c;不需要在show接口重复传入AlibcTradeSDK.setTaokeParams(taokeParams)// 设置渠道信息(如果有渠道专享价&＃xff0c;需要设置)AlibcTradeSDK.setChannel(typeName, channelName)// ...}&＃64;Overridepublic void onFailure(int code, String msg) {//初始化失败&＃xff0c;可以根据code和msg判断失败原因&＃xff0c;详情参见错误说明}
});

资源销毁

在使用完成后&＃xff0c;可以调用destroy方法&＃xff0c;释放百川相应的资源引用

AlibcTradeSDK.destroy();

显示电商页面

实例化页面参数(必填)

// 商品详情&＃xff0c;支持itemId和openItemId的商品&＃xff0c;必填&＃xff0c;不允许为null
AlibcBasePage page &＃61; new AlibcDetailPage(itemId);// 店铺&＃xff0c;店铺id&＃xff0c;支持明文id
AlibcBasePage page &＃61; new AlibcShopPage(shopId);// 添加购物车&＃xff0c;支持itemId和openItemId的商品&＃xff0c;必填&＃xff0c;不允许为null&＃xff1b;
AlibcBasePage page &＃61; new AlibcAddCartPage(itemId)// 我的订单
// status 默认跳转页面(0:全部, 1:待付款, 2:待发货, 3:待收货, 4:待评价)
// allOrder 为 true 显示所有订单&＃xff0c;为false只显示通过当前app下单的订单
AlibcBasePage page &＃61; new AlibcMyOrdersPage(status, allOrder);// 我的购物车
AlibcBasePage page &＃61; new AlibcMyCartsPage();// URL
AlibcBasePage page &＃61; new AlibcPage(taokeUrl);

设置参数并并使用自定义webview打开页面

[注意]&＃xff1a;当传入webviewClient&＃xff0c;并重载shouldOverrideUrlLoading方法时&＃xff0c;遇到淘系链接情况下(即访问淘宝、天猫、登录、购物车等页面时)&＃xff0c;该方法返回值要为false&＃xff0c;否则可能会出现业务流程错误问题。


// 页面打开方式
AlibcShowParams params &＃61; new AlibcShowParams(OpenType.Native, isNeedPush);
// 淘宝客参数
AlibcTaokeParams taoke &＃61; new AlibcTaokeParams(pid, unionId, subId);
// 提供给三方传递配置参数
Map extras &＃61; new HashMap<>(); // activity, page, callback 为必填
AlibcTrade.show(activity, webView, webViewClient, webChromeClient, page, params, taoke, extras, new AlibcTradeCallback() {&＃64;Overridepublic void onTradeSuccess(TradeResult tradeResult) {//打开电商组件&＃xff0c;用户操作中成功信息回调。tradeResult&＃xff1a;成功信息&＃xff08;结果类型&＃xff1a;加购&＃xff0c;支付&＃xff1b;支付结果&＃xff09;}&＃64;Overridepublic void onFailure(int code, String msg) {//打开电商组件&＃xff0c;用户操作中错误信息回调。code&＃xff1a;错误码&＃xff1b;msg&＃xff1a;错误信息}
});

使用默认webview打开页面

AlibcTrade.show(context, page, params, taoke, extras, callback);

登陆授权(1.2.5)

电商SDK已经集成登陆授权
在电商SDK初始化时&＃xff0c;会自动初始化登陆授权

自动触发登陆

在电商SDK打开的页面中&＃xff0c;在需要时会自动触发调用登陆授权SDK

手动触发登陆

通过 AlibcLogin.showLogin 方法可以手动调起登陆

AlibcLogin.getInstance().showLogin(activity, new AlibcLoginCallback() {&＃64;Overridepublic void onSuccess() { // }&＃64;Overridepublic void onFailure(int code, String message) {}
});

接收登陆/登出结果

为了正常接收登陆/登出的结果&＃xff0c;需要重写传入的 activity 的 onActivityResult 方法

&＃64;Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) { CallbackContext.onActivityResult(this, requestCode, resultCode, data);
}

设置全局登陆回调

目前电商SDK里的 AlibcLogin 还未提供该功能
只能通过 MemberSDK 获取 LoginService 可以设置全局登陆回调

LoginService service &＃61; (LoginService)MemberSDK.getService(LoginService.class)
service.setLoginCallback(new LoginCallback(){&＃64;Overridepublic void onSuccess(Session session) { // }&＃64;Overridepublic void onFailure(int code, String message) {}
})

错误码

public class KernelMessageConstants {public static final int GENERIC_SYSTEM_ERROR &＃61; 10010;public static final int SERVER_REQUEST_FAILED &＃61; 15;public static final int SERVICE_NOT_AVAILABLE_ERROR &＃61; 17;
}public class SystemMessageConstants extends KernelMessageConstants {public static final int JS_BRIDGE_MODULE_NOT_FOUND &＃61; 10000;public static final int USER_CANCEL_CODE &＃61; 10003;public static final int H5_LOGIN_FAILURE &＃61; 10101;public static final int TAOBAO_CANCEL_CODE &＃61; 10004;public static final int TAOBAO_ERROR_CODE &＃61; 10005;public static final int JS_BRIDGE_METHOD_NOT_FOUND &＃61; 951;public static final int JS_BRIDGE_ANNOTATION_NOT_PRESENT &＃61; 952;public static final int NET_WORK_ERROR &＃61; 10099;public static final int NPE_ERROR &＃61; 10098;
}

一些坑

在Dialog中打开页面

由于 dialog 会给 context 包上一层 ContextThemeWrapper, 而与 dialog 交互时 sdk 可能会从其中的 view 获取 context 然后转成 activity 这时就会出现异常导致崩溃。

一个解决办法是使用 LayoutInflater.from(activity) 来 inflate 对话框的布局

【bug】在授权或支付页面返回(failure)时会把传入的activity关闭(finish)

打开页面时必需传入一个activity&＃xff0c;传入的activity被关闭&＃xff0c;这通常不是期望的效果

通过重载传入的activity.finish方法可以临时解决

目前官方文档上使用的sdk版本 3.1.0.7 有这个问题&＃xff0c;更新到 3.1.1.20 已经没有此问题

【bug】AlibcTrade 的默认 WebViewClient.shouldInterceptRequest 方法的逻辑错误

alibc_trade_sdk 包的 com.alibaba.baichuan.android.trade.c.b.b 类
它的 shouldInterceptRequest 方法如下

打开页面时我们传入的WebViewClient会被这个类代理

public WebResourceResponse shouldInterceptRequest(WebView var1, String var2) {return VERSION.SDK_INT > 23 && this.a !&＃61; null && this.a.get() !&＃61; null?((WebViewClient)this.a.get()).shouldInterceptRequest(var1, var2):super.shouldInterceptRequest(var1, var2);
}

这个方法是用于API LEVEL <21 的&＃xff0c;然而 VERSION.SDK_INT > 23 这个错误的判断导致原本应该被执行的代码未执行

4.x 的设备都会因此bug产生各种问题

参考

阿里百川 SDK 官方文档
baichuan.taobao.com/docs/doc.ht…

3.1SDK 常见问题补充
baichuan.bbs.taobao.com/detail.html…

常见错误码
baichuan.taobao.com/docs/doc.ht…

SG error:XXX错误码
baichuan.taobao.com/docs/doc.ht…

客户端SDK常见问题
baichuan.taobao.com/docs/doc.ht…