Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cpunion/react-native-mipush
https://github.com/cpunion/react-native-mipush
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/cpunion/react-native-mipush
- Owner: cpunion
- Created: 2016-05-12T14:37:02.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-01-12T08:58:25.000Z (about 8 years ago)
- Last Synced: 2024-11-30T19:52:22.773Z (about 2 months ago)
- Language: Java
- Size: 44.9 MB
- Stars: 13
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-react-native - react-native-mipush ★13 - MiPush for React Native (Components / System)
- awesome-react-native - react-native-mipush ★13 - MiPush for React Native (Components / System)
- awesome-react-native - react-native-mipush ★13 - MiPush for React Native (Components / System)
- awesome-react-native - react-native-mipush ★13 - MiPush for React Native (Components / System)
- awesome-react-native-ui - react-native-mipush ★8 - MiPush for React Native (Components / System)
README
小米 Push 的 React Native 封装。
* 非官方发布。
# 安装
```
npm install --save react-native-mipush
rnpm link react-native-mipush
```
## Android
* 在 rnpm link 的基础上对 MainActivity.java 做以下修改:
```
// ...
public class MainActivity extends ReactActivity {
private MiPushPackage mMiPushPackage; <---- 添加
@Override
protected void onCreate(Bundle savedInstanceState) {
mMiPushPackage = new MiPushPackage(this); <---- 添加
super.onCreate(savedInstanceState);
}
@Override
protected void onNewIntent(Intent intent) { <---- 添加这个方法
super.onNewIntent(intent);
setIntent(intent);
mMiPushPackage.onIntent(intent);
}
// ...
@Override
protected List getPackages() {
return Arrays.asList(
new MainReactPackage(),
mMiPushPackage, // <------ 修改自动生成的 new MiPushPackage
// ...
```
* AndroidManafest.xml 中修改 application 的 android:name 为 `com.xiaomi.push.reactnative.MiPushApplication`，并添加你的 MIPUSH_APP_ID 和 MIPUSH_APP_KEY：
**注意：由于小米的 AppID 和 AppKey 都是纯数字，需要在前面加上 `\ ` 来转义！**
```
```
## iOS
Info.plist 用文本编辑器打开，添加以下代码：
```
MiSDKAppID
1000888 <---- 替换为自己的
MiSDKAppKey
500088888888 <---- 替换为自己的
MiSDKRun
Online <---- Online 表示正式环境，Debug 表示 Sandbox 环境
```
AppDelegate.m 添加以下代码
```
#import "RCTMiPush.h"
// ...
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
// ...
NSDictionary *initialProperties = [RCTMiPush initAndGetInitialPropertiesFromLaunchOptions:launchOptions];
// ...
RCTRootView *rootView =
[[RCTRootView alloc] initWithBundleURL:jsCodeLocation
moduleName:@"RNTest"
initialProperties:initialProperties // <-- 修改这里
launchOptions:launchOptions];
// ...
}
// 添加以下这些代码
#pragma mark UIApplicationDelegate
- (void)application:(UIApplication *)app didFailToRegisterForRemoteNotificationsWithError:(NSError *)err
{
// 注册APNS失败
[RCTMiPush didFailToRegisterForRemoteNotificationsWithError:err];
}
- (void)application:(UIApplication *)application didRegisterUserNotificationSettings:(UIUserNotificationSettings *)notificationSettings
{
[RCTMiPush didRegisterUserNotificationSettings:notificationSettings];
}
// Required for the register event.
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken
{
[RCTMiPush didRegisterForRemoteNotificationsWithDeviceToken:deviceToken];
}
// Required for the notification event.
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)notification
{
[RCTMiPush didReceiveRemoteNotification:notification];
}
// Required for the localNotification event.
- (void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification
{
[RCTMiPush didReceiveLocalNotification:notification];
}
```
# JS 中使用
**由于目前还没有对 iOS 和 Android 版本做接口统一，所以两个平台有所区别，以后版本有可能修改为统一接口。**
## 1.引入模块
```
import MiPush from 'react-native-mipush'
```
## 2.获取启动参数，用于响应点击 Push 消息跳转到应用内
方法1：
```
MiPush.getInitialMessage()
.then((message) => {
console.log('===== initial push:', message)
})
```
方法2: 通过根 Component 的 props 获取
## 3.启动后点击的新消息
```
DeviceEventEmitter.addListener("xiaomipush", this._handlePush)
```
两个平台参数没有统一，目前需要自己分别处理。
## 4.启动 Push 代码
Android: 已经在 application 中启动
iOS:
```
MiPush.registerMiPushAndConnect(true, 0)
```
# 接口文档
待写。
# 限制
由于 React Native 的 JS 代码只有 UI 在前台时才可执行，所以在 Activity 在前台时能够处理所有消息，不在前台时只能处理点击打开界面的通知栏消息。
# License
MIT.