帮助与文档

> >

介绍

ShopSDK是一套完整的商城系统解决方案,开发者通过接入ShopSDK可以快速实现自己的商城APP。ShopSDK除提供商城系统的核心接口外,同时提供了ShopGUI供开发者选用,以免去APP界面的开发。本文详细介绍ShopSDK的集成方法。

获取AppKey

申请MobSDK的appkey流程

下载SDK

点击进入下载页面

SDK集成

文件说明

解压下载的压缩文件得到SDK相关工程,其中:

MobDependency:Mob公共库(必须)

ShopGUI:开源GUI库(可选)

ShopSDK:ShopSDK核心库(必须)

Eclipse版集成

将上述lib工程分别导入Eclipse中,并设置工程间的依赖关系:

ShopSDK依赖于MobDependency:

ShopGUI依赖于ShopSDK:

你的工程依赖ShopGUI(若不使用ShopGUI,则直接依赖至ShopSDK即可):

Android Studio版集成

将ShopSDK的相关lib工程拷贝至你的工程目录下,并设置依赖关系:

(1)project/settings.gradle:

说明:

上述ShopSDK-Demo为示例工程,UMSDK是为ShopSDK-Demo提供用户系统,并非ShopSDK的内容,开发者可以使用自己的用户系统,若没有自己的用户系统,也可以选择接入Mob平台的UMSSDK,UMSSDK请至Mob官网下载。

UMSSDK下载地址

UMSSDK集成文档

(2)app modulus/build.gradle:

代码集成

在AndroidManifest.xml中添加以下内容:

(1)添加权限:

(2)添加支付功能所需Activity:

注意:以上(1)(2)的内容位于ShopSDK/AndroidManifest.xml中,由于Android Studio有自动merge manifest的功能,Android Studio版开发者可以不用重复配置于自己工程的AndroidManifest.xml中,而Eclipse版开发者则必须在自己的AndroidManifest.xml中配置,并且请做以下修改:

改为:

(3)添加MobUIShell(仅在使用ShopGUI时需要添加):

注意:以上(3)的内容位于ShopGUI/AndroidManifest.xml中,由于Android Studio有自动merge manifest的功能,Android Studio版开发者可以不用重复配置于自己工程的AndroidManifest.xml中,而Eclipse版开发者则必须在自己的AndroidManifest.xml中配置。

SDK初始化

1.配置Mob-AppKey和Mob-AppSecret:

ShopSDK提供两种方式配置Mob-AppKey和Mob-AppSecret,任选其一即可,建议使用方式一。

方式一 —— 通过AndroidManifest.xml配置:

(1)在Application节点下添加以下属性:

注意:如果你有自己的Application类,那么也可以让你的Application类继承MobApplication即可。

(2)在Application节点下添加以下meta-data:

方式二 —— 通过代码配置:

如果选择通过代码配置,则不需要继承MobApplication,只要在使用ShopSDK之前,调用以下代码(一般在Application的onCreate方法或MainActivity的onCreate方法中执行):

2.向ShopSDK设置用户信息:

无论是否有GUI界面,ShopSDK内部都需要一个用户对象,该用户通常是由开发者调用相关接口设置给ShopSDK的,若不设置,则当前用户将处于匿名状态,除“查看商品”、“添加购物车”等个别接口外,其余接口都无法访问。

ShopSDK不提供用户系统,这需要开发者自行实现,在使用ShopSDK时,开发者应该在用户每次登录了个人帐号后,都调用以下接口设置用户信息给ShopSDK(否则用户将处于匿名状态):

在每次用户登出后,应该调用以下接口清空用户信息:

通常,MobSDK.setUser()方法的调用时机有以下几种:

(1)应用启动,获取到当前用户信息后(有用户缓存功能的应用);

(2)用户在应用中进行了登录操作后;

(3)ShopGUI的Callback的login()回调中,处理用户登录操作后;

混淆处理

若开发者打开了混淆,请添加如下混淆规则至proguard-project.txt:

至此,ShopSDK的集成工作已经全部完成,开发者已经可以使用ShopSDK提供的各项功能了。关于如何使用,有GUI版和无GUI版具体使用方法不同,请分别参考相关说明文档。

有GUI版接口说明文档

无GUI版接口说明文档

 

0 0