JPush's officially supported React Native plugin (Android & iOS). 极光推送官方支持的 React Native 插件(Android & iOS)。
Last updated Jun 18, 2026
1.4k
Stars
351
Forks
163
Issues
0
Stars/day
Attention Score
91
Language breakdown
Java 31.7%
JavaScript 21.2%
Objective-C 20.8%
Python 16.1%
Objective-C++ 3.6%
Swift 3.1%
▸ Files
click to expand
README
JPush-React-Native
ChangeLog
- 从RN-JPush2.7.5开始,重新支持TypeScript
- 由于RN-JCore1.6.0存在编译问题,从RN-JCore1.7.0开始,还是需要在AndroidManifest.xml中添加配置代码,具体参考 配置-2.1 Android
1. 安装
npm install jpush-react-native --save
- 注意:如果项目里没有jcore-react-native,需要安装
npm install jcore-react-native --save
安装完成后连接原生库
进入到根目录执行react-native link
或
react-native link jpush-react-native
react-native link jcore-react-native
2. 配置
2.1 Android
- build.gradle
android {
defaultConfig {
applicationId "yourApplicationId" //在此替换你的应用包名
...
manifestPlaceholders = [
JPUSH_APPKEY: "yourAppKey", //在此替换你的APPKey
JPUSH_CHANNEL: "yourChannel" //在此替换你的channel
]
}
}
dependencies {
...
implementation project(':jpush-react-native') // 添加 jpush 依赖
implementation project(':jcore-react-native') // 添加 jcore 依赖
}
- setting.gradle
include ':jpush-react-native'
project(':jpush-react-native').projectDir = new File(rootProject.projectDir, '../node_modules/jpush-react-native/android')
include ':jcore-react-native'
project(':jcore-react-native').projectDir = new File(rootProject.projectDir, '../node_modules/jcore-react-native/android')
- AndroidManifest.xml (从插件3.2.6版本开始,不需要配置该内容)
<meta-data
android:name="JPUSH_CHANNEL"
android:value="${JPUSH_CHANNEL}" />
<meta-data
android:name="JPUSH_APPKEY"
android:value="${JPUSH_APPKEY}" />
2.2 iOS
注意:您需要打开ios目录下的.xcworkspace文件修改您的包名2.2.1 pod
pod install
- 注意:如果项目里使用pod安装过,请先执行命令
pod deintegrate
2.2.2 手动方式
- Libraries
Add Files to "your project name"
node_modules/jcore-react-native/ios/RCTJCoreModule.xcodeproj
node_modules/jpush-react-native/ios/RCTJPushModule.xcodeproj
- Capabilities
Push Notification --- ON
- Build Settings
All --- Search Paths --- Header Search Paths --- +
$(SRCROOT)/../node_modules/jcore-react-native/ios/RCTJCoreModule/
$(SRCROOT)/../node_modules/jpush-react-native/ios/RCTJPushModule/
- Build Phases
libz.tbd
libresolv.tbd
UserNotifications.framework
libRCTJCoreModule.a
libRCTJPushModule.a
3. 引用
3.1 Android
3.2 iOS
3.3 js
参考:App.js
4. API
详见:index.js
5. 其他
- 集成前务必将example工程跑通
- 如有紧急需求请前往极光社区
- 上报问题还麻烦先调用JPush.setLoggerEnable(true},拿到debug日志
🔗 More in this category