使用 HBuilder X Android Studio 打包 uni-app 为 APK 完整教程一、所需工具代码开发工具HBuilder XAPK 打包工具Android StudioAPK 打包 SDKAndroid 离线 SDK下载地址Android 离线 SDK生成签名证书的工具JDK 1.8说明只需 JRE 也可但 JDK 包含 JRE推荐直接安装 JDK并配置环境变量环境变量配置参考JDK 环境变量配置教程生成 AppKey 的网站DCloud 开发者中心网址开发者中心二、导出前的配置HBuilder X在 HBuilder X 中打开 uni-app 项目找到manifest.json文件并打开。在可视化配置界面中主要配置基础信息uni-app 应用标识AppID如果默认没有点击“重新获取”即可自动生成会有警告不影响使用。Vue 版本按项目实际情况选择。其他选项可暂填任意内容仅用于打包测试。三、导出 uni-app 项目资源确保项目在手机上运行测试通过。点击 HBuilder X 顶部菜单发行 → 原生App-本地打包 → 生成本地打包App资源。首次点击可能提示安装必要组件按提示安装即可。导出成功后控制台会显示资源路径。记下该路径HBuilder X 的任务至此完成。四、下载并准备 Android 离线 SDK从 Android 离线 SDK 下载 SDK。解压后将 HBuilder X 导出的文件夹即上一步控制台显示的路径注意是www文件夹的上一级该文件夹以 AppID 命名移动到以下目录HBuilder-Integrate-AS\simpleDemo\src\main\assets\apps该目录下默认有一个名为__UNI__A的文件夹直接删除。五、使用 Android Studio 导入 SDK 示例项目安装 Android Studio若已安装可跳过。下载地址Android Studio 官方下载打开 Android Studio导入离线 SDK 中的HBuilder-Integrate-AS文件夹。注意文件路径中不要包含中文否则可能报错。六、修改dcloud_control.xml中的 AppID在 Android Studio 项目结构中找到assets/data/dcloud_control.xml文件。将文件中appid的值修改为你在 HBuilder X 中生成的 AppID即移动过来的那个文件夹的名称。七、生成 Android 签名证书1. 简介Android 平台打包 APK 需要使用数字证书.keystore文件进行签名证书可自助免费生成。2. 使用 keytool 命令生成证书打开命令行CMD执行以下操作d:setPATH%PATH%;C:\Program Files\Java\jre1.8.0_201\bin第一行切换工作目录到 D 盘可自定义第二行将 JRE 命令添加到临时环境变量路径根据你的 JDK 实际安装位置修改执行生成命令keytool-genkey-aliastestalias-keyalgRSA-keysize2048-validity36500-keystoretest.keystore参数说明testalias证书别名可自定义建议英文数字test.keystore证书文件名可自定义36500有效期天100年建议足够长按提示输入信息输入证书密码需记住确认密码姓名、组织单位、组织名称、城市、省份、国家代码中国为 CN最后确认输入是否正确输入y提示“Enter key password for ”时直接回车保持与证书密码一致生成成功后证书位于D:\test.keystore。3. 查看证书信息获取 SHA1keytool-list-v-keystoretest.keystore输入密码后输出信息中包含证书指纹Certificate fingerprintsSHA1形如BB:AC:E2:2F:97:3B:18:02:E7:D6:69:A3:7A:28:EF:D2:3F:A3:68:E7注意新版 JDK 可能不再显示 MD5但 SHA1 仍然可用。保存好 SHA1 值后续生成 AppKey 时需要。八、生成 AppKey登录 DCloud 开发者中心。在“我的应用”中找到你在 HBuilder X 中创建的应用AppID 已自动同步点击应用名称进入管理页面。选择平台Android。填写信息Android 包名打开离线 SDK 中的HBuilder-Integrate-AS\simpleDemo\src\main\AndroidManifest.xml找到package属性默认值为com.android.simple请以实际为准。Android 证书签名 SHA1填入上一步获取的 SHA1 值。点击确认生成 AppKey。九、在 Android Studio 中配置 AppKey回到 Android Studio打开AndroidManifest.xml。在application标签内添加如下元数据将生成的AppKey替换为实际值meta-dataandroid:namedcloud_appkeyandroid:value生成的AppKey/十、打包 APK在 Android Studio 菜单栏点击Build → Generate Signed Bundle / APK…选择APK点击Next。点击Choose existing…选择你生成的证书文件test.keystore。自动填充Key store path输入Key store password、Key alias、Key password与生成证书时设置的一致建议勾选Remember passwords方便下次打包点击Next选择输出路径Build Type选择release点击Finish。等待构建完成下方 Build 控制台显示BUILD SUCCESSFUL。在输出路径的release文件夹中找到生成的 APK 文件。十一、安装测试将 APK 安装到手机并打开。若正常启动则打包成功。若提示“AppKey 不存在或配置错误”请检查第九步中 AppKey 是否正确填写。Android 包名是否与AndroidManifest.xml中的包名完全一致。