React Native Android JPush消息推送集成

React Native JPush消息推送集成

写在前面

这是第一次利用马克飞象和印象笔记记录实际开发中的经验总结。回首过去几年的工作，在工作的经验的文字记录方面着实欠缺了很多，希望以后能将这个习惯保持下去。

正文

我之前一直从事Android原生应用的开发，前几个月公司有个新产品，决定使用React Native这种跨平台方式进行开发，也算是一个尝试。RN的这个项目由一位有RN开发经验的前端开发人员和一位IOS开发人员进行开发，因为我手里还有其他项目，所以没有一开始就参与到RN的开发当中去。因为其中一位同事是IOS的，所以开发过程中的测试一直是以IOS为主，当项目差不多要出来0.1版本的时候，Android版第三方SDK的集成还需要我这个Android原生开发去做，借此机会，我也就参与到RN的项目中了。

此次主要是RN项目两个第三方SDK（云信和JPush）中的JPush集成的经验总结，相对于集成云信，JPush的集成过程相对来说要简单得太多，总的来说基本上都是按照JPush官网Android SDK集成指南去做的，但是还是有一些坑值得记录一下。

集成步骤

JPush注册账号以及创建一个应用

注册账号这个好像没有什么好说的，登录极光官网点击右上角的注册按钮，接下来你就能看到下图所示的页面，输入常用邮箱和能记得住的密码。可能还需要开发者认证什么的，我去看了一下，我的账户应该是没有进行开发者认证，但是推送集成并不影响。

登录之后，通过右上角进入控制台

这个是我的个人的极光账号，如果是为公司开发项目，切记让经理去申请一个公司的账号，要不然都以后交接就很麻烦了。
如图我已经创建了几个应用用于测试了。新创建应用点击右上角的创建应用按钮。

在新打开的界面中输入你的app名称，如果我没记错的话，可以随便输个，和你要集成的app真实名称不一样也行，图标传不传看心情。

创建完毕之后，就可以拿到AppKey和Master Secret了，下面集成配置的时候需要用到

开始集成

集成推荐使用jcenter自动集成，这样子会少很多事，正如官网所说：

jcenter会帮我们做很多事情，而不需要我们动手,下面很多都是照搬官网的。

• 如果开发者需要修改组件属性，可以在本地的 AndroidManifest 中定义同名的组件并配置想要的属性，然后用 xmlns:tools 来控制本地组件覆盖 jcenter 上的组件。示例：
• 这个我没有需求用到

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.android.tests.flavorlib.app"
    xmlns:tools="http://schemas.android.com/tools">

    <application
        android:icon="@drawable/icon"
        android:name="com.example.jpushdemo.ExampleApplication"
        android:label="@string/app_name" >

        <service android:name="cn.jpush.android.service.PushService"
            android:process=":multiprocess"
            tools:node="replace" >

            ……
        service>

    ……
  application>

  ……
manifest>

• 确认android studio的 Project 根目录的主 gradle 中配置了jcenter支持。（新建project默认配置就支持）

buildscript {
    repositories {
        jcenter()
    }
    ......
}

allprojects {
    repositories {
        jcenter()
    }
}

• 在 module 的 gradle 中添加依赖和AndroidManifest的替换变量。
• 值得一说的是，JPush注册应用的时候并没有用到包名，applicationId这个属性是一般构建项目就默认自动带的，如果没有的话请自行按照你的应用的包名填写。
• 另外对于RN的项目，在ndk添加cpu类型的时候还有一些坑

android {
    ......
    defaultConfig {
        applicationId "com.xxx.xxx" //JPush上注册的包名.
        ......

        ndk {
            //选择要添加的对应cpu类型的.so库。 
            abiFilters 'armeabi', 'armeabi-v7a', 'arm64-v8a' 
            // 还可以添加 'x86', 'x86_64', 'mips', 'mips64'
        }

        manifestPlaceholders = [
            JPUSH_PKGNAME : applicationId,
            JPUSH_APPKEY : "你的appkey", //JPush上注册的包名对应的appkey.
            JPUSH_CHANNEL : "自定义渠道名称", //用户渠道统计的渠道名称
        ]
        ......
    }
    ......
}

dependencies {
    ......

    compile 'cn.jiguang.sdk:jpush:3.0.5'  // 此处以JPush 3.0.5 版本为例。
    compile 'cn.jiguang.sdk:jcore:1.1.2'  // 此处以JCore 1.1.2 版本为例。
    ......
}

• 最后一点，需要注意在Project根目录中的gradle.properties文件添加

android.useDeprecatedNdk=true

混淆配置

这个很重要，每集成一个第三方sdk，切记要配置混淆，要不然到后面正式release的时候出错，可能半天也找不到问题在哪里

-dontoptimize
-dontpreverify

-dontwarn cn.jpush.**
-keep class cn.jpush.** { *; }

-dontwarn cn.jiguang.**
-keep class cn.jiguang.** { *; }

#==================gson && protobuf==========================
-dontwarn com.google.**
-keep class com.google.gson.** {*;}
-keep class com.google.protobuf.** {*;}

在代码中的配置

• 在自定义的MyAppliCation.java的onCreate()添加初始化的代码

public class MyApplication extends Application {
@Override
    public void onCreate() {
        super.onCreate();
        JPushInterface.setDebugMode(true);
        JPushInterface.init(this);
    }
}

运行你的应用，检查JPush是否正常工作

• 过滤日志，检查在应用启动后JPush是否正常 工作，如果正常的话，会输出如下日志

      [JPushInterface] action:init
  
      .......
  
      [PushService] Login succeed!
  

• 而如果日志太多的话，可以使用ctrl+f对输出的日志进行搜索
  
• 记得过滤日志为Show only selected application，同时将调试的应用选成你的，如果输出没有问题的话，就可以尝试测试推送了

上面的都不是重点，下面的才是重点

开发过程中遇到的“坑”的总结

关于React Native的ndk配置

• React Native项目创建过程中，会自动生成相应的Android的project，开发RN的Android版，也都是使用这个project，下图是RN项目工程的示例
  
• 对于RN的Android版本的开发，实际上就是直接使用Android Studio打开图中的Android目录作为project。
• RN自动生成的Android项目，已经在app下的build.gradle中做了很多配置了，其中的ndk配置是这样的：

android {
    compileSdkVersion 23
    buildToolsVersion "23.0.1"

    defaultConfig {
        applicationId "com.awesomeproject"
        minSdkVersion 16
        targetSdkVersion 22
        versionCode 1
        versionName "1.0"
        ndk {
            abiFilters "armeabi-v7a", "x86"
        }
    }
    splits {
        abi {
            reset()
            enable enableSeparateBuildPerCPUArchitecture
            universalApk false  // If true, also generate a universal APK
            include "armeabi-v7a", "x86"
        }
    }
    buildTypes {
        release {
            minifyEnabled enableProguardInReleaseBuilds
            proguardFiles getDefaultProguardFile("proguard-android.txt"), "proguard-rules.pro"
        }
    }
    // applicationVariants are e.g. debug, release
    applicationVariants.all { variant ->
        variant.outputs.each { output ->
            // For each separate APK per architecture, set a unique version code as described here:
            // http://tools.android.com/tech-docs/new-build-system/user-guide/apk-splits
            def versionCodes = ["armeabi-v7a":1, "x86":2]
            def abi = output.getFilter(OutputFile.ABI)
            if (abi != null) {  // null for the universal-debug, universal-release variants
                output.versionCodeOverride =
                        versionCodes.get(abi) * 1048576 + defaultConfig.versionCode
            }
        }
    }
}

• 虽然和标题不相符，但是在这里还是要提一下，buildToolsVersion版本React Native中文官网建议必须使用23.0.1，但是经过我亲测，23.0.3也可以使用，但是25.0.0以上的就不要想了，会有一堆解决不掉的错误，我也不明白为什么
  
• 回到正文，如上面贴出来的RN自动生成的project中的app的build.gradle的ndk配置了”armeabi-v7a”, “x86”，但是JPush官网的集成指南中有三种，同时还有其他更多的cpu类型的支持
  
• 但是在RN的项目中，如果多配制那怕一种cpu类型，都会造成在运行的时候报错，我尝试着花费了不少时间去搜索解决方案，然并卵。因为按照之前的开发经验，一般都是配置第三方sdk建议的cpu类型，因为RN的问题，无法再这样做了。同时也因为我手头的测试机有限，对于cpu类型配置不全会造成什么影响还不得而知。

通知图标的自定义

• 在集成完成之后，终于可以愉快滴进行推送测试了，但是发现推送的图标却还是Android机器人，有些不美观。

• 按照官网的说明，JPush应该会自动使用的应用的图标最为通知栏推送的图标，但是实际运行下来发现并没有。我猜想可能是因为我的应用图标目录使用的是mipmap造成的，于是我新建了drawable-hdpi和drawable-xhdpi两个目录，按照JPush的要求，修改了图片的名称，下面这句是官网的说明：

      说明：若没有res/drawable-xxxx/jpush_notification_icon这个资源默认使用应用图标作为通知icon，在5.0以上系统将应用图标作为statusbar icon可能显示不正常，用户可定义没有阴影和渐变色的icon替换这个文件，文件名不要变
  

• 于是乎我就按照官网将名称修改为了jpush_notification_icon，但是重新运行程序发现没有用，卸载重新安装还是没有用。

• 机智的我警觉这里面应该是有坑的，于是我百度了一下，在yuanlvmao的博客–关于极光推送通知栏无法正确显示应用图标 找到了答案，，你没有看错，就是要重启一下手机就好了，于是乎我照做了，通知的图标终于正常显示了
  

全文毕。。。。

2017-07-03 3:04