阿里百川電商SDK(3.1)接入與使用

接入

接入準(zhǔn)備

參考
http://baichuan.taobao.com/docs/doc.htm?spm=a3c0d.7629140.0.0.L4aY7V&treeId=129&articleId=105645&docType=1

  1. 申請(qǐng)百川無線應(yīng)用
  2. 下載安全圖片
  3. 開通業(yè)務(wù)產(chǎn)品的使用權(quán)限
  4. 使用優(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,淘客分潤(rùn),jsbridge注入等功能
    compile 'com.alibaba.sdk.android:alibc_trade_sdk:3.1.1.11@aar'
    // 集成支付寶(可選)
    compile 'com.alibaba.alipay:alipaySingle:20160825@jar'
    // 組件可用性統(tǒng)計(jì)
    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，主要用于計(jì)算設(shè)備的uttid， 設(shè)備唯一標(biāo)識(shí)
    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è)置是否使用同步淘客打點(diǎn)
        AlibcTradeSDK.setSyncForTaoke(true);
        
        // 是否走強(qiáng)制H5的邏輯，為true時(shí)全部頁面均為H5打開
        AlibcTradeSDK.setForceH5(true);
        
        // 設(shè)置全局淘客參數(shù)，方便開發(fā)者用同一個(gè)淘客參數(shù)，不需要在show接口重復(fù)傳入
        AlibcTradeSDK.setTaokeParams(taokeParams)
        
        // 設(shè)置渠道信息(如果有渠道專享價(jià)，需要設(shè)置)
        AlibcTradeSDK.setChannel(typeName, channelName)

        // ...
    }

    @Override
    public void onFailure(int code, String msg) {
        //初始化失敗，可以根據(jù)code和msg判斷失敗原因，詳情參見錯(cuò)誤說明
    }
});

資源銷毀

在使用完成后，可以調(diào)用destroy方法，釋放百川相應(yīng)的資源引用

AlibcTradeSDK.destroy();

顯示電商頁面

實(shí)例化頁面參數(shù)(必填)

// 商品詳情，支持itemId和openItemId的商品，必填，不允許為null
AlibcBasePage page = new AlibcDetailPage(itemId);
 
// 店鋪，店鋪id，支持明文id
AlibcBasePage page = new AlibcShopPage(shopId);
 
// 添加購(gòu)物車，支持itemId和openItemId的商品，必填，不允許為null；
AlibcBasePage page = new AlibcAddCartPage(itemId)
 
// 我的訂單
// status   默認(rèn)跳轉(zhuǎn)頁面(0:全部, 1:待付款, 2:待發(fā)貨, 3:待收貨, 4:待評(píng)價(jià))
// allOrder 為 true 顯示所有訂單，為false只顯示通過當(dāng)前app下單的訂單 
AlibcBasePage page = new AlibcMyOrdersPage(status, allOrder);
 
// 我的購(gòu)物車
AlibcBasePage page = new AlibcMyCartsPage();
     
// URL
AlibcBasePage page = new AlibcPage(taokeUrl);

設(shè)置參數(shù)并并使用自定義webview打開頁面

[注意]：當(dāng)傳入webviewClient，并重載shouldOverrideUrlLoading方法時(shí)，遇到淘系鏈接情況下(即訪問淘寶、天貓、登錄、購(gòu)物車等頁面時(shí))，該方法返回值要為false，否則可能會(huì)出現(xiàn)業(yè)務(wù)流程錯(cuò)誤問題。


// 頁面打開方式
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é)果類型：加購(gòu)，支付；支付結(jié)果）
    }
 
    @Override
    public void onFailure(int code, String msg) {
        //打開電商組件，用戶操作中錯(cuò)誤信息回調(diào)。code：錯(cuò)誤碼；msg：錯(cuò)誤信息
    }
});

使用默認(rèn)webview打開頁面

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

登陸授權(quán)(1.2.4)

電商SDK已經(jīng)集成登陸授權(quán)
在電商SDK初始化時(shí)，會(huì)自動(dòng)初始化登陸授權(quán)

自動(dòng)觸發(fā)登陸

在電商SDK打開的頁面中，在需要時(shí)會(huì)自動(dòng)觸發(fā)調(diào)用登陸授權(quán)SDK

手動(dòng)觸發(fā)登陸

通過 AlibcLogin.showLogin 方法可以手動(dòng)調(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) {

    }
})

錯(cuò)誤碼

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 會(huì)給 context 包上一層 ContextThemeWrapper, 而與 dialog 交互時(shí) sdk 可能會(huì)從其中的 view 獲取 context 然后轉(zhuǎn)成 activity 這時(shí)就會(huì)出現(xiàn)異常導(dǎo)致崩潰。

一個(gè)解決辦法是使用 LayoutInflater.from(activity) 來 inflate 對(duì)話框的布局

【bug】在授權(quán)或支付頁面返回(failure)時(shí)會(huì)把傳入的activity關(guān)閉(finish)

打開頁面時(shí)必需傳入一個(gè)activity，傳入的activity被關(guān)閉，這通常不是期望的效果

通過重載傳入的activity.finish方法可以臨時(shí)解決

目前官方文檔上使用的sdk版本 3.1.0.7 有這個(gè)問題，更新到 3.1.1.11 已經(jīng)沒有此問題

【bug】AlibcTrade 的默認(rèn) WebViewClient.shouldInterceptRequest 方法的邏輯錯(cuò)誤

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

打開頁面時(shí)我們傳入的WebViewClient會(huì)被這個(gè)類代理

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);
}

這個(gè)方法是用于API LEVEL < 21 的，然而 VERSION.SDK_INT > 23 這個(gè)錯(cuò)誤的判斷導(dǎo)致原本應(yīng)該被執(zhí)行的代碼未執(zhí)行

4.x 的設(shè)備都會(huì)因此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

常見錯(cuò)誤碼
http://baichuan.taobao.com/docs/doc.htm?spm=a3c0d.7629140.0.0.SjH1Xf&treeId=129&articleId=104308&docType=1

SG error:XXX錯(cuò)誤碼
http://baichuan.taobao.com/docs/doc.htm?spm=a3c0d.7629140.0.0.AjAmY2&treeId=129&articleId=103222&docType=1

客戶端SDK常見問題
http://baichuan.taobao.com/docs/doc.htm?spm=a3c0d.7629140.0.0.LQayyc&treeId=129&articleId=102553&docType=1

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容