帮助与文档

> >

一、Android 快速集成

首先申请appkey,请点击这里

二、在项目中添加SDK

i. 将MobLink-{version}.jar,MobCommons.jar,MobTools.jar添加到项目libs文件夹中。

注意:version 指SDK的版本号。MobCommons.jar与MobTools.jar是Mob 所有SDK的通用库(如果您用过ShareSDK, 那您一定不陌生)。

如下图所示:

三、 配置Android ManiFest.xml文件

i.添加相应的权限, 设置Application为MobApplication,也可设置成MobApplication的子类。在其中添加MobLink的Appkey:

 

ii.添加activity的URL Scheme信息和App Links,在需要场景还原的activity中添加下面的配置:

 

注意:

1、scheme一定要写,配置的scheme必须跟后台配置的一致,否则会导致无法跳转到应用。

2、App Links配置的host是后台自动生成的,您可以从后台管理界面获取。

例如:官网Demo Android端配置如下:

例如:官网Demo 管理后台配置如下:

项目中需要配置的URL Scheme是用于场景恢复时跳转到应用中的。所配置的scheme务必与后台填写的一致,参考下图:

注意:对App Links的支持是从SDK版1.1.0开始的,如果您使用的低版本SDK请升级。这里的App Links指的是Android原生提供的App Links,不是指的FaceBook提供App Links SDK。如果您还没有了解过App Links,可参考Android官方文档:https://developer.android.com/training/app-links/index.html,若链接失效请自行搜索。

 

四、添加代码

i. 让需要场景还原的activity实现SceneRestorable接口。像这样:

并在重写接口定义的方法,实现场景还原功能。像这样:

ii.获取MobId用于分享,场景数据还原监听会根据MobId还原相关数据,代码如下:

 

参数说明

参数 类型 不可为空 默认值 说明 额外
path String 路径 一般用于不同界面间做路由选择
source String 来源标识 可用于在场景还原时辨别来源
params HashMap null 额外参数 在场景还原时能够重新得到

返回值说明

参数 类型 不可为空 默认值 说明 额外
mobid String mobid 作为path、source、params的隐含表示

生成的mobid可用于拼接到需要进行推广的链接后,例如:http://www.abc.com?mobid=123456,

注意:该网站页面必须集成了JS模块的代码(下文将说明),方可实现网页-应用无缝接合。

备注:如果您的页面参数固定,则可以将获取到的这个mobid缓存起来,不用每次都去获取新的mobid以节约时间成本。

到此,最简单的MobLink就集成好了,在场景还原时,场景参数会完整的返回;如果您想了解更多,可参考api文档。

 

五、关于SDK初始化的特殊说明

 

SDK初始化有两种方式:

1. 通过AndroidManifest配置Application为MobApplication或者其子类

2. 通过代码配置, 在您Application的onCreate方法中,增加如下代码

以上两种方式任选其一即可,但我们强烈建议您使用第一种方式进行初始化, 它会帮助您减少很多工作量。

六、添加混淆

七、web端集成(点击跳转)

 

3 9

相关文档