uniapp轻松集成极光推送SDK（本地插件集成和离线打包两种）

已于 2022-06-28 10:23:05 修改
阅读量9.1k 收藏 25
点赞数 5
分类专栏： uniapp
于 2022-04-07 20:39:02 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_43351090/article/details/124021474
版权

uniapp 极光推送 离线打包 Android 配置教程
关键词由CSDN通过智能技术生成

文章目录

一、先在uniapp的插件市场下载

点击直达

二、本地插件配置（可在控制台看到打印信息，方便测试）

1.配置本地插件信息

在这里插入图片描述

1.1 厂商信息需要在各个厂商注册后，然后填写，用处为：可在离线时，发送通知。

在这里插入图片描述

1.2 在本地插件的page.json中，配置安卓和ios的appKey和厂商id（若不配置，仅支持在线通知）：

在这里插入图片描述

2.配置manifest.json信息

在manifest.json的源码视图中配置如下信息：

1、2、3步代码保持一致，4、5步填写ios、安卓对应的appkey

在这里插入图片描述

 /* android打包配置 */
            "android" : {
                "permissions" : [
                    "<uses-feature android:name=\"android.hardware.camera\"/>",
                    "<uses-feature android:name=\"android.hardware.camera.autofocus\"/>",
                    "<uses-permission android:name=\"android.permission.ACCESS_NETWORK_STATE\"/>",
                    "<uses-permission android:name=\"android.permission.ACCESS_WIFI_STATE\"/>",
                    "<uses-permission android:name=\"android.permission.CALL_PHONE\"/>",
                    "<uses-permission android:name=\"android.permission.CAMERA\"/>",
                    "<uses-permission android:name=\"android.permission.CHANGE_NETWORK_STATE\"/>",
                    "<uses-permission android:name=\"android.permission.CHANGE_WIFI_STATE\"/>",
                    "<uses-permission android:name=\"android.permission.FLASHLIGHT\"/>",
                    "<uses-permission android:name=\"android.permission.GET_ACCOUNTS\"/>",
                    "<uses-permission android:name=\"android.permission.MOUNT_UNMOUNT_FILESYSTEMS\"/>",
                    "<uses-permission android:name=\"android.permission.READ_LOGS\"/>",
                    "<uses-permission android:name=\"android.permission.READ_PHONE_STATE\"/>",
                    "<uses-permission android:name=\"android.permission.VIBRATE\"/>",
                    "<uses-permission android:name=\"android.permission.WAKE_LOCK\"/>",
                    "<uses-permission android:name=\"android.permission.WRITE_SETTINGS\"/>"
                ],
                "abiFilters" : [ "armeabi-v7a", "x86" ]
            },
            /* ios打包配置 */
            "ios" : {
                "privacyDescription" : {
                    "NSLocationAlwaysAndWhenInUseUsageDescription" : "This app requires location services to work",
                    "NSLocationAlwaysUsageDescription" : "This app requires location services to work",
                    "NSLocationWhenInUseUsageDescription" : "This app requires location services to work"
                },
                "UIBackgroundModes" : "remote-notification,voip,fetch,location",
                "idfa" : true
            },
            /* ios打包配置 */
            "sdkConfigs" : {
                "ad" : {},
                "push" : {},
                "geolocation" : {},
                "maps" : {}
            },

7、8、11、12配置安卓和ios的appKey,9,10配置安卓的包名和ios的bundle_id

在这里插入图片描述

下面的JG-JPush配置相同，就不一一列举。

再放一段参考代码：

    "nativePlugins" : {
            "JG-JCore" : {
                "JPUSH_APPKEY_ANDROID" : "appkey注册时获取",
                "JPUSH_APPKEY_IOS" : "appkey注册时获取",
                "JPUSH_CHANNEL_IOS" : "developer-default",
                "JPUSH_CHANNEL_ANDROID" : "developer-default",
                "__plugin_info__" : {
                    "name" : "JG-JCore",
                    "description" : "极光推送JCore插件",
                    "platforms" : "Android,iOS",
                    "url" : "",
                    "android_package_name" : "com.xxx.com",
                    "ios_bundle_id" : "com.xxxaaa.com",
                    "isCloud" : false,
                    "bought" : -1,
                    "pid" : "",
                    "parameters" : {
                        "JPUSH_APPKEY_ANDROID" : {
                            "des" : "appkey注册时获取",
                            "key" : "JPUSH_APPKEY",
                            "value" : "appkey"
                        },
                        "JPUSH_APPKEY_IOS" : {
                            "des" : "appkey注册时获取",
                            "key" : "JCore:APP_KEY",
                            "value" : "appkey"
                        },
                        "JPUSH_CHANNEL_IOS" : {
                            "des" : "developer-default",
                            "key" : "JCore:CHANNEL",
                            "value" : "developer-default"
                        },
                        "JPUSH_CHANNEL_ANDROID" : {
                            "des" : "developer-default",
                            "key" : "JPUSH_CHANNEL",
                            "value" : "developer-default"
                        }
                    }
                }
            },
            "JG-JPush" : {
                "JPUSH_XIAOMI_APPKEY" : "",
                "JPUSH_MEIZU_APPID" : "",
                "JPUSH_OPPO_APPSECRET" : "",
                "JPUSH_OPPO_APPKEY" : "",
                "JPUSH_ADVERTISINGID_IOS" : "",
                "JPUSH_MEIZU_APPKEY" : "",
                "JPUSH_OPPO_APPID" : "",
                "JPUSH_DEFAULTINITJPUSH_IOS" : "",
                "JPUSH_VIVO_APPKEY" : "",
                "JPUSH_VIVO_APPID" : "",
                "JPUSH_ISPRODUCTION_IOS" : "false",
                "JPUSH_XIAOMI_APPID" : "",
                "JPUSH_HUAWEI_APPID" : "",
                "__plugin_info__" : {
                    "name" : "JG-JPush",
                    "description" : "极光推送Hbuilder插件",
                    "platforms" : "Android,iOS",
                    "url" : "",
                    "android_package_name" : "com.xxx.com",
                    "ios_bundle_id" : "com.xxxaaa.com",
                    "isCloud" : false,
                    "bought" : -1,
                    "pid" : "",
                    "parameters" : {
                        "JPUSH_XIAOMI_APPKEY" : {
                            "des" : "",
                            "key" : "XIAOMI_APPKEY",
                            "value" : ""
                        },
                        "JPUSH_MEIZU_APPID" : {
                            "des" : "",
                            "key" : "MEIZU_APPID",
                            "value" : ""
                        },
                        "JPUSH_OPPO_APPSECRET" : {
                            "des" : "",
                            "key" : "OPPO_APPSECRET",
                            "value" : ""
                        },
                        "JPUSH_OPPO_APPKEY" : {
                            "des" : "",
                            "key" : "OPPO_APPKEY",
                            "value" : ""
                        },
                        "JPUSH_ADVERTISINGID_IOS" : {
                            "des" : "",
                            "key" : "JPush:ADVERTISINGID",
                            "value" : ""
                        },
                        "JPUSH_MEIZU_APPKEY" : {
                            "des" : "",
                            "key" : "MEIZU_APPKEY",
                            "value" : ""
                        },
                        "JPUSH_OPPO_APPID" : {
                            "des" : "",
                            "key" : "OPPO_APPID",
                            "value" : ""
                        },
                        "JPUSH_DEFAULTINITJPUSH_IOS" : {
                            "des" : "false",
                            "key" : "JPush:DEFAULTINITJPUSH",
                            "value" : ""
                        },
                        "JPUSH_VIVO_APPKEY" : {
                            "des" : "",
                            "key" : "com.vivo.push.api_key",
                            "value" : ""
                        },
                        "JPUSH_VIVO_APPID" : {
                            "des" : "",
                            "key" : "com.vivo.push.app_id",
                            "value" : ""
                        },
                        "JPUSH_ISPRODUCTION_IOS" : {
                            "des" : "false",
                            "key" : "JPush:ISPRODUCTION",
                            "value" : ""
                        },
                        "JPUSH_XIAOMI_APPID" : {
                            "des" : "",
                            "key" : "XIAOMI_APPID",
                            "value" : ""
                        },
                        "JPUSH_HUAWEI_APPID" : {
                            "des" : "",
                            "key" : "com.huawei.hms.client.appid",
                            "value" : ""
                        }
                    }
                }
            }
        }

3.配置自定义基座包（Android、iOS）

iOS打包勾选上后修改bundle id并且上传证书即可
在这里插入图片描述
在这里插入图片描述

4.运行测试

选择自定义基座–>选择与电脑连接的手机设备(或者模拟器)–>点击运行
在这里插入图片描述

三、离线打包集成（安卓，官方参考文档）

ios可参考这个博客

1、生成离线打包资源
1.在菜单栏中选中 “发行” --> “原生App-本地打包” --> “生成本地打包App资源”

在这里插入图片描述

2.在项目目录下的"unpackage" --> "resources"目录下会生成资源文件
在这里插入图片描述

2、下载离线打包SDK
2.1 下载地址
https://nativesupport.dcloud.net.cn/AppDocs/download/android
注意：SDK版本需要与HbuilderX版本对应才能正常运行项目，否则可能造成兼容问题。
2.2 查看HbuilderX版本
在菜单栏中选点击 “帮助”–>“关于”,查看弹窗即可看到版本号
在这里插入图片描述

2.3 下载SDK
下载跟自己HBuilderX版本号相同的SDK
在这里插入图片描述

3、离线打包工程配置
3.1 打开 UniPlugin-Hello-AS 工程
使用Android Stuido打开UniPlugin-Hello-AS工程
在这里插入图片描述

3.2 导入离线打包资源
将项目中app/src/main/assets/apps/目录下的文件删除，并且替换为HBuilderX中生成的离线打包资源
在这里插入图片描述

3.3 修改dcloud_control.xml
将dcloud_control.xml中的appid修改成与离线打包资源文件夹同名
在这里插入图片描述

3.4 删除无用模块
在这里插入图片描述

4、集成推送插件
4.1 修改applicationId
将app/build.gradle文件中的applicationId修改为认证时申请的包名
在这里插入图片描述

将AndroidManifest.xml中的package修改为认证时申请的包名
在这里插入图片描述

4.2 配置打包签名文件
在app/build.gradle中的android{}里面添加签名信息（使用自己的签名文件或者云端证书都可）

 signingConfigs {
        release {
            keyAlias 'push'
            keyPassword '123456'
            storeFile file('./push.jks')
            storePassword '123456'
        }

        debug {
            keyAlias 'push'
            keyPassword '123456'
            storeFile file('./push.jks')
            storePassword '123456'
        }
 }

在这里插入图片描述

在app/build.gradle中的buildTypes{}里面添加打包时指定的签名文件

buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
            signingConfig signingConfigs.release
        }

        debug {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
            signingConfig signingConfigs.debug
        }
}

在这里插入图片描述

4.3 配置插件信息
打开dcloud_uniplugins.json文件填写插件信息
插件信息在HBuilderX项目nativeplugins/JG-JCore/package.json、nativeplugins/JG-JPush/package.json中查看

{
  "nativePlugins": [
    {
      "plugins": [
        {
          "type": "module",
          "name": "JG-JCore",
          "class": "cn.jiguang.uniplugin_jcore.JCoreModule"
        },
        {
          "type": "module",
          "name": "JG-JPush",
          "class": "cn.jiguang.uniplugin_jpush.JPushModule"
        }
      ],
      "integrateType": "aar",
      "minSdkVersion": "16"
    }
  ]
}

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

4.4 导入推送插件依赖库
将JPush_Hbuilder_Demo中的依赖包复制到UniPlugin-Hello-AS项目中的app/libs目录下
在这里插入图片描述

在这里插入图片描述

4.5 配置极光和厂商参数
注意：以下参数替换为自己的参数

manifestPlaceholders = [
                JPUSH_PKGNAME : "pub.kilo.thirdpush",
                JPUSH_APPKEY  : "xx", //JPush 上注册的包名对应的 Appkey.
                JPUSH_CHANNEL : "developer-default", //暂时填写默认值即可.
                XIAOMI_APPKEY : "MI-xx",//小米平台注册的appkey
                XIAOMI_APPID  : "MI-xx",//小米平台注册的appid
                OPPO_APPKEY   : "OP-xx", // OPPO平台注册的appkey
                OPPO_APPID    : "OP-xx", // OPPO平台注册的appid
                OPPO_APPSECRET: "OP-xx",//OPPO平台注册的appsecret
                VIVO_APPKEY   : "xx", // VIVO平台注册的appkey
                VIVO_APPID    : "xx", // VIVO平台注册的appid
                MEIZU_APPKEY  : "MZ-xx", // 魅族平台注册的appkey
                MEIZU_APPID   : "MZ-xx", // 魅族平台注册的appid
]
<meta-data
	android:name="JPUSH_APPKEY"
	android:value="${JPUSH_APPKEY}" />
<meta-data
	android:name="JPUSH_CHANNEL"
	android:value="${JPUSH_CHANNEL}" />

<meta-data
	android:name="XIAOMI_APPKEY"
	android:value="${XIAOMI_APPKEY}" />
<meta-data
	android:name="XIAOMI_APPID"
	android:value="${XIAOMI_APPID}" />

<meta-data
	android:name="OPPO_APPKEY"
	android:value="${OPPO_APPKEY}" />
<meta-data
	android:name="OPPO_APPID"
	android:value="${OPPO_APPID}" />
<meta-data
	android:name="OPPO_APPSECRET"
	android:value="${OPPO_APPSECRET}" />

<meta-data
	android:name="com.vivo.push.api_key"
	android:value="${VIVO_APPKEY}" />
<meta-data
	android:name="com.vivo.push.app_id"
	android:value="${VIVO_APPID}" />

<meta-data
	android:name="MEIZU_APPKEY"
	android:value="${MEIZU_APPKEY}" />
<meta-data
	android:name="MEIZU_APPID"
	android:value="${MEIZU_APPID}" />

在这里插入图片描述

在这里插入图片描述

4.6 登录开发者中心申请签名
1）开发者需登录 https://dev.dcloud.net.cn/ 申请签名，申请签名成功后会显示 AppKey
在这里插入图片描述

2）将步骤 1 获取到的 AppKey 配置到 manifest
在这里插入图片描述

4.7 集成华为和FCM
华为和FCM的集成参考以下文档即可
https://www.yuque.com/docs/share/0f6327ce-da8f-488e-824a-7ca53890252d?# 《极光厂商通道集成指南》
解决fcm集成报AndroidX错误的问题

android.useAndroidX=true
android.enableJetifier=true

在这里插入图片描述

5、厂商通道点击跳转获取参数问题
（华为/小米/VIVO通道）uri_activity：cn.jiguang.uniplugin_jpush.OpenClickActivity
（OPPO / FCM通道）uri_action： cn.jiguang.uniplugin_jpush.OpenClickActivity
在这里插入图片描述

四、官方demo和API文档

官方demo : https://github.com/jpush/jpush-hbuilder-plugin
API文档 ：https://github.com/jpush/jpush-hbuilder-plugin/blob/master/doc/API.md

uniapp连接极光推送
weixin_44097578的博客
06-09 910
这里说一下appkey哪里来的 官方地址 先去官方注册个账号，点击上面链接 注册成功之后需要认证，看你是个人的还是企业的 最后去创建一下应用，过程省略 应用创建成功后，查看应用信息，可以看到AppKey等一下重要信息 如上都操作完成后，打包自定义包 打包完成后，连接手机（连接不上可以下个手机助手进行帮助） 最后在App.vue中写上如下代码 打印出这样的代表接入成功，别名也设置成功 最后去极光后台创建推送 需要注意的是，别名要填自己代码配置的那个 成果展示...
uniapp离线打包集成个推sdk
ShaneLau1997的博客
08-22 3843
首先根据官网 http://docs.getui.com/getui/mobile/android/androidstudio_maven/ 配置各种文件 关键点在于如何初始化SDK 官方文档上： 3.1 初始化SDK 我们建议开发者在主进程的Application.onCreate()、Activity.onCreate()方法中初始化个推SDK。多次调用SDK初始化并无影响。 但写在离线打包...
uniapp集成极光推送
wangqiuwei07的专栏
11-24 992
我看文档说的不清楚，两个插件各自为政，极光插件分为了两个，要把两个都集成才可以，uniapp集成极光推送，云插件集成。，这个里面配置Android厂商通道。，这个里面配置appkey信息。
uni-app安装插件
最新发布
蚂蚁搬家
09-20 740
uni-app安装插件
uniapp极光推送、java服务端集成
何时林听@
04-07 1672
​。
uniapp对接极光推送
qq_58101212的博客
11-14 4046
在App.vue中编写如下代码：（注意：极光推送信息通知回调中那个路径要改，路径就是你点击通知会打开到这个路径对应的页面）创建应用：【概览】- 【创建应用】，填写应用名称和图标（填写项目名称，项目logo就行，也可填写其他的）点击【推送设置】可查看android和ios的AppKey和Secret，后续需要使用。设置应用包名(图中仅为示例，最好是×××.×××.××格式)，点击下一步。【Hx中运行】=>【运行到手机或模拟器】=>【制作自定义调试基座】选择【消息推送】服务，点击下一步。
uniapp对接极光推送（真是手把手的教了）
weixin_72692608的博客
08-02 2581
uniapp前端对接极光推送
uniapp 接入极光推送
callBack_____的博客
08-07 381
uni-app + 极光推送完成ios、android端app推送功能。
UNIAPP 安卓离线SDK Android-SDK@3.96.81954-20231106
11-15
开发者可以通过这个离线SDK来创建和打包针对Android设备的应用，同时享受到UNIAPP提供的跨平台优势。 三、兼容旧版本打包插件的重要性 在移动应用开发领域，旧版本的兼容性是一项重要的考量因素。许多企业或项目...
Uniapp APP Android 离线SDK 版本号Android-SDK@3.6.17.81662-20230112
02-01
《 Uniapp Android 离线SDK：版本号详解与应用实践》 在移动应用开发领域，Uniapp作为一款跨平台的开发工具，以其强大的功能和高效性受到开发者们的青睐。对于那些需要支持旧项目的开发者来说，保持对旧版本SDK的...
跨平台应用开发进阶(九) ：uni-app 实现Android原生APP-本地打包集成极光推送(JG-JPUSH)详细教程_基于android 夸平台应用技术uni-app 的快速集成开发说明
2401_84435739的博客
04-27 435
compile ‘cn.jiguang.sdk:jpush:3.3.4’ // 此处以JPush 3.3.4 版本为例。compile ‘cn.jiguang.sdk:jcore:2.1.2’ // 此处以JCore 2.1.2 版本为例。JPUSH_APPKEY : “应用的 AppKey”, // JPush上注册的包名对应的 appkey。applicationId “com.xxx.xxx” // JPush 上注册的包名.// 选择要添加的对应 cpu 类型的 .so 库。
uniapp 对接 极光推送
Story_0809的博客
10-06 1184
uniapp推荐使用 uniPush，奈何公司用的极光推送，功能还是要实现，好大脑不如烂笔头，因此记录。
uni-app App端使用极光实现推送功能
m0_62835220的博客
08-16 1625
2.购买极光推送插件（包名为1.3步配置的包名，填错了的话需要重新购买，一般会买两次，第一次安卓和ios开发证书包名，第二次ios生成证书包名，楼主就是这样多花了9.9））1.3包名配置（安卓直接填写，ios上传证书自动识别（开发证书和生产证书），一定要填写正确，否则无法推送，无法修改，只能删除重新创建应用）配置完成第一步就算完成了。4.2前端在需要的地方调用后端的接口，后端将信息推送到该别名下的设备即可收到推送（后端如何实现楼主也不知道，问后端去，哈哈）4.1App.vue设置别名。
uniapp 对接极光推送 ---详细版
德芙吖！
06-07 2580
uniapp 对接极光推送
uniapp对接极光离线推送保姆级教程
m0_56223229的博客
07-03 1927
uniapp对接极光离线推送避坑指南
uniapp对接极光推送(国内版以及海外版)
weixin_52479803的博客
03-27 2569
uniapp对接极光推送(国内版以及海外版)
uniapp添加极光推送
workhard0905的博客
09-29 7855
uniapp中添加极光推送
跨平台应用开发进阶(八) ：uni-app 实现Android原生APP-云打包集成极光推送(JG-JPUSH)详细教程_uniapp 没有 jpush_appkey_android
2401_84446825的博客
05-04 521
console.log(‘监听到了连接状态变化 — ‘, connectStr)console.log(result.registerID,“注册ID…connectStr = ‘已连接’;connectStr = ‘未连接’;
uni-app打包安卓app如何接入极光推送JG-JPush
想好了再写！
03-11 4972
一.我们需要用到的一些插件以及极光平台的官网链接： 💛极光推送官方SDK 💛极光JCore官方SDK 💛极光官网平台 💛极光官方demo ✔❤💚🧡
评论 8
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值