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

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

news 2026/1/15 18:10:01

一、简介

  • 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

设计模式和设计原则回顾

设计模式和设计原则回顾 23种设计模式是设计原则的完美体现，设计原则设计原则是设计模式的理论基石， 设计模式 在经典的设计模式分类中（如《设计模式：可复用面向对象软件的基础》一书中），总共有23种设计模式，分为三大类： 一、创建型模式（5种） 1. 单例模式（Sing…...

编程新知 2025/12/14 20:57:41

Linux相关概念和易错知识点（42）（TCP的连接管理、可靠性、面临复杂网络的处理）

目录 1.TCP的连接管理机制（1）三次握手①握手过程②对握手过程的理解 （2）四次挥手（3）握手和挥手的触发（4）状态切换①挥手过程中状态的切换②握手过程中状态的切换 2.TCP的可靠性&…...

编程新知 2026/1/15 4:25:34

剑指offer20_链表中环的入口节点

链表中环的入口节点 给定一个链表，若其中包含环，则输出环的入口节点。 若其中不包含环，则输出null。 数据范围 节点 val 值取值范围 [ 1 , 1000 ] [1,1000] [1,1000]。 节点 val 值各不相同。 链表长度 [ 0 , 500 ] [0,500] [0,500]。 …...

编程新知 2026/1/15 6:38:00

spring：实例工厂方法获取bean

spring处理使用静态工厂方法获取bean实例，也可以通过实例工厂方法获取bean实例。 实例工厂方法步骤如下： 定义实例工厂类（Java代码），定义实例工厂（xml），定义调用实例工厂&#xff…...

编程新知 2025/11/25 22:46:30

涂鸦T5AI手搓语音、emoji、otto机器人从入门到实战

“🤖手搓TuyaAI语音指令 😍秒变表情包大师，让萌系Otto机器人🔥玩出智能新花样！开整！” 🤖 Otto机器人 → 直接点明主体 手搓TuyaAI语音 → 强调 自主编程/自定义 语音控制（TuyaAI…...

编程新知 2026/1/14 11:05:53

重启Eureka集群中的节点，对已经注册的服务有什么影响

先看答案，如果正确地操作，重启Eureka集群中的节点，对已经注册的服务影响非常小，甚至可以做到无感知。 但如果操作不当，可能会引发短暂的服务发现问题。 下面我们从Eureka的核心工作原理来详细分析这个问题。 Eureka的…...

编程新知 2025/9/24 3:38:34

C++.OpenGL （14/64）多光源（Multiple Lights）

多光源（Multiple Lights） 多光源渲染技术概览 #mermaid-svg-3L5e5gGn76TNh7Lq {font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}#mermaid-svg-3L5e5gGn76TNh7Lq .error-icon{fill:#552222;}#mermaid-svg-3L5e5gGn76TNh7Lq .erro…...

编程新知 2025/6/11 3:15:20

JavaScript基础-API 和 Web API

在学习JavaScript的过程中，理解API（应用程序接口）和Web API的概念及其应用是非常重要的。这些工具极大地扩展了JavaScript的功能，使得开发者能够创建出功能丰富、交互性强的Web应用程序。本文将深入探讨JavaScript中的API与Web AP…...

编程新知 2025/8/21 23:03:46

【SSH疑难排查】轻松解决新版OpenSSH连接旧服务器的“no matching...“系列算法协商失败问题

【SSH疑难排查】轻松解决新版OpenSSH连接旧服务器的"no matching..."系列算法协商失败问题 摘要： 近期，在使用较新版本的OpenSSH客户端连接老旧SSH服务器时，会遇到 "no matching key exchange method found"​, "n…...

编程新知 2025/9/29 4:00:38

免费数学几何作图web平台

光锐软件免费数学工具，maths,数学制图，数学作图，几何作图，几何，AR开发,AR教育,增强现实,软件公司,XR,MR,VR,虚拟仿真,虚拟现实,混合现实,教育科技产品,职业模拟培训,高保真VR场景,结构互动课件,元宇宙http://xaglare.c…...

编程新知 2026/1/15 5:02:31