capacitor-jpush-core 0.0.1

package/CapacitorJpushCore.podspec

@@ -0,0 +1,19 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'CapacitorJpushCore'
+  s.version = package['version']
+  s.summary = package['description']
+  s.license = package['license']
+  s.homepage = package['repository']['url']
+  s.author = package['author']
+  s.source = { :git => package['repository']['url'], :tag => s.version.to_s }
+  s.source_files = 'ios/Sources/**/*.{swift,h,m,c,cc,mm,cpp}'
+  s.ios.deployment_target = '14.0'
+  s.dependency 'Capacitor'
+  s.dependency 'JPush', '~> 4.8.0'
+  s.swift_version = '5.1'
+
+end

package/Package.swift

@@ -0,0 +1,29 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+let package = Package(
+    name: "capacitor-jpush-core",
+    platforms: [.iOS(.v14)],
+    products: [
+        .library(
+            name: "capacitor-jpush-core",
+            targets: ["JPushPlugin"])
+    ],
+    dependencies: [
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "7.0.0")
+    ],
+    targets: [
+        .target(
+            name: "JPushPlugin",
+            dependencies: [
+                .product(name: "Capacitor", package: "capacitor-swift-pm"),
+                .product(name: "Cordova", package: "capacitor-swift-pm"),
+            ],
+            path: "ios/Sources/JPushPlugin"),
+        
+        .testTarget(
+            name: "JPushPluginTests",
+            dependencies: ["JPushPlugin"],
+            path: "ios/Tests/JPushPluginTests"),
+    ]
+)

package/README.md

@@ -0,0 +1,496 @@
+# capacitor-jpush-core
+
+极光推送Capacitor插件，支持Android和iOS平台的一些简单功能。
+
+## Install
+
+```bash
+npm install capacitor-jpush-core
+npx cap sync
+```
+
+## 平台支持
+
+| 功能 | iOS | Android | 备注 |
+|------|-----|---------|------|
+| 设置别名 | ✅ | ✅ | |
+| 删除别名 | ✅ | ✅ | |
+| 获取注册ID | ✅ | ✅ | |
+| 设置角标 | ✅ | ❌ | 未集成厂商通道 |
+| 通知接收 | ✅ | ✅ | |
+| 通知点击回调 | ✅ | ✅ | Android仅限App运行时 |
+| 自定义消息 | ✅ | ✅ | |
+| 权限检查 | ✅ | ✅ | |
+| 权限请求 | ✅ | ✅ | |
+
+## Capacitor.config 配置
+
+```json
+{
+    "plugins": {
+        "JPush": {
+            // 极光推送AppKey
+            "appKey": "your_app_key",
+            // 推送通道，默认值为default, 没统计需求随便填
+            "channel": "default",
+            // 是否为生产环境，默认值为false
+            "production": false,
+            // 进入App时是否自动清除角标，默认值为false
+            "activeClearBadge": false,
+            // 是否跟随App启动时自动注册极光推送，默认值为false
+            "iosAutoRegister": true
+        }
+    }
+}
+```
+
+## iOS 准备工作
+
+### xcode 配置
+- 在 sign & capabilities 中点击 `+ capability` 按钮，搜索并添加 `Background Modes` 和 `Push Notifications` 选项。
+- 在 `Background Modes` 中勾选 `Remote notifications` 子项。
+
+### AppDelegate 基础配置
+在主工程的`AppDelegate`以下代理方法中，添加发送通知的代码
+```swift
+class AppDelegate: UIResponder, UIApplicationDelegate {
+
+    func applicationDidBecomeActive(_ application: UIApplication) {
+        // 从后台到前台，包括冷启动都会进入这个方法
+        NotificationCenter.default.post(name: UIApplication.didBecomeActiveNotification, object: nil)
+    }
+
+    func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
+        // 通知设备注册成功的消息
+        NotificationCenter.default.post(name: .capacitorDidRegisterForRemoteNotifications, object: deviceToken)
+    }
+    func application(_ application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: Error) {
+        // 通知设备注册失败的消息
+        NotificationCenter.default.post(name: .capacitorDidFailToRegisterForRemoteNotifications, object: error)
+    }
+}
+```
+
+### 推送唤醒
+- 当应用在后台收到远程推送时，会触发 `application(_:didReceiveRemoteNotification:fetchCompletionHandler:)` 方法。
+如果需要增加该消息处理，需要在 `AppDelegate` 中添加以下代码和通知扩展，插件就能把该推送传给web层的接收消息监听`JPushEventName.NotificationReceived`。
+```swift
+class AppDelegate: UIResponder, UIApplicationDelegate {
+    func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
+
+        NotificationCenter.default.post(name: .didReceiveRemotePush, object: userInfo)
+        completionHandler(.newData)
+    }
+}
+// 注意: 包括这个事件的定义也要复制进去
+extension NSNotification.Name {
+    static let didReceiveRemotePush = NSNotification.Name("CapacitorJPushCoreBackgroundPush")
+}
+```
+注意：后端发的推送需要配置[推送唤醒](https://docs.jiguang.cn/jpush/console/push_manage/creat#高级设置)
+
+### 未运行时点击推送消息
+如果需要处理回调的话，Capacitor.config 配置文件需要设置`iosAutoRegister`为`true`。必须在启动时就注册极光推送，否则本次点击推送消息不会触发后续在应用中添加的监听。
+```json
+{
+    "plugins": {
+        "JPush": {
+            "iosAutoRegister": true
+        }
+    }
+}
+```
+
+## Android 准备工作
+
+我们使用capacitor配置，但是这里JPush需要一些元数据的占位符。
+在 Android 项目的 app/build.gradle 文件中，找到 android.defaultConfig 或对应 productFlavor 块，添加以下 manifestPlaceholders 配置：
+```gradle
+defaultConfig {
+    manifestPlaceholders = [
+        JPUSH_PKGNAME: applicationId,
+        JPUSH_APPKEY: "",
+        JPUSH_CHANNEL: "default"
+    ]
+}
+```
+
+## API
+
+<docgen-index>
+
+* [`setupJPush()`](#setupjpush)
+* [`getRegistrationID()`](#getregistrationid)
+* [`setAlias(...)`](#setalias)
+* [`deleteAlias(...)`](#deletealias)
+* [`setTags(...)`](#settags)
+* [`addTags(...)`](#addtags)
+* [`deleteTags(...)`](#deletetags)
+* [`cleanTags()`](#cleantags)
+* [`checkPermissions()`](#checkpermissions)
+* [`requestPermissions()`](#requestpermissions)
+* [`setBadge(...)`](#setbadge)
+* [`addListener(JPushEventName.NotificationReceived, ...)`](#addlistenerjpusheventnamenotificationreceived-)
+* [`addListener(JPushEventName.NotificationOpened, ...)`](#addlistenerjpusheventnamenotificationopened-)
+* [`addListener(JPushEventName.CustomMessageReceived, ...)`](#addlistenerjpusheventnamecustommessagereceived-)
+* [`addListener(JPushEventName.RegistrationCompleted, ...)`](#addlistenerjpusheventnameregistrationcompleted-)
+* [`addListener(JPushEventName.RegistrationFailed, ...)`](#addlistenerjpusheventnameregistrationfailed-)
+* [Interfaces](#interfaces)
+* [Type Aliases](#type-aliases)
+* [Enums](#enums)
+
+</docgen-index>
+
+<docgen-api>
+<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
+
+### setupJPush()
+
+```typescript
+setupJPush() => Promise<void>
+```
+
+--------------------
+
+
+### getRegistrationID()
+
+```typescript
+getRegistrationID() => Promise<RegistrationIDResult>
+```
+
+**Returns:** <code>Promise&lt;<a href="#registrationidresult">RegistrationIDResult</a>&gt;</code>
+
+--------------------
+
+
+### setAlias(...)
+
+```typescript
+setAlias(options: AliasOptions) => Promise<void>
+```
+
+| Param         | Type                                                  |
+| ------------- | ----------------------------------------------------- |
+| **`options`** | <code><a href="#aliasoptions">AliasOptions</a></code> |
+
+--------------------
+
+
+### deleteAlias(...)
+
+```typescript
+deleteAlias(options?: DeleteAlias | undefined) => Promise<void>
+```
+
+| Param         | Type                                                |
+| ------------- | --------------------------------------------------- |
+| **`options`** | <code><a href="#deletealias">DeleteAlias</a></code> |
+
+--------------------
+
+
+### setTags(...)
+
+```typescript
+setTags(options: SetTagsOptions) => Promise<void>
+```
+
+| Param         | Type                                                      |
+| ------------- | --------------------------------------------------------- |
+| **`options`** | <code><a href="#settagsoptions">SetTagsOptions</a></code> |
+
+--------------------
+
+
+### addTags(...)
+
+```typescript
+addTags(options: SetTagsOptions) => Promise<void>
+```
+
+| Param         | Type                                                      |
+| ------------- | --------------------------------------------------------- |
+| **`options`** | <code><a href="#settagsoptions">SetTagsOptions</a></code> |
+
+--------------------
+
+
+### deleteTags(...)
+
+```typescript
+deleteTags(options: SetTagsOptions) => Promise<void>
+```
+
+| Param         | Type                                                      |
+| ------------- | --------------------------------------------------------- |
+| **`options`** | <code><a href="#settagsoptions">SetTagsOptions</a></code> |
+
+--------------------
+
+
+### cleanTags()
+
+```typescript
+cleanTags() => Promise<void>
+```
+
+--------------------
+
+
+### checkPermissions()
+
+```typescript
+checkPermissions() => Promise<PermissionStatus>
+```
+
+**Returns:** <code>Promise&lt;<a href="#permissionstatus">PermissionStatus</a>&gt;</code>
+
+--------------------
+
+
+### requestPermissions()
+
+```typescript
+requestPermissions() => Promise<PermissionStatus>
+```
+
+**Returns:** <code>Promise&lt;<a href="#permissionstatus">PermissionStatus</a>&gt;</code>
+
+--------------------
+
+
+### setBadge(...)
+
+```typescript
+setBadge(options: SetBadgeOptions) => Promise<void>
+```
+
+| Param         | Type                                                        |
+| ------------- | ----------------------------------------------------------- |
+| **`options`** | <code><a href="#setbadgeoptions">SetBadgeOptions</a></code> |
+
+--------------------
+
+
+### addListener(JPushEventName.NotificationReceived, ...)
+
+```typescript
+addListener(eventName: JPushEventName.NotificationReceived, listener: (data: PushNotificationData) => void) => Promise<PluginListenerHandle>
+```
+
+| Param           | Type                                                                                     |
+| --------------- | ---------------------------------------------------------------------------------------- |
+| **`eventName`** | <code><a href="#jpusheventname">JPushEventName.NotificationReceived</a></code>           |
+| **`listener`**  | <code>(data: <a href="#pushnotificationdata">PushNotificationData</a>) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### addListener(JPushEventName.NotificationOpened, ...)
+
+```typescript
+addListener(eventName: JPushEventName.NotificationOpened, listener: (data: PushNotificationData) => void) => Promise<PluginListenerHandle>
+```
+
+| Param           | Type                                                                                     |
+| --------------- | ---------------------------------------------------------------------------------------- |
+| **`eventName`** | <code><a href="#jpusheventname">JPushEventName.NotificationOpened</a></code>             |
+| **`listener`**  | <code>(data: <a href="#pushnotificationdata">PushNotificationData</a>) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### addListener(JPushEventName.CustomMessageReceived, ...)
+
+```typescript
+addListener(eventName: JPushEventName.CustomMessageReceived, listener: (data: CustomMessageData) => void) => Promise<PluginListenerHandle>
+```
+
+| Param           | Type                                                                               |
+| --------------- | ---------------------------------------------------------------------------------- |
+| **`eventName`** | <code><a href="#jpusheventname">JPushEventName.CustomMessageReceived</a></code>    |
+| **`listener`**  | <code>(data: <a href="#custommessagedata">CustomMessageData</a>) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### addListener(JPushEventName.RegistrationCompleted, ...)
+
+```typescript
+addListener(eventName: JPushEventName.RegistrationCompleted, listener: (data: RegistrationCompletedData) => void) => Promise<PluginListenerHandle>
+```
+
+| Param           | Type                                                                                               |
+| --------------- | -------------------------------------------------------------------------------------------------- |
+| **`eventName`** | <code><a href="#jpusheventname">JPushEventName.RegistrationCompleted</a></code>                    |
+| **`listener`**  | <code>(data: <a href="#registrationcompleteddata">RegistrationCompletedData</a>) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### addListener(JPushEventName.RegistrationFailed, ...)
+
+```typescript
+addListener(eventName: JPushEventName.RegistrationFailed, listener: (data: RegistrationFailedData) => void) => Promise<PluginListenerHandle>
+```
+
+| Param           | Type                                                                                         |
+| --------------- | -------------------------------------------------------------------------------------------- |
+| **`eventName`** | <code><a href="#jpusheventname">JPushEventName.RegistrationFailed</a></code>                 |
+| **`listener`**  | <code>(data: <a href="#registrationfaileddata">RegistrationFailedData</a>) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
+### Interfaces
+
+
+#### RegistrationIDResult
+
+| Prop                 | Type                |
+| -------------------- | ------------------- |
+| **`registrationID`** | <code>string</code> |
+
+
+#### AliasOptions
+
+| Prop        | Type                |
+| ----------- | ------------------- |
+| **`alias`** | <code>string</code> |
+| **`seq`**   | <code>number</code> |
+
+
+#### DeleteAlias
+
+| Prop      | Type                |
+| --------- | ------------------- |
+| **`seq`** | <code>number</code> |
+
+
+#### SetTagsOptions
+
+| Prop       | Type                  |
+| ---------- | --------------------- |
+| **`tags`** | <code>string[]</code> |
+| **`seq`**  | <code>number</code>   |
+
+
+#### PermissionStatus
+
+权限状态接口
+
+| Prop             | Type                                                                      | Description                                                                         |
+| ---------------- | ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
+| **`permission`** | <code>'prompt' \| 'prompt-with-rationale' \| 'granted' \| 'denied'</code> | 权限状态 - prompt: 首次申请，询问 - prompt-with-rationale：每次都询问 - granted：已获取权限 - denied：权限已拒绝 |
+
+
+#### SetBadgeOptions
+
+| Prop        | Type                |
+| ----------- | ------------------- |
+| **`badge`** | <code>number</code> |
+
+
+#### PluginListenerHandle
+
+| Prop         | Type                                      |
+| ------------ | ----------------------------------------- |
+| **`remove`** | <code>() =&gt; Promise&lt;void&gt;</code> |
+
+
+#### PushNotificationData
+
+| Prop                 | Type                                                         |
+| -------------------- | ------------------------------------------------------------ |
+| **`title`**          | <code>string</code>                                          |
+| **`body`**           | <code>string</code>                                          |
+| **`subtitle`**       | <code>string</code>                                          |
+| **`badge`**          | <code>number</code>                                          |
+| **`sound`**          | <code>string</code>                                          |
+| **`extras`**         | <code><a href="#record">Record</a>&lt;string, any&gt;</code> |
+| **`messageId`**      | <code>string</code>                                          |
+| **`notificationId`** | <code>number</code>                                          |
+| **`type`**           | <code>'notification' \| 'custom' \| 'silent'</code>          |
+| **`rawData`**        | <code><a href="#record">Record</a>&lt;string, any&gt;</code> |
+
+
+#### CustomMessageData
+
+| Prop            | Type                                                         |
+| --------------- | ------------------------------------------------------------ |
+| **`title`**     | <code>string</code>                                          |
+| **`body`**      | <code>string</code>                                          |
+| **`extras`**    | <code><a href="#record">Record</a>&lt;string, any&gt;</code> |
+| **`messageId`** | <code>string</code>                                          |
+| **`type`**      | <code>'notification' \| 'custom' \| 'silent'</code>          |
+
+
+#### RegistrationCompletedData
+
+| Prop                 | Type                |
+| -------------------- | ------------------- |
+| **`registrationID`** | <code>string</code> |
+
+
+#### RegistrationFailedData
+
+| Prop               | Type                |
+| ------------------ | ------------------- |
+| **`errorCode`**    | <code>number</code> |
+| **`errorMessage`** | <code>string</code> |
+
+
+### Type Aliases
+
+
+#### Record
+
+Construct a type with a set of properties K of type T
+
+<code>{
 [P in K]: T;
 }</code>
+
+
+### Enums
+
+
+#### JPushEventName
+
+| Members                     | Value                                | Description |
+| --------------------------- | ------------------------------------ | ----------- |
+| **`NotificationReceived`**  | <code>'notificationReceived'</code>  | 通知接收事件      |
+| **`NotificationOpened`**    | <code>'notificationOpened'</code>    | 通知点击事件      |
+| **`CustomMessageReceived`** | <code>'customMessageReceived'</code> | 自定义消息接收事件   |
+| **`RegistrationCompleted`** | <code>'registrationCompleted'</code> | 注册完成事件      |
+| **`RegistrationFailed`**    | <code>'registrationFailed'</code>    | 注册失败事件      |
+
+</docgen-api>
+
+## 开发依赖
+
+- Capacitor 7 配套设施
+- Node.js 20+
+- TypeScript: ^5.9.3
+
+各平台要求，参考[capacitor7文档](https://capacitorjs.com/docs/updating/7-0)
+
+- iOS 14+
+- xcode 16+
+- swift 5.9+
+
+- Android 6.0+
+- android studio 2024.2.1+
+- Java JDK 21
+- gradle plugin to 8.7.2
+- gradle wrapper to 8.11.1
+- kotlin 1.9.25

package/android/build.gradle

@@ -0,0 +1,79 @@
+ext {
+    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
+    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.0'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.2.1'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.6.1'
+    // 极光推送SDK版本，会自动带出相应版本的JCore；
+    jpushVersion = '5.9.0'
+}
+
+buildscript {
+    // 关键：在 buildscript 内部声明 kotlinVersion（供构建脚本依赖使用）
+    ext {
+        kotlinVersion = project.hasProperty('kotlin_version') ? rootProject.ext.kotlin_version : '1.9.25'
+    }
+
+    repositories {
+        maven {
+            url "https://maven.aliyun.com/repository/google"
+        }
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.7.2'
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${kotlinVersion}"
+    }
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'org.jetbrains.kotlin.android'
+
+android {
+    namespace "com.capacitor.jpush.core"
+    compileSdk project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 35
+    defaultConfig {
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 23
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 35
+        versionCode 1
+        versionName "1.0"
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+    lintOptions {
+        abortOnError false
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_21
+        targetCompatibility JavaVersion.VERSION_21
+    }
+    kotlinOptions {
+        jvmTarget = '21'
+    }
+}
+
+repositories {
+    maven {
+        url "https://maven.aliyun.com/repository/google"
+    }
+    google()
+    mavenCentral()
+}
+
+dependencies {
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation project(':capacitor-android')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:${kotlinVersion}"
+    testImplementation "junit:junit:$junitVersion"
+    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
+    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
+    
+    // 极光 5.0.0 版本开始可以自动拉取 JCore
+    implementation "cn.jiguang.sdk:jpush:$jpushVersion"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+    <!-- 极光推送所需权限 -->
+    <!-- Required  Required 一些系统要求的权限，如访问网络等 -->
+    <uses-permission android:name="android.permission.INTERNET" />
+    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
+    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
+    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
+    <uses-permission android:name="android.permission.WAKE_LOCK" />
+
+    <!-- Required 用于获取手机设备标识 -->
+    <uses-permission
+        android:name="android.permission.READ_PRIVILEGED_PHONE_STATE"
+        tools:ignore="ProtectedPermissions" />
+
+    <!-- Optional 推送功能 -->
+    <uses-permission android:name="android.permission.VIBRATE" />
+    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
+    <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
+    <uses-permission android:name="android.permission.DOWNLOAD_WITHOUT_NOTIFICATION" />
+
+    <!-- Android 13+ 推送通知权限 -->
+    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
+
+    <!--  华为&荣耀的角标  -->
+    <uses-permission android:name="com.huawei.android.launcher.permission.CHANGE_BADGE " />
+    <uses-permission android:name="com.hihonor.android.launcher.permission.CHANGE_BADGE" />
+    <!--  小米 MIUI 6 及以上设备支持数字角标，小米系统自动处理数字角标展示功能，默认收到通知+1处理，打开 App 清零。  -->
+    <!--  vivo 设备仅支持走极光通道时可以显示角标。  -->
+    <uses-permission android:name="com.vivo.notification.permission.BADGE_ICON" />
+
+    <application>
+
+        <!-- 推送接收器） -->
+        <receiver
+            android:name=".JPushReceiver"
+            android:enabled="true"
+            android:exported="false">
+            <intent-filter>
+                <!-- JPushMessageReceiver 只需要这个action -->
+                <action android:name="cn.jpush.android.intent.RECEIVER_MESSAGE" />
+                <category android:name="${applicationId}" />
+            </intent-filter>
+        </receiver>
+
+        <!-- 自定义JPush Service，继承自JCommonService（可选，用于扩展功能） -->
+        <service
+            android:name=".JPushService"
+            android:enabled="true"
+            android:exported="false">
+            <intent-filter>
+                <action android:name="cn.jiguang.user.service.action" />
+            </intent-filter>
+        </service>
+
+    </application>
+
+</manifest>