diff --git a/document/Android_detail_api.md b/API/Android_detail_api.md
similarity index 76%
rename from document/Android_detail_api.md
rename to API/Android_detail_api.md
index 8956404..01041b7 100644
--- a/document/Android_detail_api.md
+++ b/API/Android_detail_api.md
@@ -83,8 +83,8 @@
####接口定义
- public static void onResume(final Activity activity)
- public static void onPause(final Activity activity)
+ public static void onResume(final Activity activity)
+ public static void onPause(final Activity activity)
####参数说明
@@ -147,12 +147,45 @@
##### 接口定义
- window.plugins.jPushPlugin.clearAllNotification = function()
+ window.plugins.jPushPlugin.clearAllNotification()
### 设置允许推送时间 API
+
+#### API - setPushTime
+默认情况下用户在任何时间都允许推送。即任何时候有推送下来,客户端都会收到,并展示。
+开发者可以调用此 API 来设置允许推送的时间。
+如果不在该时间段内收到消息,当前的行为是:推送到的通知会被扔掉。
+
+##### 接口定义
+
+ window.plugins.jPushPlugin.setPushTime(days, startHour, endHour)
+
+##### 参数说明
+- days: 数组 0表示星期天,1表示星期一,以此类推。 (7天制,数组中的int范围为0到6)set的值为null, 表示任何时间都可以收到消息和通知,set的size为0,则表示任何时间都收不到消息和通知.
+- startHour: int 允许推送的开始时间 (24小时制:startHour的范围为0到23)
+- endHour: int 允许推送的结束时间 (24小时制:endHour的范围为0到23)
+
### 设置通知静默时间 API
+
+#### API - setSilenceTime
+默认情况下用户在收到推送通知时,客户端可能会有震动,响铃等提示。但用户在睡觉、开会等时间点希望为 "免打扰" 模式,也是静音时段的概念。
+开发者可以调用此 API 来设置静音时段。如果在该时间段内收到消息,则:不会有铃声和震动。
+
+##### 接口定义
+
+ window.plugins.jPushPlugin.setSilenceTime(startHour, startMinute, endHour, endMinute)
+
+##### 参数说明
+
+- startHour: int 静音时段的开始时间 - 小时 (24小时制,范围:0~23 )
+- startMinute: int 静音时段的开始时间 - 分钟(范围:0~59 )
+- endHour: 静音时段的结束时间 - 小时 (24小时制,范围:0~23 )
+- endMinute: 静音时段的结束时间 - 分钟(范围:0~59 )
+
+
### 通知栏样式定制 API
+
#### API - setBasicPushNotificationBuilder, setCustomPushNotificationBuilder
当用户需要定制默认的通知栏样式时,则可调用此方法。
diff --git a/document/Android_handle_install.md b/API/Android_handle_install.md
similarity index 100%
rename from document/Android_handle_install.md
rename to API/Android_handle_install.md
diff --git a/document/Common_detail_api.md b/API/Common_detail_api.md
similarity index 100%
rename from document/Common_detail_api.md
rename to API/Common_detail_api.md
diff --git a/API/iOS API.md b/API/iOS API.md
new file mode 100644
index 0000000..ff5477f
--- /dev/null
+++ b/API/iOS API.md
@@ -0,0 +1,534 @@
+## iOS API
+
+## 开始与停止推送服务 API
+### API - init
+
+调用此 API,用来开启
+JPush SDK 提供的推送服务。
+
+开发者 App 可以通过调用停止推送服务 API 来停止极光推送服务。当又需要使用极光推送服务时,则必须要调用恢复推送服务 API。
+
+```
+本功能是一个完全本地的状态操作。也就是说:停止推送服务的状态不会保存到服务器上。
+
+如果停止推送服务后,开发者 App 被重新安装,或者被清除数据,
+
+JPush SDK 会恢复正常的默认行为。(因为保存在本地的状态数据被清除掉了)。
+本功能其行为类似于网络中断的效果,即:推送服务停止期间推送的消息,
+
+恢复推送服务后,如果推送的消息还在保留的时长范围内,则客户端是会收到离线消息。
+```
+
+#### 接口定义
+
+ window.plugins.jPushPlugin.init()
+
+### API - stopPush
+
++ 不推荐调用,因为这个 API 只是让你的 DeviceToken 失效,在 设置-通知 中您的应用程序没有任何变化
++ 推荐:设置一个 UI 界面, 提醒用户在 设置-通知 中关闭推送服务
+
+### 接口定义
+
+ window.plugins.jPushPlugin.stopPush()
+
+
+#### API - resumePush
+
+
+恢复推送服务。调用了此 API 后,iOS平台,重新去APNS注册
+
+
+##### 接口定义
+
+ window.plugins.jPushPlugin.resumePush()
+
+#### API - isPushStopped
+
+iOS平台,检查推送服务是否注册
+
+##### 接口定义
+
+ window.plugins.jPushPlugin.isPushStopped(callback)
+
+
+##### 参数说明
+
++ callback 回调函数,用来通知 JPush 的推送服务是否开启
+
+####代码示例
+ window.plugins.jPushPlugin.resumePush(callback)
+ var onCallback = function(data) {
+ if(data > 0){
+ // 开启
+ } else {
+ // 关闭
+ }
+ }
+
+
+##获取 RegistrationID API
+
+### API - getRegistrationID
+
+RegistrationID 定义
+
+集成了 JPush SDK 的应用程序在第一次成功注册到 JPush 服务器时,JPush 服务器会给客户端返回一个唯一的该设备的标识 - RegistrationID。
+JPush SDK 会以广播的形式发送 RegistrationID 到应用程序。
+
+应用程序可以把此 RegistrationID 保存以自己的应用服务器上,然后就可以根据 RegistrationID 来向设备推送消息或者通知。
+
+#### 接口定义
+
+ JPushPlugin.prototype.getRegistrationID = function(callback)
+
+##### 参数说明
+无
+#### 返回值
+
+调用此 API 来取得应用程序对应的 RegistrationID。 只有当应用程序成功注册到 JPush 的服务器时才返回对应的值,否则返回空字符串。
+
+#### 调用示例
+
+ window.plugins.jPushPlugin.getRegistrationID(onGetRegistradionID);
+ var onGetRegistradionID = function(data) {
+ try {
+ console.log("JPushPlugin:registrationID is " + data)
+ } catch(exception) {
+ console.log(exception);
+ }
+ }
+
+##别名与标签 API
+
+### API - setTagsWithAlias, setTags, setAlias
+
+提供几个相关 API 用来设置别名(alias)与标签(tags)。
+
+这几个 API 可以在 App 里任何地方调用。
+
+**别名 Alias**
+
+为安装了应用程序的用户,取个别名来标识。以后给该用户 Push 消息时,就可以用此别名来指定。
+
+每个用户只能指定一个别名。
+
+同一个应用程序内,对不同的用户,建议取不同的别名。这样,尽可能根据别名来唯一确定用户。
+
+系统不限定一个别名只能指定一个用户。如果一个别名被指定到了多个用户,当给指定这个别名发消息时,服务器端 API 会同时给这多个用户发送消息。
+
+举例:在一个用户要登录的游戏中,可能设置别名为 userid。游戏运营时,发现该用户 3 天没有玩游戏了,则根据 userid 调用服务器端 API 发通知到客户端提醒用户。
+
+**标签 Tag**
+
+为安装了应用程序的用户,打上标签。其目的主要是方便开发者根据标签,来批量下发 Push 消息。
+
+可为每个用户打多个标签。
+
+不同应用程序、不同的用户,可以打同样的标签。
+
+举例: game, old_page, women
+
+#### 接口定义
+
+ JPushPlugin.prototype.setTagsWithAlias = function(tags, alias)
+ JPushPlugin.prototype.setTags = function(tags)
+ JPushPlugin.prototype.setAlias = function(alias)
+
+#### 参数说明
+* tags
+ * 参数类型为数组
+ * nil 此次调用不设置此值
+ * 空集合表示取消之前的设置
+ * 每次调用至少设置一个 tag,覆盖之前的设置,不是新增
+ * 有效的标签组成:字母(区分大小写)、数字、下划线、汉字
+ * 限制:每个 tag 命名长度限制为 40 字节,最多支持设置 100 个 tag,但总长度不得超过1K字节。(判断长度需采用UTF-8编码)
+ * 单个设备最多支持设置 100 个 tag,App 全局 tag 数量无限制。
+* alias
+ * 参数类型为字符串
+ * nil 此次调用不设置此值
+ * 空字符串 ("")表示取消之前的设置
+ * 有效的别名组成:字母(区分大小写)、数字、下划线、汉字。
+ * 限制:alias 命名长度限制为 40 字节。(判断长度需采用 UTF-8 编码)
+
+#### 返回值说明
+
+函数本身无返回值,但需要注册 `jpush.setTagsWithAlias` 事件来监听设置结果
+
+ document.addEventListener("jpush.setTagsWithAlias", onTagsWithAlias, false);
+ var onTagsWithAlias = function(event) {
+ try {
+ console.log("onTagsWithAlias");
+ var result = "result code:"+event.resultCode + " ";
+ result += "tags:" + event.tags + " ";
+ result += "alias:" + event.alias + " ";
+ $("#tagAliasResult").html(result);
+ } catch(exception) {
+ console.log(exception)
+ }
+ }
+
+####错误码定义
+
+
+
+
+|Code|描述 |详细解释 |
+|----|:----------------------------------------|:--------|
+|6001|无效的设置,tag/alias 不应参数都为 null | |
+|6002|设置超时 |建议重试|
+|6003|alias 字符串不合法 |有效的别名、标签组成:字母(区分大小写)、数字、下划线、汉字。|
+|6004|alias超长。 |最多 40个字节 中文 UTF-8 是 3 个字节|
+|6005|某一个 tag 字符串不合法 |有效的别名、标签组成:字母(区分大小写)、数字、下划线、汉字。|
+|6006|某一个 tag 超长 |一个 tag 最多 40个字节 中文 UTF-8 是 3 个字节|
+|6007|tags 数量超出限制。最多 100个 |这是一台设备的限制。一个应用全局的标签数量无限制。|
+|6008|tag/alias 超出总长度限制 |总长度最多 1K 字节|
+|6011|10s内设置tag或alias大于3次 |短时间内操作过于频繁|
+
+
+## 获取 APNS 推送内容
+
+### 点击推送获取
+
+#### event - jpush.openNotification
+
+点击通知进入应用程序时会出发改事件
+
+#####代码示例
+
+- 在你需要接收通知的的 js 文件中加入:
+
+ document.addEventListener("jpush.openNotification", onOpenNotification, false);
+
+- onOpenNotification需要这样写:
+
+
+ var onOpenNotification = function(event) {
+ var alertContent;
+ alertContent = event.aps.alert;
+ alert("open Notificaiton:" + alertContent);
+ }
+
+
++ event 举例
+
+ {
+ "aps":{
+ "badge":1,
+ "sound":"default",
+ "alert":"今天去哪儿"
+ },
+ "key1":"value1",
+ "key2":"value2",
+ "_j_msgid":154604475
+ }
+
+### 前台获取
+
+#### event - jpush.receiveNotification
+
+应用程序处于前台时会触发该事件
+
+#####代码示例
+
+- 在你需要接收通知的的 js 文件中加入:
+
+ document.addEventListener("jpush.receiveNotification", onReceiveNotification, false);
+
+- onReceiveNotification 需要这样写:
+
+ var onReceiveNotification = function(event) {
+ var alertContent;
+ alertContent = event.aps.alert;
+ alert("open Notificaiton:" + alertContent);
+ }
+
++ event 举例
+
+ {
+ "aps":{
+ "badge":1,
+ "sound":"default",
+ "alert":"今天去哪儿"
+ },
+ "key1":"value1",
+ "key2":"value2",
+ "_j_msgid":154604475
+ }
+
+#### API - receiveMessageIniOSCallback
+
+用于 iOS 收到应用内消息的回调函数(请注意和通知的区别),该函数不需要主动调用
+不推荐使用回调函数
+
+##### 接口定义
+
+ JPushPlugin.prototype.receiveMessageIniOSCallback = function(data)
+
+#####参数说明
+
+- data 是一个 js 字符串使用如下代码解析,js 具体 key 根据应用内消息来确定
+
+ var bToObj = JSON.parse(data)
+
+#####返回值
+无
+
+##### 代码示例
+
+
+## 获取自定义消息内容
+
+
+####event - jpush.receiveMessage
+
+收到应用内消息时触发这个事件
+
+
+`推荐使用事件的方式传递,但同时保留了 receiveMessageIniOSCallback 的回调函数,兼容以前的代码`
+
+
+#####代码示例
+
+- 在你需要接收通知的的 js 文件中加入:
+
+ document.addEventListener("jpush.receiveMessage", onReceiveMessage, false);
+
+- onReceiveMessage 需要这样写:
+
+
+ var onReceiveMessage = function(event) {
+ try{
+ var message;
+ message = event.content;
+ $("#messageResult").html(message);
+ }catch(exception) {
+ console.log("JPushPlugin:onReceiveMessage-->" + exception);
+ }
+ }
+
+
++ event 举例
+
+ {
+ "content":"今天去哪儿",
+ "extras":
+ {
+ "key":"不填写没有"
+ }
+ }
+
+### 设置Badge
+#### API - setBadge, resetBadge
+
+ JPush 封装 badge 功能,允许应用上传 badge 值至 JPush 服务器,由 JPush 后台帮助管理每个用户所对应的推送 badge 值,简化了设置推送 badge 的操作。
+(本接口不会直接改变应用本地的角标值. 要修改本地 badege 值,使用 setApplicationIconBadgeNumber)
+
+实际应用中,开发者可以直接对 badge 值做增减操作,无需自己维护用户与 badge 值之间的对应关系。
+##### 接口定义
+
+ window.plugins.jPushPlugin.prototype.setBadge(value)
+ window.plugins.jPushPlugin.prototype.reSetBadge()
+
+`resetBadge相当于setBadge(0)`
+##### 参数说明
+value 取值范围:[0,99999]
+##### 返回值
+无,控制台会有 log 打印设置结果
+#####代码示例
+
+ window.plugins.jPushPlugin.setBadge(5);
+ window.plugins.jPushPlugin.reSetBadge();
+
+#### API - setApplicationIconBadgeNumber
+
+本接口直接改变应用本地的角标值.
+设置 iOS 的角标,当设置 badge = 0 时为清除角标
+
+##### 接口定义
+
+ window.plugins.jPushPlugin.prototype.setApplicationIconBadgeNumber(badge)
+
+##### 参数说明
+
+- badge 整形,例如0,1,2
+- 当 badge 为 0 时,角标被清除
+
+#####代码示例
+
+ window.plugins.jPushPlugin.setApplicationIconBadgeNumber(0);
+
+
+#### API - getApplicationIconBadgeNumber
+
+获取 iOS 的角标值
+
+##### 接口定义
+
+ window.plugins.jPushPlugin.prototype.getApplicationIconBadgeNumber(callback)
+
+##### 参数说明
+
+- callback 回调函数
+
+#####代码示例
+```
+
+window.plugins.jPushPlugin.getApplicationIconBadgeNumber(function(data){
+ console.log(data);
+ });
+
+```
+
+### 本地通知
+#### API - addLocalNotificationForIOS
+
+API 用于注册本地通知
+
+最多支持64个
+
+##### 接口定义
+
+ window.plugins.jPushPlugin.prototype.addLocalNotificationForIOS(delayTime, content, badge, notificationID, extras)
+
+##### 参数说明
+
+- delayTime 本地推送延迟多长时间后显示,数值类型或纯数字的字符型均可
+- content 本地推送需要显示的内容
+- badge 角标的数字。如果不需要改变角标传-1。数值类型或纯数字的字符型均可
+- notificationID 本地推送标识符,字符串。
+- extras 自定义参数,可以用来标识推送和增加附加信息。字典类型。
+
+#####代码示例
+
+ window.plugins.jPushPlugin.addLocalNotificationForIOS(6*60*60, "本地推送内容", 1, "notiId", {"key":"value"});
+
+#### API - deleteLocalNotificationWithIdentifierKeyInIOS
+
+API 删除本地推送定义
+
+##### 接口定义
+
+ window.plugins.jPushPlugin.prototype.deleteLocalNotificationWithIdentifierKeyInIOS(identifierKey)
+
+##### 参数说明
+
+- identifierKey 本地推送标识符
+
+#####代码示例
+
+ window.plugins.jPushPlugin.deleteLocalNotificationWithIdentifierKeyInIOS("identifier");
+
+#### API - clearAllLocalNotifications
+
+API 清除所有本地推送对象
+
+##### 接口定义
+
+ window.plugins.jPushPlugin.prototype.clearAllLocalNotifications()
+
+#####代码示例
+
+ window.plugins.jPushPlugin.clearAllLocalNotifications();
+
+### 页面的统计
+#### API - startLogPageView, stopLogPageView, beginLogPageView
+
+本 API 用于“用户指定页面使用时长”的统计,并上报到服务器,在 Portal 上展示给开发者。页面统计集成正确,才能够获取正确的页面访问路径、访问深度(PV)的数据。
+
+##### 接口定义
+ window.plugins.jPushPlugin.prototype.startLogPageView = function(pageName)
+ window.plugins.jPushPlugin.prototype.stopLogPageView = function(pageName)
+ window.plugins.jPushPlugin.prototype.beginLogPageView = function(pageName, duration)
+#####参数说明
+pageName 需要统计页面自定义名称
+
+duration 自定义的页面时间
+#####调用说明
+应在所有的需要统计得页面得 viewWillAppear 和 viewWillDisappear 加入 startLogPageView 和 stopLogPageView 来统计当前页面的停留时间。
+
+ 或者直接使用 beginLogPageView 来自定义加入页面和时间信息。
+#####返回值说明
+无
+#####代码示例
+
+ window.plugins.jPushPlugin.beginLogPageView("newPage", 5);
+ window.plugins.jPushPlugin.startLogPageView("onePage");
+ window.plugins.jPushPlugin.stopLogPageView("onePage");
+
+
+
+### 日志等级设置
+#### API - setDebugModeFromIos
+API 用于开启 Debug 模式,显示更多的日志信息
+
+建议调试时开启这个选项,不调试的时候注释这句代码,这个函数 setLogOFF 是相反的一对
+##### 接口定义
+
+ window.plugins.jPushPlugin.prototype.setDebugModeFromIos()
+
+#####代码示例
+
+ window.plugins.jPushPlugin.setDebugModeFromIos();
+
+#### API - setLogOFF
+
+API 用来关闭日志信息(除了必要的错误信息)
+
+不需要任何调试信息的时候,调用此 API(发布时建议调用此 API,用来屏蔽日志信息,节省性能消耗)
+
+##### 接口定义
+
+ window.plugins.jPushPlugin.prototype.setLogOFF()
+
+#####代码示例
+
+ window.plugins.jPushPlugin.setLogOFF();
+
+#### API - setCrashLogON
+
+API 用于统计用户应用崩溃日志
+
+如果需要统计 Log 信息,调用该接口。当你需要自己收集错误信息时,切记不要调用该接口。
+
+
+##### 接口定义
+
+ window.plugins.jPushPlugin.prototype.setCrashLogON()
+
+#####代码示例
+
+ window.plugins.jPushPlugin.setCrashLogON();
+
+### 地理位置上报
+#### API - setLocation
+API 用于统计用户地理信息
+
+##### 接口定义
+
+window.plugins.jPushPlugin.prototype.setLocation(latitude,longitude)
+
+##### 参数说明
+
+- latitude 地理位置纬度,数值类型或纯数字的字符型均可
+- longitude 地理位置精度,数值类型或纯数字的字符型均可
+
+#####代码示例
+
+window.plugins.jPushPlugin.setLocation(39.26,115.25);
+
+### 设备平台判断
+#### API - isPlatformIOS
+API 用于区分 iOS, Android 平台,以便不同设置
+
+##### 接口定义
+
+ window.plugins.jPushPlugin.prototype.isPlatformIOS()
+
+#####代码示例
+
+ if(window.plugins.jPushPlugin.isPlatformIOS()){
+ // iOS
+ }else{
+ // Android
+ }
diff --git a/document/iOS_handle_install.md b/API/iOS_install.md
similarity index 51%
rename from document/iOS_handle_install.md
rename to API/iOS_install.md
index 2bf22d8..b445c30 100644
--- a/document/iOS_handle_install.md
+++ b/API/iOS_install.md
@@ -1,12 +1,12 @@
-### iOS手动安装
+### iOS 手动安装
-下载 JPush PhoneGap 插件,并解压缩,标记插件目录为:`$JPUSH_PLUGIN_DIR`
+- 下载 JPush PhoneGap 插件,并解压缩,标记插件目录为:`$JPUSH_PLUGIN_DIR`
+- 用 xcode 打开 iOS 工程 将 `$JPUSH_PLUGIN_DIR`/src/ios/Plugins/ 拖到 project 中
-1. 用 xcode 打开 iOS 工程 将 `$JPUSH_PLUGIN_DIR`/src/ios/Plugins/ 拖到 project 中
-2. 将 `$JPUSH_PLUGIN_DIR`/src/ios/lib/ 拖到 project 中
+- 将 `$JPUSH_PLUGIN_DIR`/src/ios/lib/ 拖到 project 中
-4. 添加以下框架,打开 xcode,点击 project,选择(Target -> Build Phases -> Link Binary With Libraries)
+- 添加以下框架,打开 xcode,点击 project,选择(Target -> Build Phases -> Link Binary With Libraries)
CFNetwork.framework
CoreFoundation.framework
@@ -17,16 +17,16 @@
UIKit.framework
-5. 在你的工程中创建一个新的 Property List 文件
+- 在你的工程中创建一个新的 Property List 文件
并将其命名为 PushConfig.plist,填入 Portal 为你的应用提供的 APP_KEY 等参数
-10. 在 AppDelegate.m 中包含头文件
+- 在 AppDelegate.m 中包含头文件
- #import "APService.h"
- #import "JPushPlugin.h"
+ #import "JPUSHService.h"
+ #import "JPushPlugin.h"
-6. 调用代码,监听系统事件,相应地调用 JPush SDK 提供的 API 来实现功能
+- 在 AppDelegate.m 中的下列方法中添加代码,如果方法不存在则增加相应方法与内容
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions{
//原内容保持不变
@@ -37,17 +37,16 @@
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
//原内容保持不变
// Required add
- [APService registerDeviceToken:deviceToken];
+ [JPUSHService registerDeviceToken:deviceToken];
}
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo {
//原内容保持不变
- // Required
- [APService handleRemoteNotification:userInfo];
- [[NSNotificationCenter defaultCenter] postNotificationName:kJPushPluginReceiveNotification
- object:userInfo];
+ // Required add
+ [JPUSHService handleRemoteNotification:userInfo];
+ [[NSNotificationCenter defaultCenter] postNotificationName:kJPushPluginReceiveNotification object:userInfo];
}
-7. 修改 phonegap config.xml 文件用来包含 Plugin/ 内的插件
+- 修改 phonegap config.xml 文件用来包含 Plugin/ 内的插件
@@ -56,7 +55,8 @@
-8. 复制 `$JPUSH_PLUGIN_DIR`/www/PushNotification.js 到工程的 www 目录下面
-9. 在需要使用插件处加入
+- 复制 `$JPUSH_PLUGIN_DIR`/www/JPushPlugin.js 到工程的 www 目录下面
+
+- 在需要使用插件处加入
diff --git a/README.md b/README.md
index c2800bc..bd992e5 100644
--- a/README.md
+++ b/README.md
@@ -65,12 +65,12 @@ JPush-PhoneGap-Plugin 支持 iOS, Android 的推送插件。
### Android 手动安装
-[Android 手动安装文档地址](document/Android_handle_install.md)
+[Android 手动安装文档地址](API/Android_handle_install.md)
### iOS 手动安装
-[IOS手动安装文档地址](document/iOS_handle_install.md)
+[IOS 手动安装文档地址](API/iOS_install.md)
###示例
@@ -85,7 +85,7 @@ JPush-PhoneGap-Plugin 支持 iOS, Android 的推送插件。
该项目基于 cordova 实现,目前无法使用 'PhoneGap build' 云服务进行打包,建议使用本地环境进行打包
-### API 说明
+## API 说明
插件的 API 集中在 JPushPlugin.js 文件中,该文件的具体位置如下:
@@ -97,128 +97,14 @@ iOS:
[Project]/www/plugins/cn.jpush.phonegap.JPushPlugin/www
-具体的 API 请参考下面:
+### 具体的 API 请参考:
-#### iOS 和 Android 通用 API 简介
+- [公共 API](https://github.com/jpush/jpush-phonegap-plugin/blob/dev/API/Common_detail_api.md)
-+ 停止与恢复推送服务
+- [iOS API](https://github.com/jpush/jpush-phonegap-plugin/blob/dev/API/iOS%20API.md)
- window.plugins.jPushPlugin.init()
- window.plugins.jPushPlugin.stopPush()
- window.plugins.jPushPlugin.resumePush()
- window.plugins.jPushPlugin.isPushStopped(callback)
+- [Android API](https://github.com/jpush/jpush-phonegap-plugin/blob/dev/API/Android_detail_api.md)
-+ 获取 RegistrationID
-
- window.plugins.jPushPlugin.getRegistrationID(callback)
-
-+ 别名与标签
-
- window.plugins.jPushPlugin.setTagsWithAlias(tags, alias)
- window.plugins.jPushPlugin.setTags(tags)
- window.plugins.jPushPlugin.setAlias(alias)
-
- event - jpush.setTagsWithAlias //三个方法都是触发该回调事件
-
-+ 获取点击通知内容
-
- event - jpush.openNotification
-
-+ 获取通知内容
-
- event - jpush.receiveNotification
-
-+ 获取自定义消息推送内容
-
- event - jpush.receiveMessage
-
-
- [通用 API 详细说明](document/Common_detail_api.md)
-
-#### iOS API简介
-
-+ 获取自定义消息推送内容
-
- //推荐使用事件的方式传递,但同时保留了 receiveMessageIniOSCallback 的回调函数,兼容以前的代码
- window.plugins.jPushPlugin.receiveMessageIniOSCallback(data)
-
- event - jpush.receiveMessage
-
-+ 页面的统计
-
- window.plugins.jPushPlugin.startLogPageView(pageName)
- window.plugins.jPushPlugin.stopLogPageView(pageName)
- window.plugins.jPushPlugin.beginLogPageView(pageName, duration)
-
-+ 设置 Badge
-
- window.plugins.jPushPlugin.setBadge(value)
- window.plugins.jPushPlugin.resetBadge()
- window.plugins.jPushPlugin.setApplicationIconBadgeNumber(badge)
- window.plugins.JPushPlugin.getApplicationIconBadgeNumber(callback)
-
-+ 本地通知
-
- window.plugins.JPushPlugin.addLocalNotificationForIOS(delayTime, content,
- badge, notificationID, extras)
- window.plugins.JPushPlugin.deleteLocalNotificationWithIdentifierKeyInIOS()
- window.plugins.JPushPlugin.clearAllLocalNotifications()
-
-+ 日志等级设置
-
- window.plugins.jPushPlugin.setDebugModeFromIos()
- window.plugins.jPushPlugin.setLogOFF()
- window.plugins.JPushPlugin.setCrashLogON()
-
-+ 地理位置上报
-
- window.plugins.JPushPlugin.setLocation(latitude, longitude)
-
- [iOS API 详细说明](document/iOS_detail_api.md)
-
-
-#### Android API简介
-
-+ 获取集成日志
-
- window.plugins.jPushPlugin.setDebugMode(mode)
-
-+ 接收推送消息和点击通知
-
- //下面这两个 API 是兼容旧有的代码
- window.plugins.jPushPlugin.receiveMessageInAndroidCallback(data)
- window.plugins.jPushPlugin.openNotificationInAndroidCallback(data)
-
-+ 统计分析
-
- window.plugins.jPushPlugin.setStatisticsOpen(boolean)
-
- 或在 MainActivity 中的 onPause() 和 onResume() 方法中分别调用
- JPushInterface.onPause(this) 和 JPushInterface.onResume(this) 来启用统计分析功能,
- 如果使用这种方式启用统计分析功能,则 window.plugins.jPushPlugin.setStatisticsOpen(boolean)
- 方法不再有效,建议不要同时使用。
-
-+ 清除通知
-
- window.plugins.jPushPlugin.clearAllNotification()
-
-+ 通知栏样式定制
-
- window.plugins.jPushPlugin.setBasicPushNotificationBuilder = function()
- window.plugins.jPushPlugin.setCustomPushNotificationBuilder = function()
-
-+ 设置保留最近通知条数
-
- window.plugins.jPushPlugin.setLatestNotificationNum(num)
-
-+ 本地通知
-
- window.plugins.jPushPlugin.addLocalNotification(builderId, content,
- title, notificaitonID, broadcastTime, extras)
- window.plugins.jPushPlugin.removeLocalNotification(notificationID)
- window.plugins.jPushPlugin.clearLocalNotifications()
-
- [Android API 详细说明](document/Android_detail_api.md)
###常见问题
@@ -227,13 +113,20 @@ iOS:
eclipse 中 PhoneGap 工程 import 之后出现:`Type CallbackContext cannot be resolved to a type`
解决方案:eclipse 中右键单击工程名,Build Path -> Config Build Path -> Projects -> 选中工程名称 -> CordovaLib -> 点击 add
-####2. iOS 设置 / 修改 APP_KEY
+####2. iOS
+
+- 设置 / 修改 APP_KEY
在 PushConfig.plist 中修改。
PushConfig.plist 其他值说明:
CHANNEL: 渠道标识
IsProduction: 是否生产环境(暂未启用)
+- 收不到推送
+
+ 请首先按照正确方式再次配置证书、描述文件
+ [iOS 证书 设置指南](http://docs.jpush.io/client/ios_tutorials/#ios_1)
+
###更多
[JPush 官网文档](http://docs.jpush.io/)
diff --git a/document/iOS_detail_api.md b/document/iOS_detail_api.md
deleted file mode 100644
index 98d3319..0000000
--- a/document/iOS_detail_api.md
+++ /dev/null
@@ -1,238 +0,0 @@
-## iOS API简介
-
-### 获取 APNs(通知) 推送内容
-
-
-#### API - receiveMessageIniOSCallback
-
-用于 iOS 收到应用内消息的回调函数(请注意和通知的区别),该函数不需要主动调用
-不推荐使用回调函数
-
-##### 接口定义
-
- JPushPlugin.prototype.receiveMessageIniOSCallback = function(data)
-
-#####参数说明
-
-- data 是一个 js 字符串使用如下代码解析,js 具体 key 根据应用内消息来确定
-
- var bToObj = JSON.parse(data)
-
-#####返回值
-无
-
-##### 代码示例
-
-
-### 页面的统计
-#### API - startLogPageView, stopLogPageView, beginLogPageView
-
-本 API 用于“用户指定页面使用时长”的统计,并上报到服务器,在 Portal 上展示给开发者。页面统计集成正确,才能够获取正确的页面访问路径、访问深度(PV)的数据。
-
-##### 接口定义
- window.plugins.jPushPlugin.prototype.startLogPageView = function(pageName)
- window.plugins.jPushPlugin.prototype.stopLogPageView = function(pageName)
- window.plugins.jPushPlugin.prototype.beginLogPageView = function(pageName, duration)
-#####参数说明
-pageName 需要统计页面自定义名称
-
-duration 自定义的页面时间
-#####调用说明
-应在所有的需要统计得页面得 viewWillAppear 和 viewWillDisappear 加入 startLogPageView 和 stopLogPageView 来统计当前页面的停留时间。
-
- 或者直接使用 beginLogPageView 来自定义加入页面和时间信息。
-#####返回值说明
-无
-#####代码示例
-
- window.plugins.jPushPlugin.beginLogPageView("newPage", 5);
- window.plugins.jPushPlugin.startLogPageView("onePage");
- window.plugins.jPushPlugin.stopLogPageView("onePage");
-
-### 设置Badge
-#### API - setBadge, resetBadge
-
- JPush 封装 badge 功能,允许应用上传 badge 值至 JPush 服务器,由 JPush 后台帮助管理每个用户所对应的推送 badge 值,简化了设置推送 badge 的操作。
-(本接口不会直接改变应用本地的角标值. 要修改本地 badege 值,使用 setApplicationIconBadgeNumber)
-
-实际应用中,开发者可以直接对 badge 值做增减操作,无需自己维护用户与 badge 值之间的对应关系。
-##### 接口定义
-
- window.plugins.jPushPlugin.prototype.setBadge(value)
- window.plugins.jPushPlugin.prototype.reSetBadge()
-
-`resetBadge相当于setBadge(0)`
-##### 参数说明
-value 取值范围:[0,99999]
-##### 返回值
-无,控制台会有 log 打印设置结果
-#####代码示例
-
- window.plugins.jPushPlugin.setBadge(5);
- window.plugins.jPushPlugin.reSetBadge();
-
-#### API - setApplicationIconBadgeNumber
-
-本接口直接改变应用本地的角标值.
-设置 iOS 的角标,当设置 badge = 0 时为清除角标
-
-##### 接口定义
-
- window.plugins.jPushPlugin.prototype.setApplicationIconBadgeNumber(badge)
-
-##### 参数说明
-
-- badge 整形,例如0,1,2
-- 当 badge 为 0 时,角标被清除
-
-#####代码示例
-
- window.plugins.jPushPlugin.setApplicationIconBadgeNumber(0);
-
-
-#### API - getApplicationIconBadgeNumber
-
-获取 iOS 的角标值
-
-##### 接口定义
-
- window.plugins.jPushPlugin.prototype.getApplicationIconBadgeNumber(callback)
-
-##### 参数说明
-
-- callback 回调函数
-
-#####代码示例
-```
-
-window.plugins.jPushPlugin.getApplicationIconBadgeNumber(function(data){
- console.log(data);
- });
-
-```
-
-### 本地通知
-#### API - addLocalNotificationForIOS
-
-API 用于注册本地通知
-
-最多支持64个
-
-##### 接口定义
-
- window.plugins.jPushPlugin.prototype.addLocalNotificationForIOS(delayTime, content, badge, notificationID, extras)
-
-##### 参数说明
-
-- delayTime 本地推送延迟多长时间后显示,数值类型或纯数字的字符型均可
-- content 本地推送需要显示的内容
-- badge 角标的数字。如果不需要改变角标传-1。数值类型或纯数字的字符型均可
-- notificationID 本地推送标识符,字符串。
-- extras 自定义参数,可以用来标识推送和增加附加信息。字典类型。
-
-#####代码示例
-
- window.plugins.jPushPlugin.addLocalNotificationForIOS(6*60*60, "本地推送内容", 1, "notiId", {"key":"value"});
-
-#### API - deleteLocalNotificationWithIdentifierKeyInIOS
-
-API 删除本地推送定义
-
-##### 接口定义
-
- window.plugins.jPushPlugin.prototype.deleteLocalNotificationWithIdentifierKeyInIOS(identifierKey)
-
-##### 参数说明
-
-- identifierKey 本地推送标识符
-
-#####代码示例
-
- window.plugins.jPushPlugin.deleteLocalNotificationWithIdentifierKeyInIOS("identifier");
-
-#### API - clearAllLocalNotifications
-
-API 清除所有本地推送对象
-
-##### 接口定义
-
- window.plugins.jPushPlugin.prototype.clearAllLocalNotifications()
-
-#####代码示例
-
- window.plugins.jPushPlugin.clearAllLocalNotifications();
-
-### 日志等级设置
-#### API - setDebugModeFromIos
-API 用于开启 Debug 模式,显示更多的日志信息
-
-建议调试时开启这个选项,不调试的时候注释这句代码,这个函数 setLogOFF 是相反的一对
-##### 接口定义
-
- window.plugins.jPushPlugin.prototype.setDebugModeFromIos()
-
-#####代码示例
-
- window.plugins.jPushPlugin.setDebugModeFromIos();
-
-#### API - setLogOFF
-
-API 用来关闭日志信息(除了必要的错误信息)
-
-不需要任何调试信息的时候,调用此 API(发布时建议调用此 API,用来屏蔽日志信息,节省性能消耗)
-
-##### 接口定义
-
- window.plugins.jPushPlugin.prototype.setLogOFF()
-
-#####代码示例
-
- window.plugins.jPushPlugin.setLogOFF();
-
-#### API - setCrashLogON
-
-API 用于统计用户应用崩溃日志
-
-如果需要统计 Log 信息,调用该接口。当你需要自己收集错误信息时,切记不要调用该接口。
-
-
-##### 接口定义
-
- window.plugins.jPushPlugin.prototype.setCrashLogON()
-
-#####代码示例
-
- window.plugins.jPushPlugin.setCrashLogON();
-
-### 地理位置上报
-#### API - setLocation
-API 用于统计用户地理信息
-
-##### 接口定义
-
-window.plugins.jPushPlugin.prototype.setLocation(latitude,longitude)
-
-##### 参数说明
-
-- latitude 地理位置纬度,数值类型或纯数字的字符型均可
-- longitude 地理位置精度,数值类型或纯数字的字符型均可
-
-#####代码示例
-
-window.plugins.jPushPlugin.setLocation(39.26,115.25);
-
-### 设备平台判断
-#### API - isPlatformIOS
-API 用于区分 iOS, Android 平台,以便不同设置
-
-##### 接口定义
-
- window.plugins.jPushPlugin.prototype.isPlatformIOS()
-
-#####代码示例
-
- if(window.plugins.jPushPlugin.isPlatformIOS()){
- // iOS
- }else{
- // Android
- }
diff --git a/example/.DS_Store b/example/.DS_Store
index 5f52949..22f9529 100644
Binary files a/example/.DS_Store and b/example/.DS_Store differ
diff --git a/src/android/JPushPlugin.java b/src/android/JPushPlugin.java
index 72d46f7..95e797a 100644
--- a/src/android/JPushPlugin.java
+++ b/src/android/JPushPlugin.java
@@ -1,10 +1,8 @@
package cn.jpush.phonegap;
import android.app.Activity;
-import android.app.Notification;
-import android.content.ComponentName;
-import android.content.Intent;
import android.content.Context;
+import android.text.TextUtils;
import android.util.Log;
import __PACKAGE_NAME__.R;
@@ -38,31 +36,31 @@ import cn.jpush.android.data.JPushLocalNotification;
public class JPushPlugin extends CordovaPlugin {
private final static List methodList =
Arrays.asList(
- "addLocalNotification",
- "clearAllNotification",
- "clearLocalNotifications",
- "clearNotificationById",
- "getNotification",
- "getRegistrationID",
- "init",
- "isPushStopped",
- "onPause",
- "onResume",
- "requestPermission",
- "removeLocalNotification",
- "reportNotificationOpened",
- "resumePush",
- "setAlias",
- "setBasicPushNotificationBuilder",
- "setCustomPushNotificationBuilder",
- "setDebugMode",
- "setLatestNotificationNum",
- "setPushTime",
- "setTags",
- "setTagsWithAlias",
- "setSilenceTime",
- "setStatisticsOpen",
- "stopPush"
+ "addLocalNotification",
+ "clearAllNotification",
+ "clearLocalNotifications",
+ "clearNotificationById",
+ "getNotification",
+ "getRegistrationID",
+ "init",
+ "isPushStopped",
+ "onPause",
+ "onResume",
+ "requestPermission",
+ "removeLocalNotification",
+ "reportNotificationOpened",
+ "resumePush",
+ "setAlias",
+ "setBasicPushNotificationBuilder",
+ "setCustomPushNotificationBuilder",
+ "setDebugMode",
+ "setLatestNotificationNum",
+ "setPushTime",
+ "setTags",
+ "setTagsWithAlias",
+ "setSilenceTime",
+ "setStatisticsOpen",
+ "stopPush"
);
private ExecutorService threadPool = Executors.newFixedThreadPool(1);
@@ -90,20 +88,20 @@ public class JPushPlugin extends CordovaPlugin {
super.initialize(cordova, webView);
Log.i(TAG, "---------------- initialize" + "-" + openNotificationAlert
- + "-" + notificationAlert);
+ + "-" + notificationAlert);
- cordovaActivity = this.cordova.getActivity();
+ cordovaActivity = cordova.getActivity();
//如果同时缓存了打开事件 openNotificationAlert 和 消息事件 notificationAlert,只向 UI 发打开事件。
//这样做是为了和 iOS 统一。
if (openNotificationAlert != null) {
notificationAlert = null;
transmitNotificationOpen(openNotificationTitle, openNotificationAlert,
- openNotificationExtras);
+ openNotificationExtras);
}
if (notificationAlert != null) {
transmitNotificationReceive(notificationTitle, notificationAlert,
- notificationExtras);
+ notificationExtras);
}
}
@@ -111,25 +109,25 @@ public class JPushPlugin extends CordovaPlugin {
Log.i(TAG, "---------------- onPause");
shouldCacheMsg = true;
if (isStatisticsOpened && multitasking) {
- JPushInterface.onPause(cordovaActivity);
+ JPushInterface.onPause(this.cordova.getActivity());
}
}
public void onResume(boolean multitasking) {
shouldCacheMsg = false;
Log.i(TAG, "---------------- onResume" + "-" + openNotificationAlert
- + "-" + notificationAlert);
+ + "-" + notificationAlert);
if (isStatisticsOpened && multitasking) {
- JPushInterface.onResume(cordovaActivity);
+ JPushInterface.onResume(this.cordova.getActivity());
}
if (openNotificationAlert != null) {
notificationAlert = null;
transmitNotificationOpen(openNotificationTitle, openNotificationAlert,
- openNotificationExtras);
+ openNotificationExtras);
}
if (notificationAlert != null) {
transmitNotificationReceive(notificationTitle, notificationAlert,
- notificationExtras);
+ notificationExtras);
}
}
@@ -141,12 +139,17 @@ public class JPushPlugin extends CordovaPlugin {
JSONObject jExtras = new JSONObject();
for (Entry entry : extras.entrySet()) {
if (entry.getKey().equals("cn.jpush.android.EXTRA")) {
- JSONObject jo = new JSONObject((String) entry.getValue());
- String key;
- Iterator keys = jo.keys();
- while(keys.hasNext()) {
- key = keys.next().toString();
- jExtras.put(key, jo.getString(key));
+ JSONObject jo = null;
+ if (TextUtils.isEmpty((String) entry.getValue())) {
+ jo = new JSONObject();
+ } else {
+ jo = new JSONObject((String) entry.getValue());
+ String key;
+ Iterator keys = jo.keys();
+ while (keys.hasNext()) {
+ key = keys.next().toString();
+ jExtras.put(key, jo.getString(key));
+ }
}
jExtras.put("cn.jpush.android.EXTRA", jo);
} else {
@@ -171,12 +174,17 @@ public class JPushPlugin extends CordovaPlugin {
JSONObject jExtras = new JSONObject();
for (Entry entry : extras.entrySet()) {
if (entry.getKey().equals("cn.jpush.android.EXTRA")) {
- JSONObject jo = new JSONObject((String) entry.getValue());
- String key;
- Iterator keys = jo.keys();
- while(keys.hasNext()) {
- key = keys.next().toString();
- jExtras.put(key, jo.getString(key));
+ JSONObject jo = null;
+ if (TextUtils.isEmpty((String) entry.getValue())) {
+ jo = new JSONObject();
+ } else {
+ jo = new JSONObject((String) entry.getValue());
+ String key;
+ Iterator keys = jo.keys();
+ while (keys.hasNext()) {
+ key = keys.next().toString();
+ jExtras.put(key, jo.getString(key));
+ }
}
jExtras.put("cn.jpush.android.EXTRA", jo);
} else {
@@ -265,7 +273,7 @@ public class JPushPlugin extends CordovaPlugin {
}
void init(JSONArray data, CallbackContext callbackContext) {
- JPushInterface.init(cordovaActivity.getApplicationContext());
+ JPushInterface.init(this.cordova.getActivity().getApplicationContext());
}
void setDebugMode(JSONArray data, CallbackContext callbackContext) {
@@ -280,18 +288,18 @@ public class JPushPlugin extends CordovaPlugin {
}
void stopPush(JSONArray data, CallbackContext callbackContext) {
- JPushInterface.stopPush(cordovaActivity.getApplicationContext());
+ JPushInterface.stopPush(this.cordova.getActivity().getApplicationContext());
callbackContext.success();
}
void resumePush(JSONArray data, CallbackContext callbackContext) {
- JPushInterface.resumePush(cordovaActivity.getApplicationContext());
+ JPushInterface.resumePush(this.cordova.getActivity().getApplicationContext());
callbackContext.success();
}
void isPushStopped(JSONArray data, CallbackContext callbackContext) {
boolean isStopped = JPushInterface.isPushStopped(
- cordovaActivity.getApplicationContext());
+ this.cordova.getActivity().getApplicationContext());
if (isStopped) {
callbackContext.success(1);
} else {
@@ -309,7 +317,7 @@ public class JPushPlugin extends CordovaPlugin {
}
if (num != -1) {
JPushInterface.setLatestNotificationNumber(
- cordovaActivity.getApplicationContext(), num);
+ this.cordova.getActivity().getApplicationContext(), num);
} else {
callbackContext.error("error num");
}
@@ -335,30 +343,30 @@ public class JPushPlugin extends CordovaPlugin {
} catch (JSONException e) {
callbackContext.error("error reading hour json");
}
- Context context = cordovaActivity.getApplicationContext();
+ Context context = this.cordova.getActivity().getApplicationContext();
JPushInterface.setPushTime(context, days, startHour, endHour);
callbackContext.success();
}
void getRegistrationID(JSONArray data, CallbackContext callbackContext) {
- Context context = cordovaActivity.getApplicationContext();
+ Context context = this.cordova.getActivity().getApplicationContext();
String regID = JPushInterface.getRegistrationID(context);
callbackContext.success(regID);
}
void onResume(JSONArray data, CallbackContext callbackContext) {
- JPushInterface.onResume(cordovaActivity);
+ JPushInterface.onResume(this.cordova.getActivity());
}
void onPause(JSONArray data, CallbackContext callbackContext) {
- JPushInterface.onPause(cordovaActivity);
+ JPushInterface.onPause(this.cordova.getActivity());
}
void reportNotificationOpened(JSONArray data, CallbackContext callbackContext) {
try {
String msgID;
msgID = data.getString(0);
- JPushInterface.reportNotificationOpened(cordovaActivity, msgID);
+ JPushInterface.reportNotificationOpened(this.cordova.getActivity(), msgID);
} catch (JSONException e) {
e.printStackTrace();
}
@@ -370,8 +378,8 @@ public class JPushPlugin extends CordovaPlugin {
for (int i = 0; i < data.length(); i++) {
tags.add(data.getString(i));
}
- JPushInterface.setTags(cordovaActivity.getApplicationContext(),
- tags, mTagWithAliasCallback);
+ JPushInterface.setTags(this.cordova.getActivity().getApplicationContext(),
+ tags, mTagWithAliasCallback);
callbackContext.success();
} catch (JSONException e) {
e.printStackTrace();
@@ -382,8 +390,8 @@ public class JPushPlugin extends CordovaPlugin {
void setAlias(JSONArray data, CallbackContext callbackContext) {
try {
String alias = data.getString(0);
- JPushInterface.setAlias(cordovaActivity.getApplicationContext(),
- alias, mTagWithAliasCallback);
+ JPushInterface.setAlias(this.cordova.getActivity().getApplicationContext(),
+ alias, mTagWithAliasCallback);
callbackContext.success();
} catch (JSONException e) {
e.printStackTrace();
@@ -400,8 +408,8 @@ public class JPushPlugin extends CordovaPlugin {
for (int i = 0; i < tagsArray.length(); i++) {
tags.add(tagsArray.getString(i));
}
- JPushInterface.setAliasAndTags(cordovaActivity.getApplicationContext(),
- alias, tags, mTagWithAliasCallback);
+ JPushInterface.setAliasAndTags(this.cordova.getActivity().getApplicationContext(),
+ alias, tags, mTagWithAliasCallback);
callbackContext.success();
} catch (JSONException e) {
e.printStackTrace();
@@ -412,7 +420,7 @@ public class JPushPlugin extends CordovaPlugin {
void setBasicPushNotificationBuilder(JSONArray data,
CallbackContext callbackContext) {
BasicPushNotificationBuilder builder = new BasicPushNotificationBuilder(
- cordovaActivity);
+ this.cordova.getActivity());
builder.developerArg0 = "Basic builder 1";
JPushInterface.setPushNotificationBuilder(1, builder);
JSONObject obj = new JSONObject();
@@ -426,7 +434,7 @@ public class JPushPlugin extends CordovaPlugin {
void setCustomPushNotificationBuilder(JSONArray data,
CallbackContext callbackContext) {
CustomPushNotificationBuilder builder = new CustomPushNotificationBuilder(
- cordovaActivity, R.layout.test_notification_layout,
+ this.cordova.getActivity(), R.layout.test_notification_layout,
R.id.icon, R.id.title, R.id.text);
builder.developerArg0 = "Custom Builder 1";
JPushInterface.setPushNotificationBuilder(2, builder);
@@ -439,7 +447,7 @@ public class JPushPlugin extends CordovaPlugin {
}
void clearAllNotification(JSONArray data, CallbackContext callbackContext) {
- JPushInterface.clearAllNotifications(cordovaActivity);
+ JPushInterface.clearAllNotifications(this.cordova.getActivity());
}
void clearNotificationById(JSONArray data, CallbackContext callbackContext) {
@@ -451,7 +459,7 @@ public class JPushPlugin extends CordovaPlugin {
callbackContext.error("error reading id json");
}
if (notificationId != -1) {
- JPushInterface.clearNotificationById(cordovaActivity, notificationId);
+ JPushInterface.clearNotificationById(this.cordova.getActivity(), notificationId);
} else {
callbackContext.error("error id");
}
@@ -467,7 +475,7 @@ public class JPushPlugin extends CordovaPlugin {
String extrasStr = data.isNull(5) ? "" : data.getString(5);
JSONObject extras = new JSONObject();
if (!extrasStr.isEmpty()) {
- extras = new JSONObject(extrasStr);
+ extras = new JSONObject(extrasStr);
}
JPushLocalNotification ln = new JPushLocalNotification();
@@ -478,17 +486,17 @@ public class JPushPlugin extends CordovaPlugin {
ln.setBroadcastTime(System.currentTimeMillis() + broadcastTime);
ln.setExtras(extras.toString());
- JPushInterface.addLocalNotification(cordovaActivity, ln);
+ JPushInterface.addLocalNotification(this.cordova.getActivity(), ln);
}
void removeLocalNotification(JSONArray data, CallbackContext callbackContext)
throws JSONException {
int notificationID = data.getInt(0);
- JPushInterface.removeLocalNotification(cordovaActivity, notificationID);
+ JPushInterface.removeLocalNotification(this.cordova.getActivity(), notificationID);
}
void clearLocalNotifications(JSONArray data, CallbackContext callbackContext) {
- JPushInterface.clearLocalNotifications(cordovaActivity);
+ JPushInterface.clearLocalNotifications(this.cordova.getActivity());
}
/**
@@ -502,47 +510,47 @@ public class JPushPlugin extends CordovaPlugin {
}
}
- /**
- * 设置通知静默时间
- * http://docs.jpush.io/client/android_api/#api_5
- */
- void setSilenceTime(JSONArray data, CallbackContext callbackContext) {
- try {
- int startHour = data.getInt(0);
- int startMinute = data.getInt(1);
- int endHour = data.getInt(2);
- int endMinute = data.getInt(3);
- if (!isValidHour(startHour) || !isValidMinute(startMinute)) {
- callbackContext.error("开始时间数值错误");
- return;
- }
- if(!isValidHour(endHour) || !isValidMinute(endMinute)) {
- callbackContext.error("结束时间数值错误");
- return;
- }
- JPushInterface.setSilenceTime(cordovaActivity, startHour, startMinute,
- endHour, endMinute);
- } catch (JSONException e) {
- e.printStackTrace();
- callbackContext.error("error: reading json data.");
- }
- }
+ /**
+ * 设置通知静默时间
+ * http://docs.jpush.io/client/android_api/#api_5
+ */
+ void setSilenceTime(JSONArray data, CallbackContext callbackContext) {
+ try {
+ int startHour = data.getInt(0);
+ int startMinute = data.getInt(1);
+ int endHour = data.getInt(2);
+ int endMinute = data.getInt(3);
+ if (!isValidHour(startHour) || !isValidMinute(startMinute)) {
+ callbackContext.error("开始时间数值错误");
+ return;
+ }
+ if (!isValidHour(endHour) || !isValidMinute(endMinute)) {
+ callbackContext.error("结束时间数值错误");
+ return;
+ }
+ JPushInterface.setSilenceTime(this.cordova.getActivity(), startHour, startMinute,
+ endHour, endMinute);
+ } catch (JSONException e) {
+ e.printStackTrace();
+ callbackContext.error("error: reading json data.");
+ }
+ }
- private boolean isValidHour(int hour) {
- return !(hour < 0 || hour > 23);
- }
+ private boolean isValidHour(int hour) {
+ return !(hour < 0 || hour > 23);
+ }
- private boolean isValidMinute(int minute) {
- return !(minute < 0 || minute > 59);
- }
+ private boolean isValidMinute(int minute) {
+ return !(minute < 0 || minute > 59);
+ }
- /**
- * 用于 Android 6.0 以上系统申请权限,具体可参考:
- * http://docs.Push.io/client/android_api/#android-60
- */
- void requestPermission(JSONArray data, CallbackContext callbackContext) {
- JPushInterface.requestPermission(cordovaActivity);
- }
+ /**
+ * 用于 Android 6.0 以上系统申请权限,具体可参考:
+ * http://docs.Push.io/client/android_api/#android-60
+ */
+ void requestPermission(JSONArray data, CallbackContext callbackContext) {
+ JPushInterface.requestPermission(this.cordova.getActivity());
+ }
private final TagAliasCallback mTagWithAliasCallback = new TagAliasCallback() {
@Override
@@ -558,7 +566,7 @@ public class JPushPlugin extends CordovaPlugin {
final String jsEvent = String.format(
"cordova.fireDocumentEvent('jpush.setTagsWithAlias',%s)",
data.toString());
- cordovaActivity.runOnUiThread(new Runnable() {
+ cordova.getActivity().runOnUiThread(new Runnable() {
@Override
public void run() {
instance.webView.loadUrl("javascript:" + jsEvent);
diff --git a/src/ios/Plugins/AppDelegate+JPush.m b/src/ios/Plugins/AppDelegate+JPush.m
index 5bee122..207a3d0 100644
--- a/src/ios/Plugins/AppDelegate+JPush.m
+++ b/src/ios/Plugins/AppDelegate+JPush.m
@@ -9,20 +9,29 @@
#import "AppDelegate+JPush.h"
#import "JPushPlugin.h"
#import "JPUSHService.h"
+#import
@implementation AppDelegate (JPush)
--(BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions{
- [JPushPlugin setLaunchOptions:launchOptions];
++(void)load{
- //cordova didFinishLaunchingWithOptions
- CGRect screenBounds = [[UIScreen mainScreen] bounds];
- self.window = [[UIWindow alloc] initWithFrame:screenBounds];
- self.viewController = [[CDVViewController alloc] init];
- self.window.rootViewController = self.viewController;
- self.window.autoresizesSubviews = YES;
- [self.window makeKeyAndVisible];
- return YES;
+ Method origin;
+ Method swizzle;
+
+ origin=class_getInstanceMethod([self class],@selector(init));
+ swizzle=class_getInstanceMethod([self class], @selector(init_plus));
+ method_exchangeImplementations(origin, swizzle);
+}
+
+-(instancetype)init_plus{
+ [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(applicationDidLaunch:) name:@"UIApplicationDidFinishLaunchingNotification" object:nil];
+ return [self init_plus];
+}
+
+-(void)applicationDidLaunch:(NSNotification *)notification{
+ if (notification) {
+ [JPushPlugin setLaunchOptions:notification.userInfo];
+ }
}
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
diff --git a/www/JPushPlugin.js b/www/JPushPlugin.js
index 6fa846b..64d273c 100644
--- a/www/JPushPlugin.js
+++ b/www/JPushPlugin.js
@@ -340,8 +340,16 @@ JPushPlugin.prototype.requestPermission = function() {
}
}
-JPushPlugin.prototype.setSilenceTime = function() {
-
+JPushPlugin.prototype.setSilenceTime = function(startHour, startMinute, endHour, endMinute) {
+ if (device.platform == "Android") {
+ this.call_native("setSilenceTime", [startHour, startMinute, endHour, endMinute], null);
+ }
+}
+
+JPushPlugin.prototype.setPushTime = function(weekdays, startHour, endHour) {
+ if (device.platform == "Android") {
+ this.call_native("setPushTime", [weekdays, startHour, endHour], null);
+ }
}
if(!window.plugins) {