推送已经是是手机应用的基本功能,如果自己实现一套推送系统费时费力,所有一般我们会使用第三方的推送服务,这里我使用「极光推送」作为集成推送的例子,因为有现成的 react native 插件 jpush-react-native 可以使用。
在完成上面的准备工作后,我们就可以正式开始插件的集成,这里会解释每个步骤背后都做了哪些操作。 按照官方的集成说明安装 jpush-react-native (这里使用最新版本 V1.5.0)
npm install jpush-react-native --save
安装完后可以看到 package.json 的 dependencies 字段多了 "jpush-react-native" 依赖
npm install jcore-react-native --save
安装完后可以看到 package.json 的 dependencies 字段多了 "jcore-react-native" 依赖。 由于极光开发者服务 SDK 采用了模块化的使用模式,即一个核心( JCore )+N 种服务( JPush , JAnalytics ,...)的使用方式,所以把公共核心代码分离出来,这样在使用极光推送多种服务的时候不会出现冲突。
react-native link
这个步骤,其实是吧 jpush plugin 工程添加到 自己的项目工程里面,可以看到 Libraries 目录多了一个 RCTJPushModule.xcodeproj 工程文件,如下图所示
同时这个步骤还会自动把 JPush 所依赖的库自动添加到工程中,可以看到 TARGETS -> Build phases -> Link Binary With Libraries 多了几个系统库,如下图所示
这些步骤都是自动完成的,不需要额外的操作。 然后把 其中一个库 UserNotification.framework status 设为 Optional
jpush-react-native 插件提供了自动配置脚本
npm run configureJPush <yourAppKey> <yourModuleName>
把 <yourappkey> 换成自己的 AppKey (在极光官网上创建应用可以获得一个 Appkey) <yourmodulename> 指的是你 Android 项目中的模块名字(对 iOS 没有影响,不填写的话默认值为 app ,会影响到查找 AndroidManifest 问题。
这个脚本会自动吧极光推送的代码插入到 Appdelegate.m 中。 到这一步 jpush-react-native 插件已经集成完毕。 我们试着这编译自己工程,如果出现找不到头文件的情况则需要在 iOS 工程中如果找不到头文件可能要在 TARGETS-> BUILD SETTINGS -> Search Paths -> Header Search Paths 添加如下如路径
$(SRCROOT)/../node_modules/jpush-react-native/ios/RCTJPushModule/RCTJPushModule
手动添加代码部分 jpusn-react-native ReadMe 已经说得很清楚了,这里就不再重复~
作者: HuminiOS - 极光( JPush 为极光团队账号,欢迎关注)
知乎专栏:极光日报