帮助与文档

> >

 一、获取AppKey,AppSecret

  1. 申请MobSDK的appkey流程

二、配置gradle

1、将下面的脚本添加到您的根模块build.gradle中:

2、在使用ShopSDK模块的build.gradle中,添加MobSDK插件和扩展,如:

关于PaySDK的详细说明,请参考其集成文档。

 

三、添加代码

1、初始化MobSDK

如果您没有在AndroidManifest中设置appliaction的类名,MobSDK会将这个设置为com.mob.MobApplication,但如果您设置了,请在您自己的Application类中调用:

以初始化MobSDK。

2、调用API

ShopSDK提供两套API:有界面API和无界面API。其中有界面API只有如下一个入口,在ShopGUI类中:

方法名称 参数列表 使用说明
showShopPage(Callback callback) callback<br>操作回调,用于用户登录、登出、支付等功能逻辑处理。 进入商城,可查看商品列表、添加删除购物车、订单管理等。

 

Callback

Callback是ShopGUI的回调,包含下面3个方法:

方法名称 参数列表 使用说明
login 登录回调,在方法中进行登录操作,登录成功调用MobSDK.setUser()设置用户信息,用于商城内使用。
logout 登出回调,在方法中进行登出操作,退出成功调用MobSDK.clearUser()清除用户信息。
pay Order 待支付订单对象。

CustomizedPayListener 支付结果监听器,将支付结果回传ShopGUI。

若需使用自有支付,需将该方法返回值设为true,在方法中进行自有支付操作,并通过listener将支付结果通知ShopGUI。

若使用ShopSDK内置的MobPay支付,需将该方法返回值设为false。

用户信息缓存说明

ShopGUI不提供用户信息的持久化缓存,开发者需自行实现,建议每次启动应用时,获取当前用户信息并调用MobSDK.setUser()设置用户信息,若不设置,当前用户将处于匿名状态,除“查看商品”、“添加购物车”等个别功能外,其他功能不可用。
用户信息缓存说明

以下示例代码是ShopSDK-Demo的MainActivity在启动时(onCreate方法中)通过UMSSDK的用户系统获取当前用户信息并设置给ShopSDK的过程:

自有支付接入说明

ShopGUI支持使用ShopSDK内置的MobPay支付,也支持使用开发者的自有支付。

若使用MobPay支付,请将pay方法返回值设置为false。

若使用自有支付,需将pay方法返回值设置为true,并在方法中进行自有支付操作,最后请务必将支付结果通过CustomizedPayListener回传给ShopGUI。

若自有支付使用了微信支付,需要在配置gradle时取消对PaySDK的依赖(不引入PaySDK),否则有可能造成开发者的微信支付获取不到微信支付结果的问题。

以下示例代码是ShopSDK-Demo的MainActivity在选择使用自有支付时的处理:

四、混淆处理

ShopSDK已经做了混淆处理,再次混淆会导致不可预期的错误,请在您的混淆脚本中添加如下的配置,跳过对ShopSDK的混淆操作:

五、注意事项

1. ShopSDK默认会添加一套开源的GUI库,如果您不需要这个库,可以在ShopSDK下设置“gui false”来关闭它
2. MobSDK默认为ShopSDK提供最新版本的集成,如果您想锁定某个版本,可以在ShopSDK下设置“version “某个版本””来固定使用这个版本
3. 如果使用MobSDK的模块会被其它模块依赖,请确保依赖它的模块也引入MobSDK插件,或在此模块的gradle中添加:

非Maven集成方式点这里

1 0

相关文档