淘宝开放平台

登录
文档中心 > 电商组件接入文档

Android_组件_1_0

更新时间：2016/09/13 访问次数：2344

百川电商组件1.0接入-Android

总览


电商组件，提供给三方开发者便捷电商能力，目前提供 优惠券组件，具有领取和查询功能。

Android SDK 集成


Gradle接入方式（3.1+ 版本支持）

1， 获得安全图片（图片获取方式见接入准备文档），并放在/res/drawable目录下，如果已经有安全图片，需要替换。

2， 老用户升级，请先删除原来的所有jar & aar依赖，包括alisdk-kernel, alisdk-kernel-base, alisdk-login, alisdk-rpc, alisdk-security, alisdk-system, alisdk-ui, nbsdk-trade等。

3， Gradle配置

在整个项目的gradle基础配置文件中加入仓库地址

allprojects { repositories { jcenter() maven { url "http://repo.baichuan-android.taobao.com/content/groups/BaichuanRepositories/" } } }

在项目module的gradle文件中加入相关依赖

```

dependencies {
    //fastjson
    compile 'com.alibaba:fastjson:1.2.9'

    //支付
    compile 'com.alibaba.alipay:alipaySingle:20160819@jar'

    //登陆
    compile 'com.ali.auth.sdk:alibabauth_core:1.0.9.7@jar'
    compile 'com.ali.auth.sdk:alibabauth_ui:1.0.9.7@aar'
    compile 'com.ali.auth.sdk:alibabauth_ext:1.0.9.7@jar'
    //【可选】仅供特殊合作伙伴使用
    compile 'com.ali.auth.sdk:alibabauth_accountlink:1.0.9.7@jar'

    //安全基础
    compile 'com.taobao.android:securityguardaar3:5.1.81@aar'
    //【可选】安全高级，如使用了发放红包、优惠券高级功能，则必须引入
    compile 'com.taobao.android:securitybodyaar3:5.1.20@aar'

    //Mtop网关
    compile 'com.taobao.android:mtopsdk_allinone_open:1.2.2.4@jar'

    //applink
    compile 'com.taobao.android:alibc_applink:2.0.0.2@jar'

    //UT
    compile 'com.taobao.android:utdid4all:1.1.5@jar'
    compile 'com.alibaba.mtl:app-monitor-sdk:2.5.1_for_bc@aar'

    //电商SDK
    compile 'com.alibaba.sdk.android:alibc_trade_sdk:3.1.0.5@aar'

    //电商组件 
    compile 'com.alibaba.sdk.android:alibc_trade_container:1.0.0.3@a
}

```

Maven接入方式 （3.1+ 版本支持）

1， 获得安全图片（图片获取方式见接入准备文档），并放在/res/drawable目录下，如果已经有安全图片，需要替换。

2， 老用户升级，请先删除原来的所有jar & aar依赖，包括alisdk-kernel, alisdk-kernel-base, alisdk-login, alisdk-rpc, alisdk-security, alisdk-system, alisdk-ui, nbsdk-trade等。

3， pom 配置

<!--fastjson-->
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>fastjson</artifactId>
        <version>1.2.9</version>
        <type>jar</type>
    </dependency>
    
    <!--支付-->
    <dependency>
        <groupId>com.alibaba.alipay</groupId>
        <artifactId>alipaySingle</artifactId>
        <version>20160819</version>
        <type>jar</type>
    </dependency>
    
    <!--登陆-->
    <dependency>
        <groupId>com.ali.auth.sdk</groupId>
        <artifactId>alibabauth_core</artifactId>
        <version>1.0.9.7</version>
        <type>jar</type>
    </dependency>
    
    <dependency>
        <groupId>com.ali.auth.sdk</groupId>
        <artifactId>alibabauth_ui</artifactId>
        <version>1.0.9.7</version>
        <type>aar</type>
    </dependency>
    
    <dependency>
        <groupId>com.ali.auth.sdk</groupId>
        <artifactId>alibabauth_ext</artifactId>
        <version>1.0.9.7</version>
        <type>jar</type>
    </dependency>
    
    //【可选】仅供特殊合作伙伴使用
    <dependency>
        <groupId>com.ali.auth.sdk</groupId>
        <artifactId>alibabauth_accountlink</artifactId>
        <version>1.0.9.7</version>
        <type>jar</type>
    </dependency>
    
    <!--安全基础-->
    <dependency>
        <groupId>com.taobao.android</groupId>
        <artifactId>securityguardaar3</artifactId>
        <version>5.1.81</version>
        <type>aar</type>
    </dependency>
    
    <!--【可选】安全高级，如使用了发放红包、优惠券高级功能，则必须引入-->
    <dependency>
        <groupId>com.taobao.android</groupId>
        <artifactId>securitybodyaar3</artifactId>
        <version>5.1.20</version>
        <type>aar</type>
    </dependency>
    
    <!--网关-->
    <dependency>
        <groupId>com.taobao.android</groupId>
        <artifactId>mtopsdk_allinone_open</artifactId>
        <version>1.2.2.4</version>
    </dependency>
    
    <!--AppLink-->
    <dependency>
        <groupId>com.taobao.android</groupId>
        <artifactId>alibc_applink</artifactId>
        <type>jar</type>
        <version>2.0.0.2</version>
    </dependency>
    
    <!--UT-->
    <dependency>
        <groupId>com.taobao.android</groupId>
        <artifactId>utdid4all</artifactId>
        <version>1.1.5</version>
    </dependency>
    
    <dependency>
        <groupId>com.alibaba.mtl</groupId>
        <artifactId>app-monitor-sdk</artifactId>
        <version>2.5.1_for_bc</version>
        <type>aar</type>
    </dependency>
    
    <!--电商SDK-->
    <dependency>
        <groupId>com.alibaba.sdk.android</groupId>
        <artifactId>alibc_trade_sdk</artifactId>
        <version>3.1.0.5</version>
        <type>aar</type>
    </dependency>
    
    <!--电商组件 -->
    <dependency>
        <groupId>com.alibaba.sdk.android</groupId>
        <artifactId>alibc_trade_container</artifactId>
        <version>1.0.0.3</version>
        <type>aar</type>
    </dependency>

aar 接入方式

1， 获得安全图片（图片获取方式见接入准备文档），并放在/res/drawable目录下，如果已经有安全图片，需要替换。

2， 老用户升级，请先删除原来的所有jar & aar依赖，包括alisdk-kernel, alisdk-kernel-base, alisdk-login, alisdk-rpc, alisdk-security, alisdk-system, alisdk-ui, nbsdk-trade等。

3， 下载电商SDK Libs，解压，将电商SDK的aar，jar，导入工程。

4， Android Studio用户，需要配置build.gradle

```
repositories {
flatDir {
dirs ‘libs’
}
}

dependencies {
    //fastjson
    compile(name: 'fastjson-1.2.9', ext: 'jar')

    //支付
    compile(name: 'alipaySingle-20160819', ext: 'jar')

    //登陆
    compile(name: 'alibabauth_core-1.0.9.7', ext: 'jar')
    compile(name: 'alibabauth_ui-1.0.9.7', ext: 'aar')
    compile(name: 'alibabauth_ext-1.0.9.7', ext: 'jar')
    //【可选】仅供特殊合作伙伴使用
    compile(name: 'alibabauth_accountlink-1.0.9.7', ext: 'jar') 

    //安全基础
    compile(name: 'securityguardaar3-5.1.81', ext: 'aar')
    //【可选】安全高级，如使用了发放红包、优惠券高级功能，则必须引入
    compile(name: 'securitybodyaar3-5.1.20', ext: 'aar')

    //Mtop网关
    compile(name: 'mtopsdk_allinone_open-1.2.2.4', ext: 'jar')

    //applink
    compile(name: 'alibc_applink-2.0.0.2', ext: 'jar')

    //UT
    compile(name: 'utdid4all-1.1.5', ext: 'jar')
    compile(name: 'app-monitor-sdk-2.5.1_for_bc', ext: 'aar')

    //电商SDK
    compile(name: 'alibc_trade_sdk-3.1.0.5', ext: 'aar')

    //电商组件 
    compile(name: 'alibc_trade_container-1.0.0.3', ext: 'aar')
}

```

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.** {*;}


快速入门

初始化

//注册AlibcContainerEventListener，电商组件事件监听.
    AlibcContainerEventListener lisener = new AlibcContainerEventListener() {
    
        @Override
        public void onEvent(int eventId, Object eventParams) {
            //eventID = [AlibcContainerEventType.SDK_INIT_SUCCESS, AlibcContainerEventType.SDK_INIT_ERROR]      
        }
    }；
    AlibcContainerEventManager.registListener(lisener);

    //初始化want组件运行环境
    AlibcContainer.init(context);

资源销毁

AlibcContainerEventManager.unregistListener(lisener);
    AlibcContainer.destroy();

优惠券领取

AlibcBaseComponent couponComponent = AlibcContainer.getComponentByType(AlibcComponentType.COUPON);

    AlibcGetCouponParams couponParams = new AlibcGetCouponParams();

    //设置相关领取参数，具体参见AlibcGetCouponParams介绍

    couponComponent.execute(couponParams, new AlibcComponentCallback() {
        @Override
        public void onSuccess(Object msg) {
            //成功回调
        }

        @Override
        public void onError(String errno, String errmsg) {
           //失败回调    
        }
    });

优惠券查询

AlibcBaseComponent couponComponent = AlibcContainer.getComponentByType(AlibcComponentType.COUPON);
    
    AlibcQueryCouponParams couponParams = new AlibcQueryCouponParams();

    //设置相关查询参数，具体参见AlibcQueryCouponParams介绍

    couponComponent.execute(couponParams, new AlibcComponentCallback() {
        @Override
        public void onSuccess(Object msg) {
            //成功回调
        }

        @Override
        public void onError(String errno, String errmsg) {
           //失败回调    
        }
    });

优惠劵查询成功结果返回Json字符串，说明如下：

名称 类型 描述
personLimit String 领券限制
sendCount String 已发送数量
Discount String 优惠券面额
supplierId String 卖家的用户ID
UUID String 优惠券ID
startTime String 优惠券有效期限
endTime String 优惠券有效期限
couponType String 优惠券类型 0是店铺券，1是商品券
StartFee String 优惠券使用门槛
Status String 优惠券状态
Title String 优惠券title
totalCount String 优惠券总数量

加购

AlibcBaseComponent cartComponent = AlibcContainer.getComponentByType(AlibcComponentType.CART)
 
    AlibcCartParams cartParam = new AlibcCartParams()
    
    //设置相关查询参数，具体参见AlibcCartParams介绍

    cartComponent.execute(cartParam, new AlibcComponentCallback() {
        @Override
        public void onSuccess(Object msg) {
            //成功回调
        }

        @Override
        public void onError(String errno, String errmsg) {
           //失败回调    
        }
    });

API说明

获取组件

// 根据组件类型 获取组件（AlibcComponentType）
    AlibcContainer.getComponentByType(AlibcComponentType.COUPON);

    //组件类型
    AlibcComponentType.COUPON 优惠券组件

优惠券领取参数类（AlibcGetCouponParams）

名称 类型 描述
supplierId Long 卖家的用户ID
UUID String ActivityID.即优惠券ID：能标明领取优惠券唯一性的参数
couponInstanceSource int source id,渠道ID。需申请
asac String 安全码。需申请
ybhpss Map 必传的字段：subplat、page、cpid、cntid、puid、pguid

优惠券查询参数类（AlibcQueryCouponParams）

暂时不需要参数传递

加购参数类（AlibcCartParams）

名称 类型 描述
itemID String 宝贝ID
tips String 商品名称（可以为空）
taokeParam Map 淘客参数
ybhpss Map 必传的字段：subplat、page、cpid、cntid、puid、pguid

FAQ

关于此文档暂时还没有FAQ
有用(0) 我要提问
返回
顶部