Android SDK 集成指南

          android {
    defaultConfig {
        minSdkVersion 21
    }
}

        

          <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" >

  </application>

</manifest>

        

          dependencyResolutionManagement {
    repositories {
        google()
        maven {
            url = uri("https://maven.jiguang.cn/nexus/content/repositories/releases/")
        }
        mavenCentral()
    }
}

        

          allprojects {
    repositories {
        google()
        maven {
            url = uri("https://maven.jiguang.cn/nexus/content/repositories/releases/")
        }
        mavenCentral()
    }
}

        

          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 : "developer-default", //暂时填写默认值即可.
    ]
    ......
}
......
}

dependencies {
......

implementation 'cn.jiguang.sdk:jpush:6.x.x'        // 必选，此处填写当前最新发布版本（版本填写格式示例：6.2.0），注意：5.0.0 版本开始可以自动拉取 JCore 包，无需另外配置
implementation 'cn.jiguang.sdk:joperate:x.x.x'     // 可选，集成极光分析SDK后，即可支持行为触发推送消息、推送转化率统计，用户行为分析和用户标签等功能

}

        

          <provider tools:node="remove"
            android:exported="false"
            android:authorities="${applicationId}.jiguang.InitProvider"
            android:name="cn.jpush.android.service.InitProvider"></provider>

        

          implementation 'cn.jiguang.sdk:jpush:4.x.x'
implementation 'cn.jiguang.sdk:jcore:4.x.x'

        

          dependencies {
......

implementation 'cn.jiguang.sdk:jpush-google:6.x.x'  // 此处填写当前最新发布版本（版本填写格式示例：6.2.0）

}

        

          
implementation ('cn.jiguang.sdk:jpush-google:6.x.x'){  // 此处填写您实际集成版本（版本填写格式示例：6.2.0）
       exclude group: 'cn.jiguang.sdk', module: 'jcore-google'//会自动把 JCore 剔除
}

        

          <provider tools:node="remove"
            android:exported="false"
            android:authorities="${applicationId}.jiguang.InitProvider"
            android:name="cn.jpush.android.service.InitProvider"></provider>

        

          implementation 'cn.jiguang.sdk:jpush-google:4.x.x'
implementation 'cn.jiguang.sdk:jcore-google:4.x.x'

        

           <!-- Since JCore2.0.0 Required SDK核心功能-->
 <!-- 可配置android:process参数将Service放在其他进程中；android:enabled属性不能是false -->
 <!-- 这个是自定义Service，要继承极光JCommonService，可以在更多手机平台上使得推送通道保持的更稳定 -->
 <service android:name="xx.xx.XService"
         android:enabled="true"
         android:exported="false"
         android:process=":pushcore">
         <intent-filter>
             <action android:name="cn.jiguang.user.service.action" />
         </intent-filter>
 </service>

        

           <!-- Required since 3.0.7 -->
 <!-- 新的 tag/alias 接口结果返回需要开发者配置一个自定的广播 -->
 <!-- 3.3.0开始所有事件将通过该类回调 -->
 <!-- 该广播需要继承 JPush 提供的 JPushMessageReceiver 类, 并如下新增一个 Intent-Filter -->
 <receiver
       android:name="自定义 Receiver"
       android:enabled="true"
       android:exported="false" >
       <intent-filter>
            <!-- 从 JPush v5.4.0 版本开始，请特别注意 RECEIVER_MESSAGE 写法, 如配置错误则无法找到回调类 -->
            <action android:name="cn.jpush.android.intent.RECEIVER_MESSAGE" />
            <category android:name="您应用的包名" />
       </intent-filter>
 </receiver>

        

          NDK integration is deprecated in the current plugin. Consider trying the new experimental plugin

        

          android.useDeprecatedNdk=true

        

          A problem occurred starting process ‘command
‘/Users/xxx/Library/Android/sdk/ndk-bundle/toolchains/mips64el-linux-android-4.9/prebuilt
/darwin-x86_64/bin/mips64el-linux-android-strip”

系统找不到指定的文件

        

          android {

    defaultConfig {
        .....
    }

    packagingOptions {
        doNotStrip '*/mips/*.so'
        doNotStrip '*/mips64/*.so'
    }
}

        

              -dontoptimize
    -dontpreverify

    -dontwarn cn.jpush.**
    -keep class cn.jpush.** { *; }
    -keep class * extends cn.jpush.android.service.JPushMessageReceiver { *; }

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

        

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

        

          andResGuard {
   ...
    whiteList = [
        "R.xml.jpush*",
        "R.drawable.jpush*",
        "R.layout.jpush*",
        "R.layout.push*",
        "R.string.jg*",
        "R.style.MyDialogStyle",
        "R.style.JPushTheme"
    ]
    ...
}

        

          public static void init(Context context, JPushConfig config);

        

          // You can enable debug mode in developing state. You should close debug mode when release.
public static void setDebugMode(boolean debugEnalbed)

        

          public class ExampleApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        JPushInterface.setDebugMode(true);

      // 调整点一：调用启用推送业务功能代码前增加setAuth调用
      boolean isPrivacyReady; // app根据是否已弹窗获取隐私授权来赋值
      if(!isPrivacyReady){
        // JCore 5.0.4之前版本需要显式设置false
        if (JCoreInterface.getJCoreSDKVersionInt() < 504) { // 5.0.4版本号对应504
          JCollectionAuth.setAuth(context, false);
        }
        // 所有版本在未授权时都不应初始化SDK
        return;
      }
      JPushInterface.init(this);


      // 调整点二：App用户同意了隐私政策授权，并且开发者确定要开启推送服务后调用
      // JCore 5.0.4+会自动处理授权状态，可不需要显式设置true
      JCollectionAuth.setAuth(context, true);
      
    }
}

        

          [JPushInterface] action:init
.......
[ConnectingHelper] Login succeed

        

          JPushInterface.getRegistrationID(getContext());

        

          include ':jiguang'

        

          android {
    ......
    defaultConfig {
        applicationId "com.xxx.xxx" //JPush 上注册的包名.
        ......
        manifestPlaceholders = [
            JPUSH_PKGNAME : applicationId,
            JPUSH_APPKEY : "你的 Appkey ", //JPush 上注册的包名对应的 Appkey.
            JPUSH_CHANNEL : "developer-default", //暂时填写默认值即可.
        ]
        ......
    }
    ......
}

dependencies {
    ......
    implementation project(':jiguang')
    ......
}

        

          <!-- Since JCore2.0.0 Required SDK 核心功能 -->
<!-- 可配置 android:process 参数将 Service 放在其他进程中；android:enabled 属性不能是 false -->
<!-- 这个是自定义 Service，要继承极光 JCommonService，可以在更多手机平台上使得推送通道保持的更稳定 -->
<service
    android:name="xx.xx.XService"
    android:enabled="true"
    android:exported="false"
    android:process=":pushcore">
    <intent-filter>
        <action android:name="cn.jiguang.user.service.action" />
    </intent-filter>
</service>

<!-- Required since 3.0.7 -->
<!-- 新的 tag/alias 接口结果返回需要开发者配置一个自定的广播 -->
<!-- 3.3.0 开始所有事件将通过该类回调 -->
<!-- 该广播需要继承 JPush 提供的 JPushMessageReceiver 类，并如下新增一个 Intent-Filter -->
<receiver
    android:name="自定义 Receiver"
    android:enabled="true"
    android:exported="false">
    <intent-filter>
        <action android:name="cn.jpush.android.intent.RECEIVER_MESSAGE" />
        <category android:name="您应用的包名" />
    </intent-filter>
</receiver>

        

          dependencies {
    ......
    implementation fileTree(include: ['*.jar', '*.aar'], dir: 'libs')
    ......
}

        

          <manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">
    <application>
        <service
            android:name="cn.jpush.android.service.PushService"
            android:process=":mypush"
            tools:replace="android:process" />
    </application>
</manifest>

        

          defaultConfig {
    applicationId "cn.jpush.example" //您应用的包名
    ......
    manifestPlaceholders = [
        JPUSH_APPKEY : "您应用的 Appkey",
        JPUSH_CHANNEL : "developer-default",
    ]
}

        

          <?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    package="您应用的包名">

    <!-- Required -->
    <permission
        android:name="${applicationId}.permission.JPUSH_MESSAGE"
        android:protectionLevel="signature" />
    <uses-permission android:name="${applicationId}.permission.JPUSH_MESSAGE" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <!-- 适配 Android 13，弹出通知必须权限 -->
    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

    <!-- Optional. 为了提高 sdk 识别唯一用户的能力，保证消息推送的精准送达，建议集成以下权限 -->
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    <uses-permission android:name="android.permission.QUERY_ALL_PACKAGES" />
    <uses-permission android:name="android.permission.GET_TASKS" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

    <!-- Optional. 如您需要接入地理围栏业务，建议集成以下权限 -->
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

    <!-- Optional. 如您需要对应设备通知相关的能力，建议集成以下权限 -->
    <uses-permission android:name="com.huawei.android.launcher.permission.CHANGE_BADGE" /><!-- 华为角标 -->
    <uses-permission android:name="com.vivo.notification.permission.BADGE_ICON" /><!-- vivo 角标 -->
    <uses-permission android:name="com.hihonor.android.launcher.permission.CHANGE_BADGE" /><!-- honor 角标 -->
    <uses-permission android:name="com.oplus.notification.permission.BADGE_DIGITAL" /><!-- OPPO ColorOS 16+ 桌面数字角标，since 6.3.0 -->
    <uses-permission android:name="android.permission.VIBRATE" /><!-- 振动器权限，JPUSH 支持通知开启振动功能，小米推送必须 -->

    <!-- 扩展备用权限（可选） -->
    <permission android:name="${applicationId}.permission.JOPERATE_MESSAGE" android:protectionLevel="signature" />
    <uses-permission android:name="${applicationId}.permission.JOPERATE_MESSAGE" />

    <application
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:name="Your Application Name">

        <!-- Since JCore2.0.0 Required SDK 核心功能 -->
        <!-- 可配置 android:process 参数将 Service 放在其他进程中；android:enabled 属性不能是 false -->
        <!-- 这个是自定义 Service，要继承极光 JCommonService，可以在更多手机平台上使得推送通道保持的更稳定 -->
        <service
            android:name="xx.xx.XService"
            android:enabled="true"
            android:exported="false"
            android:process=":pushcore">
            <intent-filter>
                <action android:name="cn.jiguang.user.service.action" />
            </intent-filter>
        </service>

        <!-- Required since 3.0.7 -->
        <!-- 新的 tag/alias 接口结果返回需要开发者配置一个自定义的广播 -->
        <!-- 3.3.0 开始所有事件将通过该类回调 -->
        <!-- 该广播需要继承 JPush 提供的 JPushMessageReceiver 类，并如下新增一个 Intent-Filter -->
        <receiver
            android:name="自定义 Receiver"
            android:enabled="true"
            android:exported="false">
            <intent-filter>
                <action android:name="cn.jpush.android.intent.RECEIVER_MESSAGE" />
                <category android:name="${applicationId}" />
            </intent-filter>
        </receiver>

        <!-- ==================================================================
             以下 JPush SDK 核心组件已随 jpush-android aar 内的 AndroidManifest.xml 自动合并，
             接入方无需再声明：PushService、DataProvider、PushReceiver、PushActivity、PopWinActivity、
             AlarmReceiver、SchedulerReceiver、JNotifyActivity、JLocalNotifyActivity、JLocalNotifyReceiver、
             JTransitActivity、AsusPushMessageReceiver、InitProvider。
             如需把 PushService 放到其它进程等定制，请用 tools:replace / tools:node 覆盖。
             ================================================================== -->

        <!-- Required. AppKey copied from Portal -->
        <meta-data android:name="JPUSH_APPKEY" android:value="${JPUSH_APPKEY}" />
        <!-- Required. 渠道，暂时填写默认值即可 -->
        <meta-data android:name="JPUSH_CHANNEL" android:value="${JPUSH_CHANNEL}" />
    </application>
</manifest>