帮助与文档

> >

一、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:

<uses-permission android:name="android.permission.GET_TASKS" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

<application
    android:name="com.mob.MobApplication"
    android:debuggable="true"
    android:icon="@drawable/moblink_icon"
    android:label="@string/app_name"
    android:theme="@style/AppTheme"
    tools:ignore="HardcodedDebugMode">
    <meta-data android:name="Mob-AppKey" android:value="您的Appkey"/>
</application>

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

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="您的URL Scheme" />
</intent-filter>

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

例如:官网Demo中添加的配置如下:

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

iii.App Links支持

注意:对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,若链接失效请自行搜索。

在处理App Links的Activity中增加如下配置:

<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT"/>
    <category android:name="android.intent.category.BROWSABLE"/>
    <data android:scheme="http" android:host="70r9.ulml.mob.com" />
    <data android:scheme="https" android:host="70r9.ulml.mob.com" />
</intent-filter>

这里的host是后台自动生成的,您可以从后台管理界面获取,像这样:

四、添加代码

i.设置全局的场景还原监听器,一般是在Application里设置。像这样:

@Override
public void onCreate() {
   super.onCreate();

   // 设置场景还原监听器
   MobLink.setRestoreSceneListener(new AbstractRestoreSceneListener() {

      @Override
      public void onReturnSceneData(Activity activity, final HashMap<String, Object> result) {
         // 处理场景还原数据, 更新画面
      }
   });
}

ii.当需要场景还原的activity为singleTop或singleTask的启动模式时,需要在系统回调方法onNewIntent()中将intent设置为新收到的intent,MobLink需要根据启动intent判断程序是否通过scheme启动,新增如下处理。示例代码如下:

@Override
protected void onNewIntent(Intent intent) {
   super.onNewIntent(intent);
   setIntent(intent);
}

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

public static void getMobID(HashMap<String, Object> params, String path, String source, ActionListener listener)

参数说明

参数 类型 不可为空 默认值 说明 额外
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或者其子类

<application
    android:name="com.mob.MobApplication">
</application>

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

MobSDK.init(this);

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

 

六、Web快速集成

在后台找到JS引入模块,点击“复制”来复制代码内容。如下图所示:

随后直接在页面引入文件,并且调用初始化方法。代码如下:

<script type="text/javascript" id="-moblink-js" src="//192.168.43.125:8080/moblink.js?appkey=您的Appkey"></script>
<script type="text/javascript">
    MobLink.init();
</script>

详细参数内容请参阅:Web高级功能

相关文档