【超详细】从 0 到 1 打包你的 uni-app 应用：安卓篇打包指南

news2024/11/15 12:33:19

一. 介绍

在当前移动应用开发的大环境下，uni-app 作为一种使用 Vue.js 开发多平台应用的框架，为开发者提供了快速构建跨平台应用的能力。本文将为你介绍如何将 uni-app 项目打包成安卓应用，让你的应用在安卓设备上运行并上架应用市场。

二. 准备环境

在开始之前，确保你已经安装了以下软件和工具

  1. Node.js

  2. HBuilderX

  3. **JDK**（Java Development Kit）

如果你想要实现本地版离线打包，你还需要安装安卓的环境。不过如果你之前对开发安卓没有成熟的经验，你将会非常痛苦。

离线打包需要安装以下工具

  1. Android Studio 下载地址：Android Studio官网 OR Android Studio中文社区

  2. App离线SDK下载：最新android平台SDK下载

本文不对离线打包做详细的说明，非特殊情况下，非专业的安卓开发人员，真的不建议使用离线打包。

三. 创建应用

在 HBuilderX 中建新的 uni-app 项目或打开已有的项目。

  1. 在 HBuilderX 中，点击 “文件” -> “新建” -> “uni-app 项目” 或者选中已有的项目。

  2. 输入项目的名称和存放路径，并选择适当的模板。

  3. 点击“创建”来生成项目文件。

image.png

image.png

四. 生成签名证书

生成 Android 平台签名证书（.keystore）是用于对应用进行数字签名以确保应用的安全性和完整性。下面是一个简单的 Android 平台签名证书生成指南，请参考：

步骤一：安装 JDK（Java Development Kit）

  1. 访问 Oracle 官方网站，并下载适用于你的操作系统的 JDK 安装程序。

  2. 执行安装程序，并按照提示进行安装。

步骤二：打开终端或命令提示符

  1. 在 Windows 上，按下 Win + R，输入 cmd，然后按回车键打开命令提示符。

  2. 在 Mac 上，打开“应用程序”>“实用工具”>“终端”。

步骤三：导航到 JDK 的 bin 目录

在终端或命令提示符中，使用以下命令导航到你安装的 JDK 的 bin 目录。根据你的 JDK 版本和安装路径可能有所不同，以下命令仅供参考。

cd C:\Program Files\Java\jdk1.8.0_221\bin  // Windows示例路径
cd /Library/Java/JavaVirtualMachines/jdk1.8.0_221.jdk/Contents/Home/bin  // Mac示例路径

步骤四：生成签名证书

在终端或命令提示符中，使用以下命令生成签名证书（.keystore 文件）。根据你的需求和项目要求，可以根据需要修改命令中的参数。

keytool -genkey -v -keystore my-release-key.keystore -alias my-release-key -keyalg RSA -keysize 2048 -validity 10000

命令解释：

  • -genkey：生成密钥对和证书。

  • -v：在终端中显示密钥和证书的详细信息。

  • -keystore my-release-key.keystore：指定要生成的.keystore 文件名。

  • -alias my-release-key：指定密钥和证书的别名，可以自定义。

  • -keyalg RSA：指定密钥算法为 RSA。

  • -keysize 2048：指定密钥的位数为 2048。

  • -validity 10000：指定证书的有效期，单位为天。

步骤五：按照提示填写证书信息

生成签名证书的命令会提示你填写一些证书信息，如证书拥有者的姓名、组织单位名称、城市、州/省、国家等。根据实际情况填写这些信息。

步骤六：设置密码

生成签名证书时，需要设置一个密码以保护证书的安全性。请记住这个密码，它将用于以后对应用进行签名和更新。

步骤七：确认生成的签名证书 生成签名证书后，会在当前目录下生成一个名为 my-release-key.keystore 的文件。请确保将这个文件妥善保存，并备份好。

生成签名证书后，你就可以使用它对你的 Android 应用进行签名了。在打包应用时，通过引用签名证书，可以验证应用的身份和完整性。

请注意，签名证书是非常重要的，请妥善保管好它，并谨慎分享证书文件和相关密码，以免引发安全问题。

五. 配置应用

1. 配置应用基础信息

在基础配置页签，填写应用名称、应用描述、应用版本及应用版本号等基本信息，如下图所示：

image.png

image.png

说明：

应用版本名称为一个字符串，例如：1.0.0，通常代表同一个应用不同的版本名称；

应用版本号是一个 number 类型的数字，通常从 1 开始依次累加，从根本上用来区别不同版本，主要用来版本更新覆盖等。

2. 配置应用图标

主要用来配置应用在桌面上的图标显示，这里需要配置不同分辨率的图标，主要是为了在不同屏幕分辨率的手机下避免失真效果。

image.png

image.png

image.png

image.png

小技巧：

我通常是让 UI同学 出一张大分辨率尺寸的图片，利用 HBuilderX 工具一键生成所需要的各种不同分辨率的图片，如上图所示，自动生成图标功能，方便快捷。

3. 配置应用模块

应用模块主要会涉及到一些真机的能力，比如：使用照相机、蓝牙、相册、定位等功能，也可以配置一些 uniapp 已经支持的第三方插件配置，比如：第三方地图（高德、百度等）、第三方分享、友盟统计等。如下图所示进行按需选择。

image.png

image.png

目前在 uni-app 中所涉及的 Android 模块配置模块及三方 SDK 主要有以下几个，均可以在 HBuilderX 中进行选择配置

  • Geolocation (定位)

  • Push (消息推送)

  • Share (分享)

  • Oauth (登录鉴权)

  • Map (地图)

  • Payment (支付)

  • Speech (语音输入)

  • Statistic (统计)

  • FacialRecognitionVerify (实人认证)

  • uni-AD

  • Android X5 Webview (腾讯 TBS)

不过需要注意的是，如果没有使用某一些模块功能，请不要勾选，因为你每选择一个模块，将会增大你的应用体积。切记要按需选择。

4. 配置应用权限

在 App 权限一栏中，根据应用的需求，勾选对应的权限，通常有一些所必要的权限，下面我进行列举，其他的按照应用内所设计的权限进行添加即可。

image.png

image.png

我总结了一下我目前的一个最简单的 App 常用的权限有：（仅涉及到扫码功能）

  1. <uses-feature android:name="android.hardware.camera"/> 指定了应用需要使用相机功能。用于在应用中拍摄照片、录制视频或进行其他与相机相关的操作。

  2. <uses-feature android:name="android.hardware.camera.autofocus"/> 指定了应用需要使用相机的自动对焦功能。用于在应用中实现相机对焦功能，以确保拍摄的照片或视频清晰。

  3. <uses-permission:name="android.permission.CAMERA"/> 允许应用访问设备的相机。用于应用在运行时获取相机的访问权限，可以进行拍摄、录制等操作。

  4. <uses-permission android:name="android.permission.FLASHLIGHT"/> 允许应用控制设备的闪光灯。用于应用在需要时打开和关闭设备的闪光灯。

  5. <uses-permission android:name="android.permission.INTERNET"/> 允许应用访问互联网。用于应用在需要联网的功能中实现数据的传输和获取。

  6. <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/> 允许应用挂载和卸载文件系统。用于应用在需要读取和写入外部存储设备（如 SD 卡）时进行相关操作。

  7. <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> 允许应用向外部存储设备写入数据。用于应用在需要保存文件到外部存储设备时进行相关操作。

  8. <uses-permission android:name="android.permission.WRITE_SETTINGS"/> 允许应用修改系统设置。用于应用在需要修改设备设置（如音量、显示亮度等）时进行相关操作。

这些权限在安卓应用开发中常见且常用，根据应用的实际需求，可以在清单文件（manifest.json）中声明和使用这些权限。确保应用以正确、安全的方式使用这些功能和资源，例如相机、闪光灯、互联网访问、外部存储等。

请注意，在 Android 6.0（API 级别 23）及以上版本，部分权限属于危险权限（Dangerous Permissions）。用户在安装应用时需要授予这些权限，否则应用将无法正常使用对应的功能。在使用这些权限时，应遵循 Android 官方的权限管理原则。

基本上完成上面的几个 App 配置就差不多了，后续可以根据自己对项目的深入程度，定向的做一下删减或增加。

六. 真机调试

在打包引用之前，我们首先要经过真机测试，保证所要打包的代码在真机环境下运行没有问题，才可以启动打包程序，可以采用以下步骤进行连接安卓手机进行真机调试

  1. 首先通过 USB 连接安卓手机，并打开开发者选项，允许 USB 调试开关打开

  2. 选择运行到 Android App 基座即可选择你在上一步连接电脑的安卓手机，确认运行就可以了

image.png

image.png

说明：如果在这个地方检测不到你的真机设备，说明手机和电脑通过 USB 未真正连接成功，通常的解决方案是下载一个 360 手机助手、豌豆荚、应用宝等第三方应用，这些应用会安装一些必备的驱动，从侧面解决你的连接调试问题。

真机调试主要是测试你的代码运行情况，避免频繁使用云打包带来的延时、效率低下的问题。避免编写一行代码几秒钟，打包一次 5 分钟的尴尬境地，大幅度的降低了开发效率。

七. 云打包

1. 发行

打开 HBuilderX 的工具栏点击工具栏参数界面的 “发行” 按钮，可以看到有如下的菜单提供选择，下面分别对 App 发行的选项进行说明：

image.png

image.png

  1. 原生 App - 云打包

这个功能是我们接下来要使用的重点功能，主要用来打包 App 的配置项，包括 Android 配置和 iOS 配置，接下来会进行详细的说明。

  1. 原生 App - 查看云打包状态

很简单，这个功能主要是用来发布云打包请求之后，查看目前所请求的云打包状态，是否打包成功，如下图展示。

image.png

image.png

  1. 原生 App - 本地打包

这个功能主要是生成本地打包 App 资源，然后配合 Android Studio 进行离线打包。

image.png

image.png

运行该指令，主要会将你的项目生成 一个 www 的文件夹，这是 App 离线 资源，主要包含以下内容。

image.png

image.png

这种方式，如果你想要深入了解的话，请参考以下链接： App 离线打包

  1. 原生 App - 制作应用 wgt 包

这个功能其实很有用，其主要生成 H5 的资源包，主要用于应用热更新，解决频繁的整包更新。如果你的应用使用了热更新方案，那么这个你将会时常用到。

2. 云打包

点击 “原生 App - 云打包” 按钮，HBuilderX 将打开打包配置界面，主要填写好下面几个参数，即可实现云打包。主要填写的相关信息如下：

  • Android 包名

  • 证书的相关信息（上文中我们已经生成了相关证书）

    • 证书文件

    • 证书别名

    • 证书密码

  • 选择传统打包或快速安心打包

    • 主要区别在于是否上传证书及代码

image.png

image.png

八. 总结一些坑

1. 上线 Google Play 应用市场

  1. 确保将 HBulider X 升级到 3.2.15+版本，否则 App 将会出现问题

  2. App 提交云端打包时请勾选“**GooglePlay(AAB)**”渠道，生成.aab 格式的应用

  3. 不能直接下载 apk 方式安装应用，需引导用户到 Google Play 安装

  4. 不能存在动态加载代码行为

  5. “App 常用其它设置”中需要将 targetSdkVersion 设置值大于等于 30

  6. 务必在 Android11 设备上进行测试，确保应用所有功能可以正常运行

  7. 不能包含安装应用权限，在 App 权限配置中不要勾选 android.permission.INSTALL_PACKAGES、android.permission.REQUEST_INSTALL_PACKAGES 权限

2. 应用市场隐私审核不通过

目前不管是上架任何的应用市场，在首次安装应用或更新高版本的应用时，必须首要弹出应用隐私弹窗，用户进行阅读和同意，其次会检测应用获取的隐私条目和隐私政策是否匹配，不匹配也会被拒绝。以华为应用市场为例，下图是在上架华为应用市场时隐私不匹配被拒绝的案例。

image.png

image.png

App应用内隐私弹窗提示案例

3. 不要频繁的使用云打包

DCloud 官方为了节流，做了一些打包次数的限制，官方说明：打包不是为了测试应用，而是为了发布应用。所以频繁的打包超出一定限制后（我当时是每天 5 次，不知道现在是否有变化），当天会禁止你再次打包。

为了解决这个问题，你可以“制作自定义调试基座”，然后运行到手机，使用自定义基座运行调试，如下图所示：

image.png

4. 应用包体积特别大

上文已经有提到过，可能是由于打包了第三方模块导致的应用包体积变大，具体可以参考以下步骤进行排除：

  • 取消无用的 App 第三方模块的勾选，上文提到过；

  • 检查代码中是否有引用的相关模块；

  • 说到底是被 uniapp 卡脖子了，云打包确实会打包一些无用的插件，但是官方不解决，没有办法，其次你也可以使用离线打包试一下，但是效果不怎么理想。

总结

通过以上内容的了解，你应当学习了如何使用 uni-app 框架和 HBuilderX 工具来打包生成安卓应用。还大体了解了一些打包 App 及上架应用市场的注意事项及解决方案。

你可以按照这个步骤一步步操作，将你的 uni-app 项目转化为安卓应用，并在安卓设备上运行和测试，祝你成功。

由于我本身不是专业的安卓开发人员，如有不正确的地方，敬请指出。

参考资料

Android 平台签名证书生成指南

Android 模块配置

App 离线打包

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/2091199.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

学习之MySQL函数（字符串，数值，日期，流程）

学习之MySQL函数（字符串，数值，日期，流程）

字符串函数 函数是指一段可以直接被另一段程序或代码 案例&#xff1a; – 1、由于业务需求变更&#xff0c;企业员工的工号&#xff0c;统一为5位数&#xff0c;目前不足5位数的全部在前面补0、比如:1号员工的工号应该为00001. update emp set worknolpad(workno, 5, 0) 运…
阅读更多...
2024大模型学习：机器学习在安全领域的应用|从大数据中识别潜在安全威胁

2024大模型学习：机器学习在安全领域的应用|从大数据中识别潜在安全威胁

机器学习在安全领域的应用&#xff1a;从大数据中识别潜在安全威胁 &#x1f9d1; 作者简介&#xff1a;现任阿里巴巴嵌入式技术专家&#xff0c;15年工作经验&#xff0c;深耕嵌入式人工智能领域&#xff0c;精通嵌入式领域开发、技术管理、简历招聘面试。CSDN优质创作者&…
阅读更多...
【王树森】RNN模型与NLP应用(8/9)：Attention（个人向笔记）

【王树森】RNN模型与NLP应用(8/9)：Attention（个人向笔记）

前言 基于RNN的Seq2Seq模型无法记住长序列Attentnion机制可以大幅度提升Seq2Seq模型 Seq2Seq Model with Attention Attention可以让句子在逐步变长的时候不忘记前面的输入信息Attention还可以告诉Decoder应该关注哪一个状态优点&#xff1a;Attention可以大幅度提高准确率缺…
阅读更多...
中小企业数字化营销突围秘籍，快来解锁！

中小企业数字化营销突围秘籍，快来解锁！

​嘿&#xff0c;各位中小企业主们&#xff01;在如今这个数字化时代&#xff0c;市场竞争那叫一个激烈。传统营销方式渐渐力不从心&#xff0c;而数字化营销则成为咱们中小企业突出重围的关键路径。 现状不容乐观 目前呢&#xff0c;有一部分中小企业已经迈出了数字化营销的步…
阅读更多...
【hot100篇-python刷题记录】【最小覆盖子串】

【hot100篇-python刷题记录】【最小覆盖子串】

R7-子串篇 class Solution:def minWindow(self, s: str, t: str) -> str:ret_left,ret_right-1,len(s)left0#s子串字母出现的次数cnt_sCounter()#t中字母出现的次数cnt_tCounter(t)for right,c in enumerate(s):cnt_s[c]1while cnt_s>cnt_t:#找到更短的子串if right-left…
阅读更多...
破解“目录名称无效”难题：数据恢复实战指南

破解“目录名称无效”难题：数据恢复实战指南

在数字化生活日益普及的今天&#xff0c;数据存储与管理成为了我们日常不可或缺的一部分。然而&#xff0c;当您尝试访问某个文件夹时&#xff0c;却遇到了“目录名称无效”的错误提示&#xff0c;这无疑会让人感到焦虑和困惑。本文将深入探讨“目录名称无效”这一问题的根源&a…
阅读更多...
Unet改进11：在不同位置添加MLCA||轻量级的混合本地信道注意机制

Unet改进11：在不同位置添加MLCA||轻量级的混合本地信道注意机制

本文内容：在不同位置添加MLCA注意力机制 目录 论文简介 1.步骤一 2.步骤二 3.步骤三 4.步骤四 论文简介 注意机制是计算机视觉中应用最广泛的组成部分之一，它可以帮助神经网络突出重要元素，抑制无关元素。然而，绝大多数通道注意机制只包含通道特征信息，忽略了空间特征…
阅读更多...
android gradle阿里云镜像地址，下载速度快，而且几乎是最新的所有版本

android gradle阿里云镜像地址，下载速度快，而且几乎是最新的所有版本

阿里云Gradle的镜像地址&#xff1a; macports-distfiles-gradle安装包下载_开源镜像站-阿里云 还是比较全的&#xff0c;最主要是下载速度比较快。 这样可以节省很多时间。 我们可以利用离线的方式来使用这些Gradle就可以了。 android 离线的方式使用下载到本地的gradle-CS…
阅读更多...
鸿蒙开发—黑马云音乐之music页面播放音乐（下）

鸿蒙开发—黑马云音乐之music页面播放音乐（下）

目录 1.暂停播放和恢复播放 2.上一首、下一首功能 1.暂停播放和恢复播放 src/main/ets/services/AvPlayerManager.ets&#xff1a; export interface songItemType {img: stringname: stringauthor: stringurl: stringid: string }//作用&#xff1a;负责管理播放对象的各种…
阅读更多...
Windows环境CP Editor安装使用方法

Windows环境CP Editor安装使用方法

step0&#xff1a;下载软件包&#xff0c;附件有已经下载的安装包 Download CP Editor | CP Editor step1&#xff1a;下载后双击安装即可(记住安装路径) step2&#xff1a;找到安装目录下的cpeditor\mingw64\bin配置环境变量 step3&#xff1a;双击打开即可使用
阅读更多...
pikachu 靶场环境搭建 完整版（手把手保姆级教学）

pikachu 靶场环境搭建 完整版（手把手保姆级教学）

文章目录 一、pikachu靶场简介二、靶场环境准备三、pikachu 靶场搭建过程1、phpstudy 配置2、MySQL环境变量配置&#xff08;非必要&#xff09;3、pikachu 靶场配置4、靶场连接测试 四、pikachu靶场搭建时数据库连接问题等其它问题(Warning: mysqli_connect(): (HY000/1049): …
阅读更多...
全球城市多边形和点数据集 (GUPPD)

全球城市多边形和点数据集 (GUPPD)

全球城市多边形和点数据集 (GUPPD) 第 1 版是一套包含 123,034 个城市定居点的全球数据集&#xff0c;包含 1975-2030 年期间的地名和人口&#xff0c;每五年更新一次。该数据集建立在欧盟委员会联合研究中心 (JRC) 2015 年全球人类定居点 (GHS) 城市中心数据库 (UCDB) 的基础上…
阅读更多...
【手撕数据结构】二叉树oj题

【手撕数据结构】二叉树oj题

目录 单值二叉树题目描述题目思路及代码 相同的树题目描述题目思路及代码 对称二叉树题目描述题目思路及代码 另一棵树的子树题目描述题目思路及代码 二叉树的前序遍历题目描述题目思路及代码 二叉树的构建与遍历题目描述题目思路及代码 单值二叉树 题目描述 题目思路及代码 …
阅读更多...
模型 情境领导力

模型 情境领导力

系列文章 分享 模型&#xff0c;了解更多&#x1f449; 模型_思维模型目录。灵活变通&#xff0c;因势利导的领导艺术。 1 情境领导力的应用 1.1 软件项目的成功转型 在一家知名的软件开发公司中&#xff0c;有一个由资深工程师李伟领导的团队&#xff0c;负责开发一款新的客…
阅读更多...
Mac下的压缩包和Win看到的不一样怎么办 Mac压缩后Win电脑看文件名会乱码

Mac下的压缩包和Win看到的不一样怎么办 Mac压缩后Win电脑看文件名会乱码

在当今多平台的数字工作环境中&#xff0c;Mac和Windows用户常常需要交换文件&#xff0c;但有时候会遇到一些兼容性问题。特别是在处理压缩文件时&#xff0c;Mac用户创建的压缩包在Windows系统中打开时&#xff0c;常常会遇到文件名乱码的问题。本文将详细讨论“Mac下的压缩包…
阅读更多...
基于AI大模型开发上层应用常见的技术栈

基于AI大模型开发上层应用常见的技术栈

基于AI大模型的上层应用开发&#xff0c;技术栈要求通常包括以下几个方面&#xff1a; 编程语言&#xff1a;Python是AI领域的主要编程语言&#xff0c;具有大量的库和框架支持&#xff0c;是大模型开发的首选语言 。TypeScript也是不错的选择&#xff0c;很多模型对外提供类似…
阅读更多...
postman学习笔记：从入门到精通

postman学习笔记：从入门到精通

postman入门到精通 一、postman下载安装与更换主题1、下载与安装2、更换主题&#xff08;Themes&#xff09; 二、页面详解1、顶部工具栏2、左侧栏3、中部栏3.1 请求部分页签介绍3.2 响应部分页签介绍 三、管理用例四、设置环境变量和全局变量1、添加环境变量2、添加全局变量 五…
阅读更多...
编码666

编码666

unicode&#xff0c;将每种语言的每种格式都用一个二进制编码来表示&#xff0c;1到3个字节 问题&#xff1a;1.系统怎么知道是ASCII还是Unicode编码&#xff0c;怎么直到一个字符是一字节还是多个字节 2.很多字符需要2字节或更多&#xff0c;存储空间的要求会更高 UTF-8&…
阅读更多...
AIGC提示词（3）：AI的创造力之谜：相同提示词，不同内容

AIGC提示词（3）：AI的创造力之谜：相同提示词，不同内容

引言 在这个数字化的时代&#xff0c;人工智能生成内容&#xff08;AIGC&#xff09;已经变得无处不在。想象一下&#xff0c;只需输入几个关键词&#xff0c;AI就能创作出各种内容&#xff0c;无论是文字、图片&#xff0c;还是其他形式。但这里有个有趣的问题&#xff1a;如…
阅读更多...
简易计算器（源码+程序）

简易计算器（源码+程序）

效果演示&#xff1a; 下载地址&#xff1a; 简易计算器&#xff08;源码程序&#xff09;&#xff1a;https://download.csdn.net/download/wgxds/89696805 vb.net开发安卓软件的方法&#xff1a;[原创]vb.net开发安卓软件的方法_vbnet开发安卓-CSDN博客 免费资源下载&#x…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023