Unity 下集成第三方原生 SDK,以极光厂商通道为例
Unity中集成三方SDK有两种方式:
Unity 项目开发中时常有集成 Android 第三方 SDK 的需求,比如接入第三方推送,分享等功能。而第三方 SDK 的集成文档提到的往往是基于原生 Android 项目集成。
第一种 导出 gradle 项目进行集成
导出 gradle 项目的方式可以直接将项目导入 AndroidStudio 中进行集成,而此时可以直接按照第三方集成文档完成集成。
第二种 直接在 Unity 中集成
有些公司是基于 Unity 项目结构进行自动打包的,这样导出 gradle 项目的集成方式就不适用于自动打包流程,只能直接在 Unity 项目中直接集成 SDK 才能满足需求。这时候基于原生 Android 项目的 SDK 的集成步骤对应 Unity 中就要稍作修改。
举例
本文以集成极光推送厂商通道为例介绍如何在 Unity 集成 第三方SDK。
JPush
JPush 是极光官方的推送 SDK,集成后可以通过调用 API 推送消息,并且官方提供了对应 Unity 平台使用的插件 jpush-unity3d-plugin。首先参照插件集成方式集成基础版本的JPush,这里以 JPush v3.1.6 为例,对应插件版本 v3.2.7 ,集成成功后能够成功接受后台推送,并且 Unity 对应结构:
厂商通道
极光推送 VIP 服务提供了切换包括小米,华为,魅族等各个平台厂商通道服务,切换系统级别的推送通道,提高推送送达率,详情联系商务。
注意,厂商通道集成成功的前提是基础版已经能成功收到推送。
华为通道为例
获取到对应 v3.1.6 的厂商通道文档,打开华为集成指南可以看到大致步骤:
现在我们要集成厂商通道怎么做:
- 第一种:导出 gradle 项目的集成方式,直接对应上面步骤配置即可。
- 第二种:直接在 Unity 中集成。
第一种方式就不说了,下面对应步骤介绍第二种集成方式:
1.增加华为HMS SDK的推送包及资源文件
- 将third-push/huawei/res里面的资源复制到工程/res中对应的目录
- 将third-push/huawei/libs中的包添加到工程/libs目录下。
--------------- 对应到 Unity 就是 ---------------- - 将 third-push/huawei/res 里面的资源复制到工程 plugins/android/res 中对应的目录,res 不存在就新建一个。
- 将third-push/huawei/libs中的包添加到工程plugins/android目录下,与 jpush.aar 同级。
2.增加support v4包
- JPush 3.0.9 版本后不需要添加,略过
3.修改 minSdkVersion 的值
4.配置HMS SDK Push必须的组件
5.配置接收 HMS 消息的广播接收器
6.替换 HMS 的 appid
- 这四步对应文档修改 plugin/android/AndroidManifest.xml 即可。
7.在build.gradle中配置在华为后台添加的指纹证书对应的签名 - 这步要保证你的应用签名和在华为联盟后台注册的指纹签名证书一致,请仔细检查。
走完这七步集成就结束了,对应的 Unity 结构:
然后调用推送初始化和打开 debug 模式。运行应用并查看初始化 log,系统要求 EMUI4.1 或往上,集成成功会在 log 中打印华为 token 信息。
扩展
除了上述集成方式,也可以在 AS 中新建 module 集成上述 jar 包,并打包成 aar 给 Unity 使用。极光的推送插件就是这样做的,所以可以直接下载极光插件源码,集成完直接统一打包成 aar 使用。
需要注意的是,已经是 aar 的文件无法打包,比如上述的华为通道中的 HMSSdk-agent.aar 无法打包进插件,还是得单独放在 plugin/android 下编译。