帮助与文档

> >

一、下载MobPush对应的.unitypackage包

打开 Github 下载 MobPush-For-Unity 项目,下载完成后直接双击或者在Unity里面选择打开 MobPush.unitypackage,导入相关资源和脚本到您的 Unity项目即可使用。

二、集成

注:MobPush For Unity项目对应的Android插件部分,使用的是gradle编译方式,由于gradle编译方式在Unity2017及以上版本才能很好地支持并且兼容,强烈建议广大开发者使用Unity2017及以上的版本进行开发,Unity2017以下版本集成稍微麻烦一丢丢;

所以集成核心部分分成:

(1)、新版Unity集成方式(Unity2017及以上的版本)

(2)、旧版Unity集成方式注意事项(使用Unity2017版本以下开发的必看)

一、新版Unity集成方式(建议)

关键文件mainTemplate.gradleproguard-user.txt

1、Unity2017及以上版本,在Build Settings > Player Settings下面,有两个开关,新建项目的话打开这两个开关就可以在Plugins>Android生成对应的两个文件;由于这两个文件MobPush都有直接提供,只需导入.unitypackage就好,Unity检测到已经存在这两个文件,自动会更新为勾选状态;

2、Build的时候有一个Build System选项此选项默认选择的Internal,切记要改成选择里面的gradle选项**重要**

3、图中所示的mainTemplate.gradle文件,即为集成的核心文件,使用编辑器打开此文件,要点内容如下:

此处为区分Unity5.6和Unity2017 gradle插件版本的地方,开发时用到哪个版本就使用哪个,若使用到其他Unity版本,请随意选择一个,然后build,编译的时候会报错的,Console控制台信息报错时会提示插件版本是多少,根据提示修改成需要的版本就好(只修改后面的数字,比如:2.3.0或者2.1.0)

此处为集成MobPush需要配置的信息

此处为配置签名文件和签名文件的别名和密码(正式发布apk需要的签名文件),可以写绝对路径,也可以写相对路径,相对路径使用”..\\”跳出一层目录,跳出多层则连续拼接

此处为混淆文件的配置,也就是MobPush提供的proguard-user.txt文件,此文件内容不需要更改,按照提供的即可,
如自己代码需要额外增加混淆逻辑,可自行增加混淆规则,如果是Unity2017以下版本,请把注释的代码调换一下即可;
(minifyEnabled属性为是否开启代码混淆:true为开启混淆,false为关闭)

4、挂载MobPush.cs脚本到需要使用的场景上,此时便可以调用推送的各个接口;

二、旧版Unity集成方式注意事项

1、由于Unity2017以下的版本在setting下面并不支持直接生成mainTemplate.gradle和proguard-user.txt,但是可以读取到mainTemplate.gradle文件,所以mainTemplate.gradle文件可以直接使用MobPush提供的;

2、然后混淆文件需要去Unity的安装目录下面的Editor\Data\PlaybackEngines\AndroidPlayer\Tools (Windows)路径下面,找到UnityProGuardTemplate.txt文件,这个文件就是Unity在编译gardle的时候自动替换的混淆文件;

3、把MobPush提供的proguard-user.txt文件里面的内容复制到UnityProGuardTemplate.txt文件里面,就可以了

注:UnityProGuardTemplate.txt是在每个用到gradle编译的Unity项目都会去寻找的混淆文件,谨慎修改

三、推送接口

初始化和绑定监听

其它各种接口说明:

发送本地通知,自定义本地通知样式

自定义通知栏样式

获取注册ID

添加标签

获取标签

删除标签

清除全部标签

添加别名

获取别名

清除全部别名

停止通知服务

重启通知服务

判断通知是否被停止,返回值:bool类型

点击通知后是否打开应用首页,默认为打开

四、添加混淆配置

为了防止二次混淆MobPush,需要在项目混淆文件中添加:

如果同时集成了华为、小米、魅族等渠道推送,同时也需要在项目中添加防二次混淆配置:

相关文档