移动端开发框架mui代码打包APP(生成安卓安装包)、生成APK文件

开发工具

HBuilder X 3.8.12.20230817

注意：开发工具尽量用最新的或较新的。太旧的版本在开发调试过程中可能会出现莫名其妙的问题。

产品说明及开发文档

文档 - DCloud问答

---

1、账号注册

打开dcloud官网，直接点击下方链接DCloud - 数字天堂官网、HBuilderX、HBuilder、uni-app、uniapp、5+、5plus、mui、wap2app、流应用、HTML5、小程序开发、跨平台App、多端框架

在右上方，点击开发者后台按钮，进入登录页面，如果没有账号则点击账号注册进入注册界面：

注意：注册账号需要邮箱及邮箱验证码

未注册账号，也可以打开开发工具 HBuilder X 3.8.12 ，在左下角会显示未登录状态，点击‘未登录’ 按钮，会弹出登录界面，在登录页面中点击 ‘还没账号？注册用户’ 链接，同样可以打开到账号注册页面。

2、创建项目

点击开发工具中间位置的 新建项目 按钮，打开新建项目界面：

HBuilder X开发APP主要有这两种模式：uni-app  和 5+App  。之前的项目是 5+App模式的，不过没关系。新项目建议还是使用uni-app 进行开发。

在新建项目页面，可以看到选择 uni-app 或 5+App模式，有相关的功能案例或演示组件，方便学习。

选择合适的开发模式，输入项目名称、选择项目路径 及 选择模板，点击创建按钮新建项目。

3、项目配置之AppID
 

DCloud appid（以后简称 appid） 是 DCloud 应用的唯一标识，在 DCloud 提供的所有服务中，都会以 appid 来标记一个应用。注意这和各家小程序的appid以及Apple的appid（其实就是iOS的包名）是不同的体系。

注意：未登录账号，创建的APP应用是无法分配 AppID的，需登录账号后，打开项目配置文件 manifest.json的基础配置选项中，找到应用标识点击重新获取按钮以同步到dcloud后台

4、项目配置之基础配置

APP项目创建完成后，如需对项目进行配置，打开项目的配置文件 manifest.json ,打开基础配置项：

可以看到有以下配置

• 应用标识（AppID）: DCloud 应用的唯一标识
• 应用名称：APP名称，打包安装到手机上显示的应用名。
• 应用版本：APP的版本，系统默认是 1.0.0 ,每次升级时需要更新此项，APP端可以获取版本进行校验是否新版本以进行更新操作。
• 应用版本号：这个默认是 100 ，APP内容升级可以忽略掉 或 填写你想要的数据，必须是整数。
• 应用入口页(首页)地址：这个是打开应用是默认打开的页面，默认为根目录的index.html;也可以是网络地址，网络地址必须以 http:// 或 https:// 开头。
• 应用描述：
• 应用是否全屏显示：对系统进行竖屏或横屏显示进行设置，或者跟随手机系统进行竖屏横屏自动切换操作。

为了方便演示，后续的操作步骤将使用项目案例中的配置或操作进行截图

5、项目配置之图标配置

APP项目创建完成后，如需对项目进行配置，打开项目的配置文件 manifest.json ,打开图标配置项：

可以看到有以下配置

• 自动生成图标：这个主要是对APP的图标进行设置，像安卓、平板、iPhone、app store等，不同的设备或平台需要设置不同尺寸（分辨率的图标，所以提供的APP图标尺寸（分辨率）尽量大一些。

准备好APP的图标后，加入到项目中，点击 浏览 按钮找到项目图标，然后点击   自动生成

所有图标并替换。待系统生成对应的图标后，可以点击 浏览生成图标所在目录  进行查看。

浏览生成图标所在目录

6、项目配置之启动界面配置

APP项目创建完成后，如需对项目进行配置，打开项目的配置文件 manifest.json ,打开启动界面配置项：

可以看到有以下配置

• 应用界面选项：启动界面是否需要加载提示信息等。
• Android启动界面设置：对启动界面的logo显示、隐私政策提示进行设置。
• ios启动界面设置：对ios平台启动时界面进行设置。
   

uni-app官网

7、项目配置之模块配置

APP项目创建完成后，如需对项目进行配置，打开项目的配置文件 manifest.json ,打开模块配置项：

可以看到有以下配置

• 打包模块配置：项目中需要用到哪些功能则进行勾选及配置，例如：Geolocation(定位)、Camera&Gallery(相机和相册)、Push（消息推送）等等。
• uni-ad：uni-ad聚合目前国内流行的广告平台优量汇、穿山甲、快手、百度等广告渠道，支持开屏广告和信息流、Banner广告。

8、项目配置之启动界面配置

APP项目创建完成后，如需对项目进行配置，打开项目的配置文件 manifest.json ,打开模块配置项：

可以看到有以下配置

• Android打包权限配置：选择APP需要的权限（用户安装APP后需要授权），否则某些功能会无法使用。
• ios隐私信息访问的许可描述：ios平台权限调用原因说明。

Android权限配置参考文档：uni-app官网

9、项目配置之App常用其他设置

APP项目创建完成后，如需对项目进行配置，打开项目的配置文件 manifest.json ,打开App常用其他设置项：

自定义404错误页面：uni-app官网

10、项目配置之源码视图

APP项目创建完成后，如需对项目进行配置，打开项目的配置文件 manifest.json ,打开源码视图项：

11、打包APP（安卓apk）

如果项目配置及功能在本地测试没问题后，就可以打包成正式版APP安装包了。

项目本地测试，安装到手机或模拟器测试请看以下资料：

移动端开发框架mui代码在手机（真机）上运行（HbuilderX连接到手机）_hbuilderx手机版-优快云博客
移动端开发框架mui代码在安卓模拟器上运行（HbuilderX连接到模拟器）_hbuilder安卓模拟器-优快云博客

项目打包：

1. 打开 hbuilder X 开发工具, 先选择项目或打开项目文件
2. 在左上方菜单栏依次打开：发行 》 原生App-云打包
3. 在App打包界面：选择 使用自有证书，及完善证书相关信息（证书别名、证书私钥密码、证书文件等），才能使用打包功能。
4. 选择快速安心打包（不上传代码及证书，打包更新），点击打包按钮以完成打包操作。

安卓APP打包证书相关信息：需要使用一些工具（例如：安卓原生开发的话，直接用andriod studio工具可以直接创建证书） 或 第三方站点来生成证书相关信息。这里使用第三方站点来创建可以看这篇文章：android打包证书文件在线生成_安卓证书在线生成-优快云博客
 

证书生成主网站：香蕉云编-app打包上架工具类平台

最后创建好证书后，下载证书文件（后缀名为 .keystore）及记住填写的证书别名、密钥密码等信息

证书信息弄好后，把相关的信息填入到打包界面，并执行打包：

注意：在打包配置界面，如果页面顶端没有红色提示信息（有错误提示则需要根据对应的信息进行处理），则说明可以正常打包的，即可点击打包按钮进行下一步操作。

待进度条执行完毕后，可以在Hbuilder X 控制台查看APP打包进度（状态）：

等待系统打包完成，会在项目目录中生成一个 apk 文件，这个文件就是我们需要的正式版APP安装包。

点击 打开所在目录，即跳转到apk打包文件列表，以及可以安装到手机及拷贝到磁盘中。