接入
接入準(zhǔn)備
- 申請百川無線應(yīng)用
- 下載安全圖片
- 開通業(yè)務(wù)產(chǎn)品的使用權(quán)限
- 使用優(yōu)惠券組件
添加安全圖片
將安全圖片放在/res/drawable目錄下且轨，如果已經(jīng)有安全圖片倍谜，就替換劣欢。
Gradle配置
repositories {
maven { url "http://repo.baichuan-android.taobao.com/content/groups/BaichuanRepositories/" }
}
dependencies {
// 授權(quán)登陸 (MemberSDK)
compile 'com.ali.auth.sdk:alibabauth_core:1.2.4@jar'
compile 'com.ali.auth.sdk:alibabauth_ui:1.2.4@aar'
compile 'com.ali.auth.sdk:alibabauth_ext:1.2.4@jar'
// fastjson
compile 'com.alibaba:fastjson:1.2.9'
// 基礎(chǔ)電商組件(AlibcTradeSDK, AlibcTrade, AlibcLogin)
// 包含打開detail,淘客分潤,jsbridge注入等功能
compile 'com.alibaba.sdk.android:alibc_trade_sdk:3.1.1.11@aar'
// 集成支付寶(可選)
compile 'com.alibaba.alipay:alipaySingle:20160825@jar'
// 組件可用性統(tǒng)計
compile 'com.alibaba.mtl:app-monitor-sdk:2.5.1_for_bc'
// 基礎(chǔ)安全組件
compile 'com.taobao.android:securityguardaar3:5.1.96@aar'
// 網(wǎng)關(guān)
compile 'com.taobao.android:mtopsdk_allinone_open:1.3.0@jar'
// 手機(jī)淘寶與三方app之間的往返跳轉(zhuǎn)
compile 'com.taobao.android:alibc_applink:2.0.0.9@jar'
// deviceID，主要用于計算設(shè)備的uttid扁凛， 設(shè)備唯一標(biāo)識
compile 'com.taobao.android:utdid4all:1.1.5'
}
Proguard 規(guī)則
-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)
初始化
在應(yīng)用的入口方法（比如Application的onCreate）中初始化百川SDK
AlibcTradeSDK.asyncInit(this, new AlibcTradeInitCallback() {
@Override
public void onSuccess() {
// 初始化成功，設(shè)置相關(guān)的全局配置參數(shù)
// 是否使用支付寶
AlibcTradeSDK.setShouldUseAlipay(true);
// 設(shè)置是否使用同步淘客打點
AlibcTradeSDK.setSyncForTaoke(true);
// 是否走強(qiáng)制H5的邏輯，為true時全部頁面均為H5打開
AlibcTradeSDK.setForceH5(true);
// 設(shè)置全局淘客參數(shù)冤今，方便開發(fā)者用同一個淘客參數(shù)，不需要在show接口重復(fù)傳入
AlibcTradeSDK.setTaokeParams(taokeParams)
// 設(shè)置渠道信息(如果有渠道專享價茂缚，需要設(shè)置)
AlibcTradeSDK.setChannel(typeName, channelName)
// ...
}
@Override
public void onFailure(int code, String msg) {
//初始化失敗戏罢，可以根據(jù)code和msg判斷失敗原因，詳情參見錯誤說明
}
});
資源銷毀
在使用完成后脚囊，可以調(diào)用destroy方法龟糕，釋放百川相應(yīng)的資源引用
AlibcTradeSDK.destroy();
顯示電商頁面
實例化頁面參數(shù)(必填)
// 商品詳情，支持itemId和openItemId的商品悔耘，必填讲岁，不允許為null
AlibcBasePage page = new AlibcDetailPage(itemId);
// 店鋪，店鋪id，支持明文id
AlibcBasePage page = new AlibcShopPage(shopId);
// 添加購物車缓艳，支持itemId和openItemId的商品校摩，必填，不允許為null阶淘；
AlibcBasePage page = new AlibcAddCartPage(itemId)
// 我的訂單
// status 默認(rèn)跳轉(zhuǎn)頁面(0:全部, 1:待付款, 2:待發(fā)貨, 3:待收貨, 4:待評價)
// allOrder 為 true 顯示所有訂單衙吩，為false只顯示通過當(dāng)前app下單的訂單
AlibcBasePage page = new AlibcMyOrdersPage(status, allOrder);
// 我的購物車
AlibcBasePage page = new AlibcMyCartsPage();
// URL
AlibcBasePage page = new AlibcPage(taokeUrl);
設(shè)置參數(shù)并并使用自定義webview打開頁面
[注意]：當(dāng)傳入webviewClient，并重載shouldOverrideUrlLoading方法時溪窒，遇到淘系鏈接情況下(即訪問淘寶坤塞、天貓、登錄澈蚌、購物車等頁面時)摹芙，該方法返回值要為false，否則可能會出現(xiàn)業(yè)務(wù)流程錯誤問題宛瞄。
// 頁面打開方式
AlibcShowParams params = new AlibcShowParams(OpenType.Native, isNeedPush);
// 淘寶客參數(shù)
AlibcTaokeParams taoke = new AlibcTaokeParams(pid, unionId, subId);
// 提供給三方傳遞配置參數(shù)
Map<String, String> extras = new HashMap<>();
// activity, page, callback 為必填
AlibcTrade.show(activity, webView, webViewClient, webChromeClient, page, params, taoke, extras, new AlibcTradeCallback() {
@Override
public void onTradeSuccess(TradeResult tradeResult) {
//打開電商組件浮禾，用戶操作中成功信息回調(diào)。tradeResult：成功信息（結(jié)果類型：加購坛悉，支付伐厌；支付結(jié)果）
}
@Override
public void onFailure(int code, String msg) {
//打開電商組件，用戶操作中錯誤信息回調(diào)裸影。code：錯誤碼挣轨；msg：錯誤信息
}
});
使用默認(rèn)webview打開頁面
AlibcTrade.show(context, page, params, taoke, extras, callback);
登陸授權(quán)(1.2.4)
電商SDK已經(jīng)集成登陸授權(quán)
在電商SDK初始化時，會自動初始化登陸授權(quán)
自動觸發(fā)登陸
在電商SDK打開的頁面中轩猩，在需要時會自動觸發(fā)調(diào)用登陸授權(quán)SDK
手動觸發(fā)登陸
通過 AlibcLogin.showLogin 方法可以手動調(diào)起登陸
AlibcLogin.getInstance().showLogin(activity, new AlibcLoginCallback() {
@Override
public void onSuccess() {
//
}
@Override
public void onFailure(int code, String message) {
}
});
接收登陸/登出結(jié)果
為了正常接收登陸/登出的結(jié)果卷扮，需要重寫傳入的 activity 的 onActivityResult 方法
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
CallbackContext.onActivityResult(this, requestCode, resultCode, data);
}
設(shè)置全局登陸回調(diào)
目前電商SDK里的 AlibcLogin 還未提供該功能
只能通過 MemberSDK 獲取 LoginService 可以設(shè)置全局登陸回調(diào)
LoginService service = (LoginService)MemberSDK.getService(LoginService.class)
service.setLoginCallback(new LoginCallback(){
@Override
public void onSuccess(Session session) {
//
}
@Override
public void onFailure(int code, String message) {
}
})
錯誤碼
public class KernelMessageConstants {
public static final int GENERIC_SYSTEM_ERROR = 10010;
public static final int SERVER_REQUEST_FAILED = 15;
public static final int SERVICE_NOT_AVAILABLE_ERROR = 17;
}
public class SystemMessageConstants extends KernelMessageConstants {
public static final int JS_BRIDGE_MODULE_NOT_FOUND = 10000;
public static final int USER_CANCEL_CODE = 10003;
public static final int H5_LOGIN_FAILURE = 10101;
public static final int TAOBAO_CANCEL_CODE = 10004;
public static final int TAOBAO_ERROR_CODE = 10005;
public static final int JS_BRIDGE_METHOD_NOT_FOUND = 951;
public static final int JS_BRIDGE_ANNOTATION_NOT_PRESENT = 952;
public static final int NET_WORK_ERROR = 10099;
public static final int NPE_ERROR = 10098;
}
一些坑
在Dialog中打開頁面
由于 dialog 會給 context 包上一層 ContextThemeWrapper, 而與 dialog 交互時 sdk 可能會從其中的 view 獲取 context 然后轉(zhuǎn)成 activity 這時就會出現(xiàn)異常導(dǎo)致崩潰。
一個解決辦法是使用 LayoutInflater.from(activity) 來 inflate 對話框的布局
【bug】在授權(quán)或支付頁面返回(failure)時會把傳入的activity關(guān)閉(finish)
打開頁面時必需傳入一個activity均践，傳入的activity被關(guān)閉晤锹，這通常不是期望的效果
通過重載傳入的activity.finish方法可以臨時解決
目前官方文檔上使用的sdk版本 3.1.0.7 有這個問題，更新到 3.1.1.11 已經(jīng)沒有此問題
【bug】AlibcTrade 的默認(rèn) 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 != null && this.a.get() != null?((WebViewClient)this.a.get()).shouldInterceptRequest(var1, var2):super.shouldInterceptRequest(var1, var2);
}
這個方法是用于API LEVEL < 21 的彤委，然而 VERSION.SDK_INT > 23 這個錯誤的判斷導(dǎo)致原本應(yīng)該被執(zhí)行的代碼未執(zhí)行
4.x 的設(shè)備都會因此bug產(chǎn)生各種問題
參考
阿里百川 SDK 官方文檔
http://baichuan.taobao.com/docs/doc.htm?spm=a3c0d.7629140.0.0.fZiJXS&treeId=129&articleId=105645&docType=1
3.1SDK 常見問題補(bǔ)充
https://baichuan.bbs.taobao.com/detail.html?spm=a3c0d.7971500.0.0.OkQc3n&postId=7215938
SG error:XXX錯誤碼
http://baichuan.taobao.com/docs/doc.htm?spm=a3c0d.7629140.0.0.AjAmY2&treeId=129&articleId=103222&docType=1
