UNI-APP 打包构建 APK

2024-08-29 10:36
文章标签 构建 app 打包 uni apk

本文主要是介绍UNI-APP 打包构建 APK，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

UNI-APP 打包构建 APK

  • 前言
  • 一、WINDOWS（在线 - 纯命令版）
    • 依赖
    • 其他前置准备
    • 实现原理
    • 操作步骤
  • 二、WINDOWS（离线 - Android Studio 版）
    • 依赖（首次构建需要联网安装依赖）
    • 其他前置准备
    • 实现原理
    • 操作步骤
  • 三、WINDOWS（离线 - 纯命令版）
    • 依赖
    • 其他前置准备
    • 实现原理
    • 操作步骤
  • 四、LINUX（离线 - 纯命令版）
    • 依赖（以下各工具版本相互依赖）[^2]
    • 其他前置准备
    • 实现原理
    • 操作步骤
      • 步骤一：安装 JDK 17【可自行选择其他方式安装依赖】
      • 步骤二：下载 Gradle 7.5，上传到服务器
      • 步骤三：安装 SDK 环境
      • 步骤四：验证环境
      • 步骤五：构建打包 APK
  • 五、Android 项目模板制作
    • 操作步骤一：将 UNI-APP 项目打包成 Android 可用的资源
    • 操作步骤二：制作 APK 构建模板
  • 六、基于 Jenkins 自动化打包【待补充...】
  • 附录

前言

  • 由于使用 HbuilderX 的图形化界面有相对完整的教程，这里不在赘述
  • 本文主要使用 Android Studio 进行打包和使用纯命令的进行打包
  • 同步可以参考UNI-APP 官方 App 离线打包教程：
    • Android 原生工程配置
    • Android 打包发行
    • 本地 Android 环境配置时可参照App 云端打包环境

一、WINDOWS（在线 - 纯命令版）

依赖

  • HbuilderX 编辑器（根目录自带 CLI）

CLI

其他前置准备

  • 登录 HbuilderX 的 DCloud 账号

登录

实现原理

  • 利用 RPC 调用 HbuilderX 编辑器的功能
  • 相当于手动打开 HbuilderX 并触发“发行”功能，所以极度依赖 WINDOWS 的图形化界面

操作步骤

  1. 编写配置文件，放在项目根目录即可1
// hxconfig.json{//项目名字或项目绝对路径"project": "project-name",//打包平台 默认值android  值有"android","ios" 如果要打多个逗号隔开打包平台"platform":"android",//是否使用自定义基座 默认值false  true自定义基座 false自定义证书"iscustom": false,//打包方式是否为安心打包默认值false,true安心打包,false传统打包"safemode": true,//android打包参数"android": {//安卓包名"packagename":"com.company.www",//安卓打包类型 默认值0 0使用自有证书 || 1使用公共证书 || 2使用老版证书 || 3使用云端证书"androidpacktype":"0",//安卓使用自有证书自有打包证书参数//安卓打包证书别名,自有证书打包填写的参数"certalias":"test",//安卓打包证书文件路径,自有证书打包填写的参数"certfile":"C:/Users/15770/Desktop/project/test-store.keystore",//安卓打包证书密码,自有证书打包填写的参数"certpassword":"cert-pwd",//安卓平台要打的渠道包 取值有"google","yyb","360","huawei","xiaomi","oppo","vivo"，如果要打多个逗号隔开"channels":""},//是否混淆 true混淆 false关闭"isconfusion":false,//开屏广告 true打开 false关闭"splashads":false,//悬浮红包广告true打开 false关闭"rpads":false,//push广告 true打开 false关闭"pushads":false,//加入换量联盟 true加入 false不加入"exchange":false
}
  1. 添加 CLI 的环境变量
  2. 执行以下前 3 条命令即可完成打包
# 1. 打开 HbuilderX
cli open# 2. 打开项目（由于 cli 所在的位置不是项目路径，所以基于 cli 的命令只能用绝对路径，以下同理）
cli project open --path C:/Users/15770/Desktop/project# 3. 读取配置文件进行打包
cli pack --config C:/Users/15770/Desktop/project/hxconfig.json# 4. 关闭项目
cli project close --path C:/Users/15770/Desktop/project
  1. 最终效果如图，路径project\dist\release\apk

通过云打包生成的 APK

二、WINDOWS（离线 - Android Studio 版）

依赖（首次构建需要联网安装依赖）

  • 【可选】Chocolatey（Software Management for Windows）：这是 WINDOWS 软件包管理工具，在本文中的唯一作用就是为下面的工具包提供方便的安装途径
  • 【必选 1/5】JDK：可用JDK 13（手动安装）
  • 【必选 2/5】Gradle：可用Gradle 6.5，核心工具，用途类似maven（可以通过 AS 自动拉取）
  • 【必选 3/5】gradle-plugin：可用com.android.tools.build:gradle:4.1.1（可以通过 AS 自动拉取）
  • 【可选】Android SDK：主要提供sdkmanager命令执行的环境（可以通过 AS 自动拉取）
    • 【必选 4/5】android：可用platforms;android-30，开发者可以根据需要下载和安装不同的平台版本，以便为特定版本的 Android 系统开发和测试应用。包含了该版本的 Android 核心库、资源和 API，确保应用能够使用该版本特有的功能
    • 【必选 5/5】build-tools：可用build-tools;30.0.3，用于构建和打包 Android 应用的工具集合。这些工具包括编译器、打包工具等，帮助开发者将应用的源代码转换成可以在设备或模拟器上运行的 APK 或 AAR 文件

其他前置准备

  • 制作 Android 的项目模板，请参照《第五章：Android 项目模板制作》

实现原理

  • 通过 Android Studio 图形化界面构建 APK

操作步骤

  1. 安装 Chocolatey CLI【可自行选择其他方式安装依赖】
# 使用 cmd 进行安装，直接在小黑窗中执行以下命令
@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "[System.Net.ServicePointManager]::SecurityProtocol = 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"
  1. 基于 choco 安装 JDK（五大核心依赖之一：JDK）
choco install openjdk13
# 所在路径 C:\Program Files\OpenJDK\jdk-13.0.2
  1. 使用 Android Studio 打开《第五章：Android 项目模板制作》创建的模板，并配置好SDK（五大核心依赖之二：android & build-tools）

SDK 配置

SDK 配置

  1. 打开设置，修改指定版本的JDK

设置 JDK 版本

  1. 点击构建项目，构建成功后继续生成 APK，按以下步骤选择和填充信息即可，这一步依赖于前面的准备工作，并且会联网拉取最终的两个依赖（五大核心依赖之二：Gradle & gradle-plugin）

构建项目

构建成功

选择生成 APK

选择 APK

填写证书信息

生成 Release 版本

  1. 最终效果如图，路径HBuilder-Integrate-AS\simpleDemo\release

通过 AS 生成的 APK

三、WINDOWS（离线 - 纯命令版）

依赖

  • 【可选】Chocolatey（Software Management for Windows）：这是 WINDOWS 软件包管理工具，在本文中的唯一作用就是为下面的工具包提供方便的安装途径
  • 【必选 1/5】JDK：可用JDK 13（手动安装）
  • 【必选 2/5】Gradle：可用Gradle 6.5，核心工具，用途类似maven（可以通过代码自动拉取）
  • 【必选 3/5】gradle-plugin：可用com.android.tools.build:gradle:4.1.1（可以通过代码自动拉取）
  • 【可选】Android SDK：主要提供sdkmanager命令执行的环境（手动安装，并在local.properties指定SDK路径）
    • 【必选 4/5】android：可用platforms;android-30，开发者可以根据需要下载和安装不同的平台版本，以便为特定版本的 Android 系统开发和测试应用。包含了该版本的 Android 核心库、资源和 API，确保应用能够使用该版本特有的功能
    • 【必选 5/5】build-tools：可用build-tools;30.0.3，用于构建和打包 Android 应用的工具集合。这些工具包括编译器、打包工具等，帮助开发者将应用的源代码转换成可以在设备或模拟器上运行的 APK 或 AAR 文件

其他前置准备

  • 制作 Android 的项目模板，请参照《第五章：Android 项目模板制作》

实现原理

  • 通过 windows 的gradlew脚本处理构建 APK

gradlew脚本

操作步骤

  1. 安装 Chocolatey CLI【可自行选择其他方式安装依赖】
# 使用 cmd 进行安装，直接在小黑窗中执行以下命令
@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "[System.Net.ServicePointManager]::SecurityProtocol = 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"
  1. 基于 choco 安装 JDK（五大核心依赖之一：JDK）
choco install openjdk13
# 所在路径 C:\Program Files\OpenJDK\jdk-13.0.2
  1. 基于 choco 安装 Gradle（五大核心依赖之一：Gradle）
choco install gradle
# 所在路径 C:\ProgramData\chocolatey\bin
  1. 基于 choco 安装 Android SDK
choco install android-sdk
# 所在路径 C:\Android\android-sdk
  1. 基于 android-sdk 安装 androd：sdkmanager "platforms;android-30"（五大核心依赖之一：androd）
  2. 基于 android-sdk 安装 build-tools：sdkmanager "build-tools;30.0.3"（五大核心依赖之一：build-tools）
  3. cd 进入《第五章：Android 项目模板制作》创建的模板，在根目录HBuilder-Integrate-AS执行以下命令
  • gradlew assembleRelease
  1. 最终效果如图，路径HBuilder-Integrate-AS\simpleDemo\build\outputs\apk\release

通过命令生成 APK

四、LINUX（离线 - 纯命令版）

依赖（以下各工具版本相互依赖）2

  • 【必选 1/5】JDK：可用JDK 17（手动安装）
  • 【必选 2/5】Gradle：可用Gradle 7.5，核心工具，用途类似maven（可以通过代码自动拉取）
  • 【必选 3/5】gradle-plugin：可用com.android.tools.build:gradle:7.4.2（可以通过代码自动拉取）
  • 【可选】Android SDK：主要提供sdkmanager命令执行的环境（手动安装，并在local.properties指定SDK路径）
    • 【必选 4/5】android：可用platforms;android-30，开发者可以根据需要下载和安装不同的平台版本，以便为特定版本的 Android 系统开发和测试应用。包含了该版本的 Android 核心库、资源和 API，确保应用能够使用该版本特有的功能
    • 【必选 5/5】build-tools：可用build-tools;30.0.3，用于构建和打包 Android 应用的工具集合。这些工具包括编译器、打包工具等，帮助开发者将应用的源代码转换成可以在设备或模拟器上运行的 APK 或 AAR 文件

其他前置准备

  • 制作 Android 的项目模板，请参照《第五章：Android 项目模板制作》

实现原理

  • 通过 linux 的gradlew脚本处理构建 APK

gradlew 脚本

操作步骤

步骤一：安装 JDK 17【可自行选择其他方式安装依赖】

  1. 下载 JDK 压缩包

下载 JDK 压缩包

  1. 上传到服务器后解压缩到指定文件夹，cd 到对应目录后执行命令tar -zxvf jdk-17_linux-x64_bin.tar.gz -C /usr/lib/

上传 JDK 压缩包

解压缩 JDK

  1. 配置环境变量
# 编辑环境变量
vim ~/.bashrc# 刷新环境变量（生效）
source ~/.bashrc# 确认环境变量是否生效（看清楚只有一个横杆）
java -version

# vim ~/.bashrc 编辑环境变量参考内容
# JAVA
export JAVA_HOME=/usr/lib/jdk-17.0.12# PATH
export PATH=$JAVA_HOME/bin:$PATH

配置环境变量

  1. 确认环境变量是否生效

确认环境变量是否生效

步骤二：下载 Gradle 7.5，上传到服务器

  1. 下载 Gradle 7.5，创建文件夹存储 gradle
mkdir /Android/gradle -p

下载 Gradle 压缩包

上传 Gradle 压缩包

步骤三：安装 SDK 环境

  1. 从 Android Studio 的官方网站下载sdkmanager的命令行工具，上传到服务器

下载命令行工具

上传命令行工具

  1. 解压缩命令行工具3
# 安装 zip 格式解压缩工具
apt install unzip# 解压缩到指定文件夹
unzip commandlinetools-linux-11076708_latest.zip -d /Android/sdk

解压缩命令行工具

  1. 修改SDK目录结构4

sdkmanager 说明文档

cd /Android/sdk/cmdline-tools/
mkdir latest
mv !(latest) latest/
  1. 修改后的目录结构如图

修改后的目录结构

  1. 安装platforms;android-30
cd /Android/sdk/cmdline-tools/latest/bin/
./sdkmanager "platforms;android-30"

安装 platforms;android-30

  1. 安装build-tools;30.0.3
cd /Android/sdk/cmdline-tools/latest/bin/
./sdkmanager "build-tools;30.0.3"

安装 build-tools;30.0.3

  1. 最终SDK目录

最终 SDK 目录

步骤四：验证环境

  1. 至此，所有环境配置完成，修改项目代码SDK配置，并验证环境是否有问题。先创建文件夹，然后上传《第五章：Android 项目模板制作》准备好的代码模板
mkdir /Android/code

上传代码模板

  1. 找到代码文件路径HBuilder-Integrate-AS\local.properties，修改SDK引用路径
sdk.dir=/Android/sdk

修改 SDK 路径

  1. 找到代码文件HBuilder-Integrate-AS/gradle/wrapper/gradle-wrapper.properties，修改Gradle引用路径，如果这里不修改，首次构建会从线上拉取
distributionUrl=file:///Android/gradle/gradle-7.5-bin.zip

修改 Gradle 路径

  1. 【高版本需同时修改以下三个文件】本案例中用的环境相对都是比较高的版本，需要同时修改相应的文件才能调用相关的 API，并且需要满足一些新版本特殊设置
  • HBuilder-Integrate-AS/build.gradle

修改 gradle-plugin 版本

  • HBuilder-Integrate-AS/simpleDemo/build.gradle

修改运行 SDK 版本号

  • /Android/code/HBuilder-Integrate-AS/simpleDemo/src/main/AndroidManifest.xml
android:exported="true"

修改高版本特殊配置，设置为可被其他应用程序访问

  1. 修改gradlew脚本权限，并测试是否能正常使用
cd /Android/code/HBuilder-Integrate-AS/
ls -al gradlew
chmod +x gradlew
ls -al gradlew
./gradlew tasks

运行 gradlew 脚本

  1. 出现assemble证明环境验证通过

环境验证通过

步骤五：构建打包 APK

  1. 执行以下打包命令，首次打包会联网下载依赖
cd /Android/code/HBuilder-Integrate-AS/
./gradlew assembleRelease

打包 APK 成功

  1. 最终效果如图，路径HBuilder-Integrate-AS/simpleDemo/build/outputs/apk/release

通过命令生成 APK

五、Android 项目模板制作

操作步骤一：将 UNI-APP 项目打包成 Android 可用的资源

  1. cd 到 UNI-APP 项目的根目录，执行 package.json 中的打包命令，生成 Android 可用使用的代码包：npm run build:app-plus

Android 认可的代码

  1. 构建完成在目录 dist/build/app-plus 中会有一份编译后的代码，放入根目录的新文件夹中（使用 manifest.json 中的 appid 一样），并将其 app-plus 重命名为 www
mkdir __UNI__664E2AC
move dist/build/app-plus __UNI__664E2AC\www

新建 appid 名字的文件夹

操作步骤二：制作 APK 构建模板

  1. 下载 UNI-APP 官方提供的离线 SDK，并使用任意编辑器打开
  2. 找到 HBuilder-Integrate-AS 项目，将【步骤一】生成的 __UNI__664E2AC 整个替换到
    HBuilder-Integrate-AS 项目的示例位置 simpleDemo/src/main/assets/apps/__UNI__A

替换前

替换后

  1. 【修改文件 1/4】HBuilder-Integrate-AS\simpleDemo\build.gradle，修改红框部分，其余内容可以按需修改，比如修改 versionCode，字面意思版本号
  • 第 1 处替换为包名，跟 DCloud 平台设置的一致即可
  • 第 2 处放入自己生成的签名证书，生成方式参考附录
  • 第 3 处按签名证书修改对应的内容即可

修改包名和签名

DCloud 包名

  1. 【修改文件 2/4】HBuilder-Integrate-AS\simpleDemo\src\main\AndroidManifest.xml，package跟第 3 步的包名保持一致，andorid:value替换为自己的 AppKey

修改 AppKey

  1. 【非必须】HBuilder-Integrate-AS\simpleDemo\build.gradle，跟第 4 步同个文件，红框部分可自定义生成的 APK 名称

自定义 APK 名称

生成 APK 名称

  1. 【非必须】HBuilder-Integrate-AS\simpleDemo\src\main\res\values\strings.xml，修改红框部分，这是最终安装到手机后看到的 APP 的名字

APP 名称设置

APP 名称

  1. 【非必须】HBuilder-Integrate-AS\simpleDemo\src\main\res\drawable\*，修改红框部分
  • icon.png为应用的图标
  • push.png为推送消息的图标
  • splash.png为应用启动页的图标

应用 LOGO

  1. 【修改文件 3/4】HBuilder-Integrate-AS\simpleDemo\src\main\assets\data\dcloud_control.xml，修改红框部分，和原来的 UNI-APP 项目 manifest.json 中的 appid 保持一致

修改 appid

原 UNI-APP 项目

  1. 【非必须】HBuilder-Integrate-AS\gradle\wrapper\gradle-wrapper.properties，修改红框部分，可以替换为本地gradle，为全离线打包做准备

替换本地 gradle

  1. 【修改文件 4/4】（通过 AS 打开会自动生成）HBuilder-Integrate-AS\local.properties，在根目录新增local.properties文件，引入 SDK

引入 SDK

六、基于 Jenkins 自动化打包【待补充…】

附录

  • 生成 keystore 签名证书
// keytool 依赖 JDK
// 生成命令
keytool -genkey -alias test -keyalg RSA -keysize 2048 -validity 36500 -keystore company-test.keystore// 查看命令
keytool -list -v -keystore company-test.keystore
  • gradlew 常用命令
// 用于清理项目构建过程中生成的临时文件和输出文件，说人话就是会删除整个 build 文件夹
gradlew clean// 列出可用的构建任务，主要看看 assemble 在不在，不在的话就不用白费力气打包了
gradlew tasks// 编译打包构建 APK
gradlew assemble
gradlew assembleDebug
gradlew assembleRelease

其他参考网址

  1. HbuilderX CLI 打包说明 ↩︎

  2. gradle 和 gradle-plugin 版本对应关系 ↩︎

  3. Android Studio 命令行工具说明 ↩︎

  4. sdkmanager 使用说明 ↩︎

这篇关于UNI-APP 打包构建 APK的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


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

相关文章

配置springboot项目动静分离打包分离lib方式

配置springboot项目动静分离打包分离lib方式

《配置springboot项目动静分离打包分离lib方式》本文介绍了如何将SpringBoot工程中的静态资源和配置文件分离出来,以减少jar包大小,方便修改配置文件,通过在jar包同级目录创建co... 目录前言1、分离配置文件原理2、pom文件配置3、使用package命令打包4、总结前言默认情况下，
阅读更多...
nginx-rtmp-module构建流媒体直播服务器实战指南

nginx-rtmp-module构建流媒体直播服务器实战指南

《nginx-rtmp-module构建流媒体直播服务器实战指南》本文主要介绍了nginx-rtmp-module构建流媒体直播服务器实战指南,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有... 目录1. RTMP协议介绍与应用RTMP协议的原理RTMP协议的应用RTMP与现代流媒体技术的关系2
阅读更多...
macOS怎么轻松更换App图标? Mac电脑图标更换指南

macOS怎么轻松更换App图标? Mac电脑图标更换指南

《macOS怎么轻松更换App图标?Mac电脑图标更换指南》想要给你的Mac电脑按照自己的喜好来更换App图标？其实非常简单，只需要两步就能搞定,下面我来详细讲解一下... 虽然 MACOS 的个性化定制选项已经「缩水」，不如早期版本那么丰富，www.chinasem.cn但我们仍然可以按照自己的喜好来更换
阅读更多...
Python项目打包部署到服务器的实现

Python项目打包部署到服务器的实现

《Python项目打包部署到服务器的实现》本文主要介绍了PyCharm和Ubuntu服务器部署Python项目,包括打包、上传、安装和设置自启动服务的步骤,具有一定的参考价值,感兴趣的可以了解一下... 目录一、准备工作二、项目打包三、部署到服务器四、设置服务自启动一、准备工作开发环境：本文以PyChar
阅读更多...
Python中构建终端应用界面利器Blessed模块的使用

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

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

Python pyinstaller实现图形化打包工具

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

Golang使用etcd构建分布式锁的示例分享

《Golang使用etcd构建分布式锁的示例分享》在本教程中,我们将学习如何使用Go和etcd构建分布式锁系统,分布式锁系统对于管理对分布式系统中共享资源的并发访问至关重要,它有助于维护一致性,防止竞... 目录引言环境准备新建Go项目实现加锁和解锁功能测试分布式锁重构实现失败重试总结引言我们将使用Go作
阅读更多...
javafx 如何将项目打包为 Windows 的可执行文件exe

javafx 如何将项目打包为 Windows 的可执行文件exe

《javafx如何将项目打包为Windows的可执行文件exe》文章介绍了三种将JavaFX项目打包为.exe文件的方法：方法1使用jpackage（适用于JDK14及以上版本）,方法2使用La... 目录方法 1：使用 jpackage（适用于 JDK 14 及更高版本）方法 2：使用 Launch4j（
阅读更多...
React实现原生APP切换效果

React实现原生APP切换效果

《React实现原生APP切换效果》最近需要使用Hybrid的方式开发一个APP,交互和原生APP相似并且需要IM通信,本文给大家介绍了使用React实现原生APP切换效果,文中通过代码示例讲解的非常... 目录背景需求概览技术栈实现步骤根据 react-router-dom 文档配置好路由添加过渡动画使用
阅读更多...
嵌入式QT开发：构建高效智能的嵌入式系统

嵌入式QT开发：构建高效智能的嵌入式系统

摘要： 本文深入探讨了嵌入式 QT 相关的各个方面。从 QT 框架的基础架构和核心概念出发，详细阐述了其在嵌入式环境中的优势与特点。文中分析了嵌入式 QT 的开发环境搭建过程，包括交叉编译工具链的配置等关键步骤。进一步探讨了嵌入式 QT 的界面设计与开发，涵盖了从基本控件的使用到复杂界面布局的构建。同时也深入研究了信号与槽机制在嵌入式系统中的应用，以及嵌入式 QT 与硬件设备的交互，包括输入输出设
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2