DevEco Studio中如何将写好的应用打包

DevEco Studio中如何将写好的应用打包 如题，看过文档中的方法和社区的方法，好像因为版本不一样导致没有那些选项

cke_134.png


7 回复

在DevEco Studio中打包应用的操作步骤如下（基于鸿蒙ArkTS开发）：

一、配置签名信息

  1. 打开工程，在顶部菜单栏选择 File > Project Structure 1
  2. 在 Project Structure 界面：
    • 导航选择 Project
    • 点击 Signing Configs 页签
    • 取消勾选 Automatically generate signature 1
    • 手动配置以下信息（需提前准备好密钥文件）：
Store file:       选择.p12格式密钥文件  
Store password:   输入密钥库密码（与生成密钥时一致）  
Key alias:        输入密钥别名（与生成密钥时一致）  
Key password:     输入密钥密码（与生成密钥时一致）  
Sign alg:         固定为 `SHA256withECDSA`  
Profile file:     选择内部测试Profile文件（.p7b格式）  
Certpath file:    选择发布证书文件（.cer格式）
  1. 点击 OK 保存配置

二、编译打包HAP

  1. 在顶部菜单栏选择 Build > Build APP(s)
  2. 构建完成后：
    • HAP包默认输出路径：工程目录/build/outputs/

三、注意事项

  1. 内部测试包限制：
    • 仅支持编译HAP和应用内HSP包（不支持多HSP）
  2. 签名一致性：
    • 确保Store password、Key password与生成密钥时完全一致
  3. 打包产物验证：
    • 检查输出目录中的.hap文件（如entry-default-signed.hap）

说明：若需通过命令行打包（如生成HQF增量包），需使用SDK内置的app_packing_tool.jar工具（路径：DevEco Studio安装目录/sdk/default/openharmony/toolchains/lib），但常规应用打包推荐直接使用DevEco Studio图形化操作

参考：编译打包应用-内部测试-AppGallery Connect（HarmonyOS 5及以上） - 华为HarmonyOS开发者


【核心前提】

  • HarmonyOS 通过数字证书（.cer 文件） 和Profile 文件（.p7b 文件） 保证应用 / 元服务的完整性，发布前必须使用 “发布证书 + 发布 Profile 文件” 完成签名，否则无法上架。

【步骤流程】

1. 准备签名文件（核心步骤）

需先生成密钥 / 证书请求文件，再向 AppGallery Connect 申请正式签名文件，涉及 4 个关键概念及 2 个操作环节：

（1）关键概念辨析

文件类型 格式 作用
密钥库文件 .p12 存储非对称加密的公钥 + 私钥，用于数字签名 / 验证
证书请求文件 .csr 包含公钥、组织信息等，用于向 AGC 申请数字证书
数字证书 .cer 由 AGC 颁发，证明应用合法性
Profile 文件 .p7b 包含应用包名、证书权限、调试设备列表（Release 类型为空），每个应用必含

（2）生成密钥和证书请求文件（DevEco Studio 操作）

  1. 菜单栏点击Build > Generate Key and CSR【构建 > 生成密钥和CSR】（本地有密钥可点击 “Skip” 跳过密钥生成）；
  2. 密钥库配置：选择已有.p12 文件或 “New” 创建，需设置存储路径、密码（8 位以上，含 2 种 + 字符：大小写 / 数字 / 特殊符号）；
  3. 密钥信息填写：设置 “Alias（密钥别名）”，密钥密码与密钥库密码一致；
  4. 配置 CSR 文件存储路径和名称，点击 “OK” 生成.p12（密钥库）和.csr（证书请求）。

（3）申请发布证书和 Profile 文件（AGC 操作）

  1. 先在 AGC 项目中创建 HarmonyOS 应用 / 元服务（申请元服务需勾选 “是否元服务 = 是”）；
  2. 参考 AGC 文档《申请发布证书》和《申请发布 Profile》，上传.csr 文件完成申请，下载生成的.cer（证书）和.p7b（Profile）；
  3. 注意：发布签名仅用于打包上架，不可用于调试工程。

2. 配置签名信息

在File > Project Structure > Project > Signing Configs > default【文件 > 项目结构 > 项目 > 签名配置 > 默认】 中操作：

  1. 取消 “Automatically generate signature” 勾选；
  2. 逐项配置：
    • Store File：选择生成的.p12 密钥库文件；
    • Store Password/Key Password：输入对应的密钥库 / 密钥密码；
    • Key Alias：输入之前设置的密钥别名；
    • Sign Alg：固定为 “SHA256withECDSA”；
    • Profile File：选择 AGC 下载的.p7b 文件；
    • Certpath File：选择 AGC 下载的.cer 文件；
  3. 点击 “OK” 保存，后续用于构建带签名的应用包。

3. 更新公钥指纹

若应用使用以下华为开放能力，需在 AGC 中将 “调试指纹” 更新为 “发布证书指纹”（参考《配置公钥指纹》）：

  • Account Kit（华为账号服务）、Game Service Kit（游戏服务）
  • Health Service Kit（运动健康服务）、IAP Kit（应用内支付）
  • Map Kit（地图服务）、Payment Kit（华为支付）、Wallet Kit（钱包服务）

4. 编译构建.app 文件（Release 类型）

上架要求应用包为Release 类型，操作步骤：

  1. 删除工程目录中无需打包的 HAP/HSP 模块；
  2. 菜单栏点击Build > Build Hap(s)/APP(s) > Build APP(s)【构建> 构建Hap(s)/APP(s) > 构建 APP(s)】；
  3. 编译完成后，在工程目录 build > outputs > default 【构建 > 输出 > 默认 】中获取带签名的.app 文件。

5. 上传软件包（DevEco Studio/AGC）

（1）约束与限制

  • 仅支持中国境内（不含港、澳、台）；
  • 仅 Release 模式且已配置 Release 签名的包可上传；
  • 禁止上传敏感信息（密码、源代码、私钥、调试包、日志等）；
  • 也可直接通过《App Gallery Connect 上传软件包》操作。

（2）DevEco Studio 上传步骤

  1. 菜单栏点击Build > Upload Product【构建 > 上传产品】，登录华为开发者账号；
  2. 确认工程 product 信息，选择上传用途：
    • 仅测试：选 “Generate app package and upload it to AppGallery Connect for test”；
    • 正式发布：选 “Generate app package and upload it to AppGallery Connect for test and publish”；
    • （可选）勾选 “Upload your app’s symbols” 上传符号表；
  3. 上传完成后，可点击 “View Full result in AppGallery Connect” 查看上传记录和检测结果。

6. 发布到应用市场

将构建好的.app 文件上架，参考 AGC 文档：

  • 应用发布：《发布 HarmonyOS 应用》
  • 元服务发布：《发布元服务》

【应用构建——发布】

【AGC概述】

【签名配置】

在你编译器左上角那一栏选构建 - 编译Hap(s)/APP(s) - 选择编译APP(s)。

编译构建完成后，可以在工程目录build -> outputs -> default下，获取带签名的应用包。

应用打包到上架

https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-publish-app#section1992513343374

1、选择构建：

cke_248.png

2、编译

cke_1024.png

3、编译APP

在DevEco Studio中打包应用，需进入菜单栏选择Build > Build Haps(s)/APP(s) > Build HAP(s)。构建完成后，HAP文件默认生成在工程目录下的build > outputs > hap目录中。若需发布应用市场，可通过Build > Build APP(s)生成签名的APP文件。整个过程依赖项目配置的签名信息，需提前在Project Structure中完成签名配置。

在DevEco Studio中打包应用，请按以下步骤操作：

  1. 确保项目配置正确：

    • 检查build-profile.json5中的signingConfigs签名配置
    • 确认应用基本信息配置完整

  2. 选择构建方式：

    • 顶部菜单选择 Build > Build HAP(s)/APP(s)
    • 根据需要选择构建Debug或Release版本

  3. 输出位置：

    • 构建完成后，HAP包默认生成在build/outputs目录下
    • 完整APP包会生成在build/outputs/app目录

  4. 如果界面选项与文档不符：

    • 建议检查DevEco Studio版本是否最新
    • 可尝试通过File > Project Structure进行应用配置
    • 或直接在终端运行hvigorw assembleHap命令构建

构建前请确保已完成签名配置，否则可能无法正常打包。

回到顶部