跨平台应用开发进阶(九) ：uni-app 实现Android原生APP-本地打包集成极光推送(JG-JPUSH)详细教程

2024-02-16 18:38
文章标签 进阶 实现 android 应用 教程 app 开发 详细 推送 打包 uni 集成 本地 原生 跨平台 极光 jg jpush

本文主要是介绍跨平台应用开发进阶(九) ：uni-app 实现Android原生APP-本地打包集成极光推送(JG-JPUSH)详细教程，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

文章目录

    • 一、前言
    • 二、集成
      • 2.1 uni-app 项目集成至 Android Studio
        • 2.1.1 拷贝HbuilderX uni-app 源码至 AS
        • 2.1.2 下载最新 SDK
        • 2.1.3 复制 HBuilder-Hello 项目 data 到自己项目对应目录中
        • 2.1.4 复制 HBuilder-Hello 项目 libs 下的三个文件到自己项目对应目录中
        • 2.1.5 修改 dcloud_control.xml 配置文件
        • 2.1.6 androidmanifest.xml 中添加 activity 节点
      • 2.2 离线包制作
    • 三、遇到的问题及解决方案
      • 3.1 libs中sdk版本与app sdk版本不一致
      • 3.2 Suggestion: add 'tools:replace="android:resource"' to <meta-data> element at AndroidManifest.xml to override
      • 3.3 Android Studio未配置appkey或配置错误
    • 四、拓展阅读

一、前言

因项目需求，需要uni-app 原生APP-本地打包集成极光推送，现将集成过程梳理得出此文。

二、集成

2.1 uni-app 项目集成至 Android Studio

2.1.1 拷贝HbuilderX uni-app 源码至 AS

hbuilderX中使用本地打包生成android资源如下:
在这里插入图片描述
应用Android studio新建一个空白android项目
在这里插入图片描述
选择 Empty Activity 点击 Next。
在这里插入图片描述
Minimum API Level 建议选21及以上。

Package name作为应用标志，涉及申请第三方平台账号，一般情况下不建议修改，包名一般设置反向域名，如：io.dcloud.HBuilder。

点击 Finish 完成创建。

注意⚠️：App离线SDK不支持Kotlin！

构建如下文件结构，apps下面放hbuilderX本地打包生成的资源文件。
在这里插入图片描述

2.1.2 下载最新 SDK

在 Dcloud里下载最新的SDK。

下载解压后目录如下
在这里插入图片描述
其中，

  • HBuilder-Hello：是HelloH5打包App的示例，可以用AS打包成APK；
  • HBuilder-Integrate-AS：是HBuilder 5+ SDK 集成AS的示例；
  • SDK：是HBuilder SDK库文件
  • UniPlugin-Hello-AS：是开发插件并集成到Vue的示例。
2.1.3 复制 HBuilder-Hello 项目 data 到自己项目对应目录中

在这里插入图片描述

2.1.4 复制 HBuilder-Hello 项目 libs 下的三个文件到自己项目对应目录中

在这里插入图片描述

2.1.5 修改 dcloud_control.xml 配置文件

注意⚠️：appid 为 HbuilderX uni-app项目标识。

<hbuilder>
<apps><app appid="__UNI__1DA6F85" appver=""/>
</apps>
</hbuilder>
2.1.6 androidmanifest.xml 中添加 activity 节点

添加如下内容

<activityandroid:name="io.dcloud.PandoraEntry"android:configChanges="orientation|keyboardHidden|keyboard|navigation"android:label="@string/app_name"android:launchMode="singleTask"android:hardwareAccelerated="true"android:theme="@style/TranslucentTheme"android:screenOrientation="user"android:windowSoftInputMode="adjustResize" ><intent-filter><action android:name="android.intent.action.MAIN" /><category android:name="android.intent.category.LAUNCHER" /></intent-filter>
</activity><activityandroid:name="io.dcloud.PandoraEntryActivity"android:launchMode="singleTask"android:configChanges="orientation|keyboardHidden|screenSize|mcc|mnc|fontScale|keyboard"android:hardwareAccelerated="true"android:permission="com.miui.securitycenter.permission.AppPermissionsEditor"android:screenOrientation="user"android:theme="@style/DCloudTheme"android:windowSoftInputMode="adjustResize"><intent-filter><categoryandroid:name="android.intent.category.DEFAULT" /><categoryandroid:name="android.intent.category.BROWSABLE" /><actionandroid:name="android.intent.action.VIEW" /><dataandroid:scheme="h56131bcf" /></intent-filter>
</activity>

经过以上配置，可实现hbuilderx本地离线打包android项目，生成APK安装包。

首先下载jpush-hbuilder-demo Demo 应用。

拷贝 ./android/app/src/main/java/io.dcloud.feature.jpush 文件夹至你 Android Studio 工程的 /src/main/java/ 目录下。

拷贝 ./jpush.js 到你 Android Studio 工程的 /assets/apps/HBuilder应用名/js/ 下。

在 /assets/apps/你的应用名/www/manifest.json 文件中添加：

"Push": {"description": "消息推送"
}

在 /assets/data/dcloud_properties.xml 中添加（如果已存在 Push feature，可以直接修改）：

<featurename="Push"value="io.dcloud.feature.jpush.JPushService" >
</feature>

在 app/build.gradle 中添加：

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上注册的包名对应的 appkeyJPUSH_CHANNEL : "developer-default", // 暂时填写默认值即可]...}...
}
dependencies {...compile 'cn.jiguang.sdk:jpush:3.3.4'  // 此处以JPush 3.3.4 版本为例。compile 'cn.jiguang.sdk:jcore:2.1.2'  // 此处以JCore 2.1.2 版本为例。...
}

在 AndroidManifest.xml 中添加：

 <!-- since 3.3.0 Required SDK 核心功能--><!-- 可配置android:process参数将PushService放在其他进程中 --><!--User defined.  For test only 继承自cn.jpush.android.service.JCommonService--><service android:name="io.dcloud.feature.jpush.PushService"android:process=":pushcore"><intent-filter><action android:name="cn.jiguang.user.service.action" /></intent-filter></service><!-- User defined.  For test only  用户自定义接收消息器,3.0.7开始支持,目前新tag/alias接口设置结果会在该广播接收器对应的方法中回调--><!--since 3.3.0 接收JPush相关事件--><receiver android:name="io.dcloud.feature.jpush.PushMessageReceiver"><intent-filter><action android:name="cn.jpush.android.intent.RECEIVE_MESSAGE" /><category android:name="${applicationId}"></category></intent-filter></receiver>
<receiverandroid:name="io.dcloud.feature.jpush.JPushReceiver"android:enabled="true"android:exported="false"><intent-filter><action android:name="cn.jpush.android.intent.REGISTRATION" /> <!-- Required 用户注册SDK的 intent --><action android:name="cn.jpush.android.intent.UNREGISTRATION" /><action android:name="cn.jpush.android.intent.MESSAGE_RECEIVED" /> <!-- Required 用户接收SDK消息的 intent --><action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED" /> <!-- Required 用户接收SDK通知栏信息的 intent --><action android:name="cn.jpush.android.intent.NOTIFICATION_OPENED" /> <!-- Required 用户打开自定义通知栏的 intent --><action android:name="cn.jpush.android.intent.ACTION_RICHPUSH_CALLBACK" /> <!-- Optional 用户接受 Rich Push Javascript 回调函数的intent --><action android:name="cn.jpush.android.intent.CONNECTION" /> <!-- 接收网络变化 连接/断开 since 1.6.3 --><category android:name="${JPUSH_PKGNAME}" /></intent-filter>
</receiver>

2.2 离线包制作

  1. 点击build -> build Bundle/APK -> Build APK
    在这里插入图片描述

  2. 点击右侧Gradle侧边栏，点击需要打包的module -> Tasks -> build -> assembleDebug/assembleRelease
    在这里插入图片描述

  3. APK文件生成路径见下图（build文件夹只有在project视图下可见）。
    在这里插入图片描述

  4. 复制APK文件到HBuilderX中
    在HBuilderX项目中创建创建unpackage目录，在unpackage目录中创建debug目录，将上述生成的APK文件拷贝到debug目录中。并重命名文件为android_debug.apk，目录结构参考下图。
    在这里插入图片描述

  5. 运行自定义基座
    将运行基座选为自定义基座。
    在这里插入图片描述

点击运行，直接运行到手机即可。

三、遇到的问题及解决方案

3.1 libs中sdk版本与app sdk版本不一致

uses-sdk:minSdkVersion 16 cannot be smaller than version 19 declared in library [weex_videoplayer-release.aar] /Users/huaqiangsun/.gradle/caches/transforms-2/files-2.1/22285093409dba775963f444b0533dd8/weex_videoplayer-release/AndroidManifest.xml as the library might be using APIs not available in 16。Suggestion: use a compatible library with a minSdk of at most 16,or increase this project's minSdk version to at least 19,or use tools:overrideLibrary="io.dcloud.feature.weex_media" to force usage (may lead to runtime failures)

解决措施：需要在build.gradle(Moudle app)中minSdkVersion改为 19。

3.2 Suggestion: add ‘tools:replace=“android:resource”’ to element at AndroidManifest.xml to override

Attribute meta-data#android.support.FILE_PROVIDER_PATHS@resource value=(@xml/filepaths) from [lib.5plus.base-release.aar] AndroidManifest.xml:243:17-61
is also present at [torch-plgdtsdk-5.17.3157.aar] AndroidManifest.xml:48:17-57 value=(@xml/torch_file_paths).Suggestion: add 'tools:replace="android:resource"' to <meta-data> element at AndroidManifest.xml to override.

解决措施：在AndroidManifest.xml的根标签下加上 xmlns:tools="http://schemas.android.com/tools"，然后在application标签下加入tools:replace="android:name"。

<manifest xmlns:android="http://schemas.android.com/apk/res/android"xmlns:tools="http://schemas.android.com/tools"package="com.**"><application android:name="com.**.App"android:allowBackup="true"android:icon="@mipmap/app_icon"android:label="@string/app_name"android:supportsRtl="true"android:theme="@style/AppTheme"tools:replace="android:name"></application>
</manifest>

3.3 Android Studio未配置appkey或配置错误

官方给出的纠错步骤如下：

  1. 查看签名文件是否配置到了主APP的build.gradle。

  2. 查看离线项目中dcloud_control.xml文件中的appid是否与申请AppKey时的appid一致。

  3. 检测离线项目的包名是否申请AppKey时的包名是否一致。

  4. 编译完通过apk解压获取一下签名信息与申请AppKey时填写的SHA1一致。

通过自查，发现是app的build.gradle里面离线项目的包名与申请AppKey时的包名不一致导致的，修改成与项目的Android包名一致就完美解决了。

在这里插入图片描述

注意⚠️：配置离线打包AppKey时，android需要填写的证书签名SHA1值其实是通过keytool命令获取的MD5值。不知道是不是DCloud得Bug!

keytool -list -v -keystore xxx-keystore.jks

在这里插入图片描述

在这里插入图片描述

四、拓展阅读

  • uni-app官网本地打包指北
  • 《跨平台应用开发进阶(八) ：uni-app 原生APP-云打包集成极光推送(JG-JPUSH)详细教程》

这篇关于跨平台应用开发进阶(九) ：uni-app 实现Android原生APP-本地打包集成极光推送(JG-JPUSH)详细教程的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/715358。

相关文章

在Ubuntu上部署SpringBoot应用的操作步骤

在Ubuntu上部署SpringBoot应用的操作步骤

《在Ubuntu上部署SpringBoot应用的操作步骤》随着云计算和容器化技术的普及,Linux服务器已成为部署Web应用程序的主流平台之一,Java作为一种跨平台的编程语言,具有广泛的应用场景,本... 目录一、部署准备二、安装 Java 环境1. 安装 JDK2. 验证 Java 安装三、安装 mys
阅读更多...
python使用watchdog实现文件资源监控

python使用watchdog实现文件资源监控

《python使用watchdog实现文件资源监控》watchdog支持跨平台文件资源监控,可以检测指定文件夹下文件及文件夹变动,下面我们来看看Python如何使用watchdog实现文件资源监控吧... python文件监控库watchdogs简介随着Python在各种应用领域中的广泛使用，其生态环境也
阅读更多...
el-select下拉选择缓存的实现

el-select下拉选择缓存的实现

《el-select下拉选择缓存的实现》本文主要介绍了在使用el-select实现下拉选择缓存时遇到的问题及解决方案,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的... 目录项目场景：问题描述解决方案：项目场景：从左侧列表中选取字段填入右侧下拉多选框，用户可以对右侧
阅读更多...
Python中构建终端应用界面利器Blessed模块的使用

Python中构建终端应用界面利器Blessed模块的使用

《Python中构建终端应用界面利器Blessed模块的使用》Blessed库作为一个轻量级且功能强大的解决方案,开始在开发者中赢得口碑,今天,我们就一起来探索一下它是如何让终端UI开发变得轻松而高... 目录一、安装与配置：简单、快速、无障碍二、基本功能：从彩色文本到动态交互1. 显示基本内容2. 创建链
阅读更多...
基于Qt开发一个简单的OFD阅读器

基于Qt开发一个简单的OFD阅读器

《基于Qt开发一个简单的OFD阅读器》这篇文章主要为大家详细介绍了如何使用Qt框架开发一个功能强大且性能优异的OFD阅读器,文中的示例代码讲解详细,有需要的小伙伴可以参考一下... 目录摘要引言一、OFD文件格式解析二、文档结构解析三、页面渲染四、用户交互五、性能优化六、示例代码七、未来发展方向八、结论摘要
阅读更多...
SpringCloud集成AlloyDB的示例代码

SpringCloud集成AlloyDB的示例代码

《SpringCloud集成AlloyDB的示例代码》AlloyDB是GoogleCloud提供的一种高度可扩展、强性能的关系型数据库服务,它兼容PostgreSQL,并提供了更快的查询性能... 目录1.AlloyDBjavascript是什么？AlloyDB 的工作原理2.搭建测试环境3.代码工程1.
阅读更多...
最新版IDEA配置 Tomcat的详细过程

最新版IDEA配置 Tomcat的详细过程

《最新版IDEA配置Tomcat的详细过程》本文介绍如何在IDEA中配置Tomcat服务器,并创建Web项目,首先检查Tomcat是否安装完成,然后在IDEA中创建Web项目并添加Web结构,接着,... 目录配置tomcat第一步，先给项目添加Web结构查看端口号配置tomcat    先检查自己的to
阅读更多...
使用Nginx来共享文件的详细教程

使用Nginx来共享文件的详细教程

《使用Nginx来共享文件的详细教程》有时我们想共享电脑上的某些文件,一个比较方便的做法是,开一个HTTP服务,指向文件所在的目录,这次我们用nginx来实现这个需求,本文将通过代码示例一步步教你使用... 在本教程中，我们将向您展示如何使用开源 Web 服务器 Nginx 设置文件共享服务器步骤 0 —
阅读更多...
Golang使用minio替代文件系统的实战教程

Golang使用minio替代文件系统的实战教程

《Golang使用minio替代文件系统的实战教程》本文讨论项目开发中直接文件系统的限制或不足,接着介绍Minio对象存储的优势,同时给出Golang的实际示例代码,包括初始化客户端、读取minio对... 目录文件系统 vs Minio文件系统不足：对象存储：miniogolang连接Minio配置Min
阅读更多...
Python pyinstaller实现图形化打包工具

Python pyinstaller实现图形化打包工具

《Pythonpyinstaller实现图形化打包工具》：本文主要介绍一个使用PythonPYQT5制作的关于pyinstaller打包工具,代替传统的cmd黑窗口模式打包页面,实现更快捷方便的... 目录1.简介2.运行效果3.相关源码1.简介一个使用python PYQT5制作的关于pyinstall
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2