Flutter 在 2018 年可以說非常的火爆驹沿，像素級的可控性比 ReactNative 要靈活很多薄货，但是就生態(tài)而言還有很長的路要走拣度，就推送而言的相關(guān)的插件基本很少搪桂，意外的時候 JPush 居然出了官方的推送插件 jpush_flutter。 本文主要介紹在應(yīng)用中集成 jpush_flutter 這個插件描扯。
安裝
在工程 pubspec.yaml 中加入 dependencies
dependencies:
jpush_flutter: 0.0.8
配置
Android:
在 /android/app/build.gradle 中添加下列代碼：
android: {
....
defaultConfig {
applicationId "替換成自己應(yīng)用 ID"
...
ndk {
//選擇要添加的對應(yīng) cpu 類型的 .so 庫定页。
abiFilters 'armeabi', 'armeabi-v7a', 'x86', 'x86_64', 'mips', 'mips64' // 'arm64-v8a',
}
manifestPlaceholders = [
JPUSH_PKGNAME : applicationId,
JPUSH_APPKEY : "appkey", // NOTE: JPush 上注冊的包名對應(yīng)的 Appkey.
JPUSH_CHANNEL : "developer-default", //暫時填寫默認(rèn)值即可.
]
}
}
iOS:
在 xcode8 之后需要點開推送選項： TARGETS -> Capabilities -> Push Notification 設(shè)為 on 狀態(tài)
到此 jpush_flutter 的推送集成已經(jīng)完成。
什么這就完了绽诚？
是的集成推送就是這么的簡單典徊，現(xiàn)在只需要在 dart 代碼中引入：
import 'package:jpush_flutter/jpush_flutter.dart';
即可開始工作，插件具體的用法可以參考 api 文檔憔购。
One more thing.
如果只是集成教程那這篇文章就太水了宫峦，還不如看 Readme 呢岔帽。
接下來我們來深入看看 jpush_flutter 插件到底幫我們做了哪些事情玫鸟？
-
Flutter iOS 使用 Cocoapods 來集成第三方的庫， JPush iOS 原生 SDK 支持 Cocoapods 來集成犀勒，使用 pod 集成有很多的好處：
- 可以自動幫我們添加系統(tǒng)依賴庫屎飘，
- 自動將 jpush-lib.a 和 jcore-lib.a 和相關(guān)頭文件添加到工程中，
-
而且在 jcore 分離后你基本不需要關(guān)心幾個服務(wù)（jpush贾费、jmessage钦购、jshare、janalytics）之間的版本沖突
也就是說省去了手動將下面類庫添加到自己工程這繁瑣的動作了
image.png
-
Flutter android 使用 gradle 來集成第三方的庫褂萧。JPush android 支持 jcenter 的方式集成押桃，這同樣帶來了很多好處：
先看看手動集成需要做的步驟：
image.png
jpush_flutter android 插件內(nèi)部還會維護(hù)一個 AndroidManifest 將極光所需的 service 等配置添加到里面了，所有對于插件用戶來說所需要的配置就更少了导犹。
這省去了在 AndroidManifest 中添加如下配置：
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="您應(yīng)用的包名"
android:versionCode="316"
android:versionName="3.1.6"
>
<uses-sdk android:minSdkVersion="9" android:targetSdkVersion="23" />
<!-- Required -->
<permission
android:name="您應(yīng)用的包名.permission.JPUSH_MESSAGE"
android:protectionLevel="signature" />
<!-- Required -->
<uses-permission android:name="您應(yīng)用的包名.permission.JPUSH_MESSAGE" />
<uses-permission android:name="android.permission.RECEIVE_USER_PRESENT" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.WRITE_SETTINGS" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- Optional. Required for location feature -->
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" /> <!-- 用于開啟 debug 版本的應(yīng)用在 6.0 系統(tǒng)上的層疊窗口權(quán)限 -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.GET_TASKS" />
<uses-permission android:name="android.permission.VIBRATE" />
<application
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:name="Your Application Name">
<!-- Required SDK 核心功能-->
<!-- 可配置 android:process 參數(shù)將 PushService 放在其他進(jìn)程中 -->
<service
android:name="cn.jpush.android.service.PushService"
android:enabled="true"
android:exported="false" >
<intent-filter>
<action android:name="cn.jpush.android.intent.REGISTER" />
<action android:name="cn.jpush.android.intent.REPORT" />
<action android:name="cn.jpush.android.intent.PushService" />
<action android:name="cn.jpush.android.intent.PUSH_TIME" />
</intent-filter>
</service>
<!-- since 3.0.9 Required SDK 核心功能-->
<provider
android:authorities="您應(yīng)用的包名.DataProvider"
android:name="cn.jpush.android.service.DataProvider"
android:exported="true"
/>
<!-- since 1.8.0 option 可選項唱凯。用于同一設(shè)備中不同應(yīng)用的 JPush 服務(wù)相互拉起的功能。 -->
<!-- 若不啟用該功能可刪除該組件谎痢，或把 enabled 設(shè)置成 false 磕昼；拉起服務(wù)被關(guān)閉，App 不會通過拉起服務(wù)拉起其他的 App节猿，也不會被其他 App 拉起票从。 -->
<service
android:name="cn.jpush.android.service.DaemonService"
android:enabled="true"
android:exported="true">
<intent-filter >
<action android:name="cn.jpush.android.intent.DaemonService" />
<category android:name="您應(yīng)用的包名"/>
</intent-filter>
</service>
<!-- since 3.1.0 Required SDK 核心功能-->
<provider
android:authorities="您應(yīng)用的包名.DownloadProvider"
android:name="cn.jpush.android.service.DownloadProvider"
android:exported="true"
/>
<!-- Required SDK 核心功能-->
<receiver
android:name="cn.jpush.android.service.PushReceiver"
android:enabled="true" >
<intent-filter android:priority="1000">
<action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED_PROXY" />
<category android:name="您應(yīng)用的包名"/>
</intent-filter>
<intent-filter>
<action android:name="android.intent.action.USER_PRESENT" />
<action android:name="android.net.conn.CONNECTIVITY_CHANGE" />
</intent-filter>
<!-- Optional -->
<intent-filter>
<action android:name="android.intent.action.PACKAGE_ADDED" />
<action android:name="android.intent.action.PACKAGE_REMOVED" />
<data android:scheme="package" />
</intent-filter>
</receiver>
<!-- Required SDK 核心功能-->
<activity
android:name="cn.jpush.android.ui.PushActivity"
android:configChanges="orientation|keyboardHidden"
android:theme="@android:style/Theme.NoTitleBar"
android:exported="false" >
<intent-filter>
<action android:name="cn.jpush.android.ui.PushActivity" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="您應(yīng)用的包名" />
</intent-filter>
</activity>
<!-- SDK 核心功能-->
<activity
android:name="cn.jpush.android.ui.PopWinActivity"
android:configChanges="orientation|keyboardHidden"
android:exported="false"
android:theme="@style/MyDialogStyle">
<intent-filter>
<category android:name="android.intent.category.DEFAULT" />
<category android:name="您應(yīng)用的包名" />
</intent-filter>
</activity>
<!-- Required SDK 核心功能-->
<service
android:name="cn.jpush.android.service.DownloadService"
android:enabled="true"
android:exported="false" >
</service>
<!-- Required SDK 核心功能-->
<receiver android:name="cn.jpush.android.service.AlarmReceiver" />
<!-- Required since 3.0.7 -->
<!-- 新的 tag/alias 接口結(jié)果返回需要開發(fā)者配置一個自定的廣播 -->
<!-- 該廣播需要繼承 JPush 提供的 JPushMessageReceiver 類, 并如下新增一個 Intent-Filter -->
<receiver
android:name="自定義 Receiver"
android:enabled="true"
android:exported="false" >
<intent-filter>
<action android:name="cn.jpush.android.intent.RECEIVE_MESSAGE" />
<category android:name="您應(yīng)用的包名" />
</intent-filter>
</receiver>
<!-- User defined. 用戶自定義的廣播接收器-->
<receiver
android:name="您自己定義的 Receiver"
android:enabled="true"
android:exported="false">
<intent-filter>
<!--Required 用戶注冊 SDK 的 intent-->
<action android:name="cn.jpush.android.intent.REGISTRATION" />
<!--Required 用戶接收 SDK 消息的 intent-->
<action android:name="cn.jpush.android.intent.MESSAGE_RECEIVED" />
<!--Required 用戶接收 SDK 通知欄信息的 intent-->
<action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED" />
<!--Required 用戶打開自定義通知欄的 intent-->
<action android:name="cn.jpush.android.intent.NOTIFICATION_OPENED" />
<!-- 接收網(wǎng)絡(luò)變化 連接/斷開 since 1.6.3 -->
<action android:name="cn.jpush.android.intent.CONNECTION" />
<category android:name="您應(yīng)用的包名" />
</intent-filter>
</receiver>
<!-- Required. For publish channel feature -->
<!-- JPUSH_CHANNEL 是為了方便開發(fā)者統(tǒng)計 APK 分發(fā)渠道玷氏。-->
<!-- 例如: -->
<!-- 發(fā)到 Google Play 的 APK 可以設(shè)置為 google-play; -->
<!-- 發(fā)到其他市場的 APK 可以設(shè)置為 xxx-market炮姨。 -->
<meta-data android:name="JPUSH_CHANNEL" android:value="developer-default"/>
<!-- Required. AppKey copied from Portal -->
<meta-data android:name="JPUSH_APPKEY" android:value="您應(yīng)用的 Appkey"/>
</application>
</manifest>
對于 iOS 來說還有幾個坑是需要注意的：
- 必須要在 Apple Developer 給應(yīng)用配置推送功能，創(chuàng)建推送證書 （并且保證 bundle id 與 Apple developer 上的是一致的）如果之前沒有接觸過推送證書建議看視頻來 ?? 官方集成視頻
- 必須要在真機(jī)上做測試套蒂，否則無法收到推送通知太雨。
- 推送環(huán)境需要保持一致先馆，測試環(huán)境收不到生成環(huán)境的推送推送。
全文完~
「本文為極光征文參賽文章」
