当前位置： 首页 > news >正文

Uniapp Android 本地离线打包（详细流程）

news 2026/2/10 16:37:16

一、简介

  • App 离线 SDK 暂时不支持 Kotlin，未来不清楚。

  • uniapp 提供了 云打包 与 本地打包 两种方案，云打包 需要排队且还有次数限制，本地打包 则就没有这些限制，而且会 本地打包 对开发 原生插件 有很大的帮助。

    image.png

  • 细节：需要 Android Studio 打包的时候，记得先通过工具栏的 Build -> 先 Clean Project -> 再 Rebuild Project -> 最后在打包或运行，生成基座或者测试离线包都适用这套流程。

二、准备工作

  • 按照官方文档中的 开发环境 下载好开发工具与 SDK 工程即可：Android 离线打包选了方式二：导入工程 方式，官方文档地址。

    注意：HBuilder X 3.5.0 及以上版本新增库 breakpad-build-release.aar

    注意：HBuilder X 3.8.7 及以上版本新增库 install-apk-release.aar，上架谷歌应用市场不能包含此库，更多参考文档

    我下载这个版本包好像没有 install-apk-release.aar，那就不用管，大多数的配置官方提供的工程中就已经配置好了，这边只把需要修改的罗列一下，当然最好通过本文结合官方文档来对照走步骤更好。

    在这里插入图片描述

    在这里插入图片描述

  • 下载的 Android 工程目录结构介绍，找到 HBuilder-Integrate-AS 离线打包工程，可以拷贝出来使用 Android Studio 打开该工程。

    image.png

    image.png

  • 打开工程后，先按 Android 老项目新人如何快速入手跑起来 这篇文章快速的配置一下基础环境。

  • 如果跑出下面这样的结果，非报错都先不要管，警告随他先。

    在这里插入图片描述

  • 如果需要重新编译项目可以在这里进行，或者使用 Build 工具栏里面刷新按钮也是一个效果。

    在这里插入图片描述

三、创建 Uniapp 测试项目

  • 使用 HBuilderX 或 Cli 创建一个测试项目 demo，然后运行到测试机或者模拟器。附：Uniapp 运行到 Android 真机或模拟器。

    1、确认当前模拟器或者真机支持的 cpu 类型，然后进行勾选，这里就是配置要打包的 apk 需要支持哪些cpu 类型的手机，全要支持可以全支持。附：adb 查看安卓手机、模拟器、apk包所支持的 CPU 类型（armeabi、armeabi-v7a、arm64-v8a …）

    反正就是勾的越多，打的包越大，你可以测试时用哪个勾哪个，等发包了在根据需要支持的手机市场进行勾选。

    在这里插入图片描述

    2、测试项目正常运行后，则进行本地打包，获得编译后的源码。

    image.png

    3、看控制台，等待编译完成，去给出的目录找到编译后的源码。

    image.png

    4、替换离线打包工程中的源码

    image.png

    image.png

    5、修改 dcloud_control.xml 文件里面的 appid，其实离线资源文件夹名称就是 appid，可以核对下免得出错。

    在这里插入图片描述

    在这里插入图片描述

四、离线工程的调整

  • 代码导入后，需要进行一些离线打包工程上的细节调整。

  • 包名替换，例如 com.dzm.test

    image.png

  • [可选]compileSdkVersion 修改，compileSdkVersion 30 是 Android 项目中的一个配置项，定义了 编译时使用的 Android API 级别（即 Android SDK 版本），表示你正在使用 API 级别 30（对应 Android 11，即 Android 11）。

    在这里插入图片描述

  • 版本号修改，跟 HBuilderX -》manifest.json 中的版本号保持一致。

    image.png

  • 签名配置，也就是证书相关信息

    1、打开 Uniapp 开发者后台，登录一下。

    image.png

    image.png

    2、点击应用名称进入，找到 Android 云端证书，创建一个，稍微等待一下，需要刷新一下网页就能看到创建好的证书信息了，然后下载证书，放到 HBuilder-Integrate-AS 离线打包工程根目录。

    image.png

    image.png

    image.png

    3、复制证书的绝对路径，并替换配置中的证书路径

    image.png

    image.png

    在这里插入图片描述

    4、配置证书别名、密码

    image.png

    在这里插入图片描述

    在这里插入图片描述

    5、配置打包的 apk 需要支持的 cpu 类型

    ndk {abiFilters 'x86', 'armeabi-v7a', 'arm64-v8a'
}

    在这里插入图片描述

  • 申请 Appkey，如果没有则需要申请一下，有则可以直接拷贝，需要前往 Uniapp 开发者后台：

    在这里插入图片描述

    在这里插入图片描述

    点击 新增 后，需要填的资料中 包名 按上面的一样，版本可以根据情况来，创建 正式 与 测试 两个切换使用，Android 应用签名SHA1值 与 Android 应用签名SHA256 值在上面的 证书详情 中有，拷贝贴过来即可。其他根据需要可填可不填。

    在这里插入图片描述

    在这里插入图片描述

    然后创建一个 AppKey 并拷贝：

    在这里插入图片描述

    在这里插入图片描述

    将 AppKey 配置到离线工程中：

    在这里插入图片描述

    这个文件顶部的包名也要改一下，保持同步：

    在这里插入图片描述

  • 配置图标，不同分辨率可以按官方文档上的，多建几个文件夹配置。

    在这里插入图片描述

    在这里插入图片描述

  • 配置应用名称，需要保持一致

    在这里插入图片描述

五、离线工程试跑

  • 创建好虚拟机，点击调试项目

    在这里插入图片描述

    如果报错 Execution failed for task ‘:simpleDemo:stripDebugDebugSymbols’. NDK at /Users/dengzemiao/Library/Android/sdk/ndk-bundle did not have a source.properties file 点这里。

  • 解决问题再次点击调试按钮，项目跑成功了，如果 uniapp 重复打包导入项目后，最新内容没生效，可以删掉模拟器上安装好的包，重新运行安装一下。

    在这里插入图片描述

六、离线自定义基座打包

  • Uniapp Android 离线生成自定义基座（详细流程）

  • Uniapp Android 离线生成自定义基座（官方文档）

相关文章：

Uniapp Android 本地离线打包（详细流程）

一、简介 App 离线 SDK 暂时不支持 Kotlin，未来不清楚。 uniapp 提供了 云打包 与 本地打包 两种方案，云打包 需要排队且还有次数限制，本地打包 则就没有这些限制，而且会 本地打包 对开发 原生插件 有很大的帮助。 细节&#x…...

编程日记 2025/1/6 20:31:51

vite+vue3动态引入资源文件（问题已解决但离了个大谱）

教程很详细，直接上代码 解决方法（赶时间的小友理解下这函数就能解决问题了，就是处理了下路径，运气不好遇到问题再回来也不迟🤣🤣🤣） const getSvgUrl (name) > {// name: svg_1…...

编程日记 2025/1/6 20:29:49

通过 4 种方式快速将音乐从 iPod 传输到 Android

概括 在 iPod 上听音乐很酷，但是当您拥有最新的 Android 手机时，也许您想在新手机上欣赏 iPod 音乐。那么，你的计划是什么？如何将音乐从 iPod 传输到 Android？ 如果您担心这个问题，请看看下面的方法。他们…...

编程日记 2025/1/6 20:28:46

ArcGIS中怎么把数据提取到指定范围(裁剪、掩膜提取)

最近，经常能收到怎么把数据提取到指定范围、栅格数据怎么裁剪、矢量数据怎么裁剪、栅格数据怎么掩膜提取的咨询。 下面是我对这个问题的解决思路： 对于矢量数据： ①首先把数据加载进来 ②软件界面上面的工具栏找到→地理处理→裁剪&#x…...

编程日记 2025/1/6 20:24:42

【Vaadin flow 实战】第3讲-快速上手构建VaadinFlow+Springboot的全栈web项目

快速构建VaadinFlowSpringboot的全栈web项目 温馨提示，本文讲解比较精炼，主要以快速上手开发为主。 官方提供了与本文类似的教程讲解，地址https://vaadin.com/docs/latest/getting-started 1访问vaadin官方提供的start网站(类似于 spring i…...

编程日记 2025/1/6 20:21:38

HBase Cassandra的部署和操作

目录 一．数据库的部署与配置 二．使用命令访问数据库 三．数据库的设计 四．编程实现数据库的访问 一．数据库的部署与配置 1.在单个节点上对进行数据库的单机部署 （1）下载apache-cassandra-4.1.7-…...

编程日记 2025/1/6 20:15:29

用户界面软件01

Jens Coldewey 著，Tom.X 译 本文中的模式语言逐步深入地探讨用户界面架构的设计，它基于人机工程学，足以形成一套完整的体系。如果你对这方面有兴趣，请参考[Tog92]，[Coo95]和[Col95]。 本文不讨论用户界面的布局&…...

编程日记 2025/1/6 20:14:28

【云原生】Docker Compose 从入门到实战使用详解

目录 一、前言 二、Docker Compose 介绍 2.1 Docker Compose概述 2.2 Docker Compose特点 2.3 Docker Compose使用场景 三、Docker Compose 安装 3.1 安装docker环境 3.2 Docker Compose安装方式一 3.2.1 下载最新版 3.2.2 设置权限 3.2.3 设置软链接 3.2.4 查看版本…...

编程日记 2025/1/6 20:12:25

【ShuQiHere】使用 SCP 进行安全文件传输

【ShuQiHere】🚀 在日常的开发和运维工作中，文件传输是一个常见的任务。scp（Secure Copy）是一个基于 SSH 协议的文件传输工具，能够在本地和远程主机之间安全地复制文件和目录。本文将详细介绍 scp 的使用方法&#xf…...

编程日记 2025/1/6 20:08:20

海康威视H5player问题汇总大全

由于除了要支持Windows平台，还要支持国产系统的平台，这时就用到了H5player，但是这个在使用调试的时候会遇到各种各样的问题，便在此分享一下，供大家分享！！！ 问题一：Unexp…...

编程日记 2025/1/6 20:06:17

力扣23.合并K个升序链表

文章目录 一、前言二、最小堆解法三、分治解法 一、前言 23. 合并 K 个升序链表 本题的要求是把K个链表进行合并，合并后的链表必须是从小到大的。 并且这K个链表也是从小到大的升序链表。 二、最小堆解法 既然每个链表都是升序的，也就是从小到大的。 …...

编程日记 2025/1/6 20:05:15

【C 语言指针篇】指针的灵动舞步与内存的神秘疆域：于 C 编程世界中领略指针艺术的奇幻华章

文章目录 【C 语言篇】指针的灵动舞步与内存的神秘疆域：于 C 编程世界中领略指针艺术的奇幻华章前言一 、指针的介绍与使用1. 指针的介绍1.1指针表示1.2指针变量1.3空指针 2. 使用指针2.1交换两个变量的值2.2计算输出最小值和最大值 二、野指针的介绍与使用1. 野指针…...

编程日记 2025/1/6 20:03:14

游戏关卡设计的常用模式

游戏关卡分为很多种，但常用的有固定套路，分为若干种类型。 关卡是主角与怪物、敌方战斗的场所，包括装饰物、通道。 单人游戏的关卡较小，偏线性； 联机/MMO的关卡较大，通道多，自由度高&#xf…...

编程日记 2025/1/6 19:58:04

在一台服务器上使用docker运行kafka集群

1.拉取镜像 docker pull wurstmeister/kafka docker pull wurstmeister/zookeeper 2.创建集群之间通信的网络 docker network create kafka-cluster-net docker network inspect kafka-cluster-net 3.将zookeeper加入到网络中 docker network connect kafka-cluster-net zooke…...

编程日记 2025/1/6 19:55:59

Apache Celeborn 在B站的生产实践

背景介绍 Shuffle 演进 随着B站业务的飞速发展，数据规模呈指数级增长，计算集群也逐步从单机房扩展到多机房部署模式。多个业务线依托大数据平台驱动核心业务，大数据系统的高效性与稳定性成为公司业务发展的重要基石。如图1，目前在大数据基础架构下，我们主要采用 Spark、Fl…...

编程日记 2025/1/6 19:50:51

JOIN 和 OUTER JOIN,SQL中常见的连接方式

1. INNER JOIN（简称 JOIN） INNER JOIN 是 SQL 中最常用的一种连接方式，默认的 JOIN 就是 INNER JOIN。它返回两个表中满足连接条件的匹配记录。 作用：返回两个表中所有满足 ON 条件的记录。特性：如果表中的某些行在连…...

编程日记 2025/1/6 19:46:45

Vue2: table加载树形数据的踩坑记录

table中需要加载树形数据，如图： 官网给了两个例子，且每个例子中的tree-props都是这么写的： :tree-props="{children: children, hasChildren: hasChildren}" 给我一种错觉，以为数据结构中要同时指定children和hasChildren字段，然而，在非懒加载模式下，数据结…...

编程日记 2025/1/6 19:44:42

电子信息硕士面试经验

回顾2024年秋招一些面试常见的问题，主要涉及软件开发和嵌入式部分内容。 1. 浅拷贝深拷贝 深拷贝和浅拷贝是两种不同的拷贝方式，用于复制对象。它们主要区别在于对嵌套对象的处理方式。 浅拷贝：只复制对象的顶层，嵌套对象仍然是共享引用。 深拷贝：递归复制所有对象及其嵌…...

编程日记 2025/1/6 19:43:41

dns网址和ip是一一对应的吗？

DNS网址和IP地址是一一对应的吗？我们在上网时，为什么总是使用网址而不是一串数字？这些问题其实涉及到互联网的基本运作原理。DNS（域名系统）是我们日常上网过程中一个不可或缺的部分，它帮助我们将人类易于记…...

编程日记 2025/1/6 19:41:39

springboot3 redis 常用操作工具类

在 Spring Boot 3 中，操作 Redis 通常使用 Spring Data Redis 提供的工具类，如 RedisTemplate 和 StringRedisTemplate。以下是一个详细的 Redis 操作工具类的实现，涵盖了常用功能。 完整的 Redis 工具类 以下工具类可以实现基本的 Redis 操…...

编程日记 2025/1/6 19:40:38

生成xcframework

打包 XCFramework 的方法 XCFramework 是苹果推出的一种多平台二进制分发格式，可以包含多个架构和平台的代码。打包 XCFramework 通常用于分发库或框架。 使用 Xcode 命令行工具打包 通过 xcodebuild 命令可以打包 XCFramework。确保项目已经配置好需要支持的平台…...

编程新知 2025/10/5 2:30:38

调用支付宝接口响应40004 SYSTEM_ERROR问题排查

在对接支付宝API的时候，遇到了一些问题，记录一下排查过程。 Body:{"datadigital_fincloud_generalsaas_face_certify_initialize_response":{"msg":"Business Failed","code":"40004","sub_msg…...

编程新知 2026/2/8 20:41:48

Java 8 Stream API 入门到实践详解

一、告别 for 循环&#xff01; 传统痛点&#xff1a; Java 8 之前&#xff0c;集合操作离不开冗长的 for 循环和匿名类。例如&#xff0c;过滤列表中的偶数&#xff1a; List<Integer> list Arrays.asList(1, 2, 3, 4, 5); List<Integer> evens new ArrayList…...

编程新知 2026/1/12 10:41:22

【入坑系列】TiDB 强制索引在不同库下不生效问题

文章目录 背景SQL 优化情况线上SQL运行情况分析怀疑1：执行计划绑定问题？尝试：SHOW WARNINGS 查看警告探索 TiDB 的 USE_INDEX 写法Hint 不生效问题排查解决参考背景 项目中使用 TiDB 数据库，并对 SQL 进行优化了，添加了强制索引。 UAT 环境已经生效，但 PROD 环境强制索…...

编程新知 2026/1/31 21:56:58

华硕a豆14 Air香氛版，美学与科技的馨香融合

在快节奏的现代生活中&#xff0c;我们渴望一个能激发创想、愉悦感官的工作与生活伙伴&#xff0c;它不仅是冰冷的科技工具&#xff0c;更能触动我们内心深处的细腻情感。正是在这样的期许下&#xff0c;华硕a豆14 Air香氛版翩然而至&#xff0c;它以一种前所未有的方式&#x…...

编程新知 2026/1/29 14:27:00

C#中的CLR属性、依赖属性与附加属性

CLR属性的主要特征 封装性&#xff1a; 隐藏字段的实现细节 提供对字段的受控访问 访问控制&#xff1a; 可单独设置get/set访问器的可见性 可创建只读或只写属性 计算属性&#xff1a; 可以在getter中执行计算逻辑 不需要直接对应一个字段 验证逻辑&#xff1a; 可以…...

编程新知 2025/12/4 0:13:33

C++ 设计模式 《小明的奶茶加料风波》

&#x1f468;‍&#x1f393; 模式名称&#xff1a;装饰器模式&#xff08;Decorator Pattern&#xff09; &#x1f466; 小明最近上线了校园奶茶配送功能&#xff0c;业务火爆&#xff0c;大家都在加料&#xff1a; 有的同学要加波霸 &#x1f7e4;&#xff0c;有的要加椰果…...

编程新知 2026/1/31 8:45:21

【Post-process】【VBA】ETABS VBA FrameObj.GetNameList and write to EXCEL

ETABS API实战：导出框架元素数据到Excel 在结构工程师的日常工作中，经常需要从ETABS模型中提取框架元素信息进行后续分析。手动复制粘贴不仅耗时，还容易出错。今天我们来用简单的VBA代码实现自动化导出。 🎯 我们要实现什么？ 一键点击，就能将ETABS中所有框架元素的基…...

编程新知 2026/2/6 5:51:08

WEB3全栈开发——面试专业技能点P7前端与链上集成

一、Next.js技术栈 ✅ 概念介绍 Next.js 是一个基于 React 的 服务端渲染&#xff08;SSR&#xff09;与静态网站生成&#xff08;SSG&#xff09; 框架&#xff0c;由 Vercel 开发。它简化了构建生产级 React 应用的过程&#xff0c;并内置了很多特性&#xff1a; ✅ 文件系…...

编程新知 2025/11/22 5:40:56

goreplay

1.github地址 https://github.com/buger/goreplay 2.简单介绍 GoReplay 是一个开源的网络监控工具&#xff0c;可以记录用户的实时流量并将其用于镜像、负载测试、监控和详细分析。 3.出现背景 随着应用程序的增长&#xff0c;测试它所需的工作量也会呈指数级增长。GoRepl…...

编程新知 2026/2/10 4:32:45