xuchangda / jmessage-phonegap-plugin

JiGuang's officially supported JMessage PhoneGap/Cordova plugin (Android & iOS). 极光官方支持的 IM PhoneGap/Cordova 插件。

JMessage PhoneGap / Cordova Plugin

JMessage PhoneGap / Cordova Plugin 是基于极光 IM 的 Cordova 插件，目前支持 iOS 和 Android 平台。

除了支持 IM 功能外，还集成了 JPush PhoneGap Plugin 插件的功能，支持进行消息推送。

JMessage PhoneGap Plugin 和 JPush PhoneGap Plugin 这两个插件不能同时安装。

迁移到 JMessage Phonegap Plugin 前要先删除 JPush PhoneGap Plugin 插件，因为 JMessage PhoneGap Plugin 中已经包含了 JPush 的相关功能了。

QQ 交流群：413602425

有问题建议先到极光社区搜索提问。

集成步骤

• 在线安装

    cordova plugin add jmessage-phonegap-plugin --variable APP_KEY=Your_app_key
  

  或

    cordova plugin add https://github.com/jpush/jmessage-phonegap-plugin.git --variable APP_KEY=Your_app_key
  

• 本地安装

    cordova plugin add <Plugin Path> --variable APP_KEY=Your_app_key
  

  点击这里查看如何获取 APP_KEY。

API

API 分为 IM（聊天）和 Push（消息推送）两部分。具体可参考：

IM

• Android API
• iOS API

Push

• 公共 API
• Android API
• iOS API

Demo

插件项目中的 /example 目录下包含一个简单的示例，如果想参考可以将目录下的所有文件拷贝到具体 Cordova 项目的 /assets/www/ 目录下。

常见问题

若要使用 CLI 来编译项目，注意应使用 cordova compile 而不是 cordova build 命令，因为 cordova build 可能会清除对插件文件中 AndroidManifest.xml 文件的修改。 具体的 Cordova CLI 用法可参考 Cordova CLI 官方文档。

Android

• Eclipse 中 import PhoneGap 工程之后出现：Type CallbackContext cannot be resolved to a type。

解决方案：Eclipse 中右键单击工程名，Build Path -> Config Build Path -> Projects -> 选中工程名称 -> CordovaLib -> 点击 add。

• 若用命令行编译报错 -source 1.6，请修改项目中的 platforms/android/build.gradle 文件：

    ...
    compileOptions {
      sourceCompatibility JavaVersion.VERSION_1_7   // 1_6 改为 1_7
      targetCompatibility JavaVersion.VERSION_1_7   // 1_6 改为 1_7
    }
    ...
  

iOS

• 收不到推送：请首先按照正确方式再次配置证书、描述文件，可参考 iOS 证书设置指南。
• 设置 PushConfig.plist:
  • APP_KEY：应用标识
  • CHANNEL：渠道标识
  • IsProduction：是否为生产环境
  • IsIDFA：是否使用 IDFA 启动 SDK

更多

• QQ 群：413602425
• 极光官网文档
• 有问题可访问极光社区搜索和提问