帮助与文档

> >

一、申请APPkey

首先申请appkey,请点击这里

二、配置gradle

1、打开项目根目录的build.gradle,在buildscrip–>dependencies 模块下面添加 classpath 'com.mob.sdk:MobSDK:2018.0319.1724',如下所示;

buildscript {
    repositories {
        jcenter()
    }

    dependencies {
        ...
        classpath 'com.mob.sdk:MobSDK:2018.0319.1724'
    }
}

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

// 添加插件
apply plugin: 'com.mob.sdk'

// 在MobSDK的扩展中注册MobLink的相关信息
MobSDK {
    appKey "d580ad56b4b5"
    appSecret "7fcae59a62342e7e2759e9e397c82bdd"
    MobLink {
        uriScheme "您后台配置的scheme"
        appLinkHost "您后台开启AppLink时生成的Host"

        // 若使用经典版,需打开该设置,否则默认为专业版
        // preferClassicalEdition true
    }
}

三、调用SDK功能

MobLink的主要功能在制作场景和还原场景,下面将分别细述其使用方法:

1、制作场景

可使用下面的方式来获取MobLink的场景ID:`MobId`,并将其用于分享。在场景数据还原时MobLink会根据MobId还原出场景数据,并回调用户进行特定的操作:

// 设置场景参数
HashMap senceParams = new HashMap();
senceParams.put("key1", "value1");
senceParams.put("key2", "value2");
senceParams.put("key3", "value3");

// 新建场景
Scene s = new Scene();
s.path = "/demo/a";
s.params = senceParams;

// 请求场景ID
MobLink.getMobID(s, new ActionListener() {
    public void onResult(String mobID) {
        // TODO 根据mobID进行分享等操作
    }
    	
    public void onError(Throwable throwable) {
        // TODO 处理错误结果
    }
});

2、还原场景

2-1、增加全局场景还原监听器【可选,可在后台配置】

class SceneListener extends Object implements RestoreSceneListener {

   @Override
   public Class<? extends Activity> willRestoreScene(Scene scene) {
       // 在发现场景时回调. <br/>
       // return !null 将跳转到对应Activity; return null 依据path从服务器查询对应处理Activity.
      return null;
   }

   @Override
   public void notFoundScene(Scene scene) {
       // 未找到处理scene的activity时回调
   }

   @Override
   public void completeRestore(Scene scene) {
      // 在"拉起"处理场景的Activity之后调用
   }
}
MobLink.setRestoreSceneListener(new SceneListener());

2-2、修改Activity的代码,添加场景还原事件回调方法

让需要场景还原的activity实现SceneRestorable接口,并重写其onNewIntent()方法。像这样:

public class RestoreSenceActivity extends Activity implements SceneRestorable {
   @Override
   public void onReturnSceneData(Scene scene) {
      // 处理场景还原数据, 可以在这里做更新画面等操作
   }

   @Override
   // 必须重写该方法,防止MobLink在某些情景下无法还原
   protected void onNewIntent(Intent intent) {
	super.onNewIntent(intent);
	setIntent(intent);
	MobLink.updateNewIntent(getIntent(), this);
   }
}

 

2-3、进入Mob开发者后台,填写“基础配置”
如下图,为应用添加URI Scheme,专业版本的App Links是Mob后台自动生成的,这和经典版有所不同,经典版的APP Links是需要您自己手动配置。


请注意,scheme是必填的,且scheme和host的配置必须跟gradle里配置的一致,否则会导致无法跳转到应用。

四、微信小程序还原场景

MobLink v2.2.0版本开始全平台支持微信小程序,支持一键唤起app,支持参数互传,使用方式如下:

4-1、获取微信小程序原始ID

在分享到微信小程序之前,我们需要先获取到微信小程序的原始ID,登录微信公众平台,在微信小程序的设置 – 基本设置 – 账号信息下面就可以找到微信小程序的原始ID了,如下图:

提示:微信小程序要关联到微信开放平台才能分享的哦!

4-2、分享微信小程序

分享到小程序的方法和所需要配置的参数,如果是用的ShareSDK可以参考这里 微信分享的详细参数

4-3、从微信小程序中打开app

完成上述步骤之后客户端就搞定了,下面在微信小程序里按照 MobLink 微信小程序集成文档 配置好微信小程序即可!!

五、混淆设置

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

-keep class com.mob.**{*;}
-dontwarn com.mob.**

六、注意事项

1. MobSDK默认为MobLink提供最新版本的集成,如果您想锁定某个版本,可以在`MobLink`下设置“version "某个版本"”来固定使用这个版本
2. 如果使用MobSDK的模块会被其它模块依赖,请确保依赖它的模块也引入MobSDK插件,或在此模块的gradle中添加:

repositories {
    jcenter()
}

相关文档