发布应用
====

HarmonyOS通过数字证书与Profile文件等签名信息来保证应用/元服务的完整性，应用/元服务上架到AppGallery Connect（AGC）必须通过签名校验。因此，您需要使用发布证书和Profile文件对应用/元服务进行签名后才能发布。

26.0.0 Beta1以下的版本，开发者需要准备签名所需的密钥、证书请求文件、发布证书、Profile文件等，对应用进行手动签名和编译构建后，将软件包上传到AGC。

从26.0.0 Beta1版本开始，开发者只需将应用进行编译构建后上传到AGC。在上传的过程中，无论应用之前是否已签名，DevEco Studio都会对应用重新进行签名，支持使用AGC自动生成的[云管理证书](https://developer.huawei.com/consumer/cn/doc/app/agc-help-cloud-cert-0000002572233173)，也支持使用开发者创建的证书。

#### 26.0.0 Beta1及以上版本

#### \[h2\]编译构建.app文件

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/dc/v3/MrujyPSyTLaKGnoXNXJXvQ/notice_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=318451FBB6751E523150EECC237715D04B99D7B28BD9C478DF148992F3B30ED8)

应用上架时，要求应用包类型为Release类型。

1.  单击**Build > Build Hap(s)/APP(s) > Build APP(s)**，等待编译构建生成应用包。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/6d/v3/Imm87w88T0CU-IRYWfxBMA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=E5FB0A563F426BCD963985AA948D2B4F6B8401FC6C8A7B878BF9A72C72F45A36)
    
    构建模式是<Default>时，构建APP包，默认Release模式；构建HAP/HSP/HAR包，默认Debug模式。更多说明请参考[构建模式](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-hvigor-compilation-options-customizing-guide#section192461528194916)。
    
2.  编译构建完成后，可以在工程目录**build > outputs > {product}**下，获取应用包。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/1/v3/sNJqfmCqTSeVGV1B0oEV-w/zh-cn_image_0000002625074771.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=737DA5DF7EECB47A21606E0F41698FBF7FC4A3A0DE0BEA01C65DAFDA8129D414)
    

#### \[h2\]上传软件包

**约束与限制**

*   该功能仅支持中国境内（香港特别行政区、澳门特别行政区、中国台湾除外）。
*   该功能将会把您的应用包传至AppGallery Connect用于测试或上架。为了您的信息安全，请勿上传带有个人敏感信息的数据（如密码、源代码、私钥、调试安装包、业务日志等信息）。
*   仅支持上传工程build/outputs目录下的软件包，上传前请确保工程已构建App包。

**操作步骤**

1.  在DevEco Studio菜单栏，点击**Build > Upload Product。**若未登录，请点击**Sign in**登录华为开发者账号。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ed/v3/qTQB6zriRTaIc7WWP9NNjA/zh-cn_image_0000002624994623.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=AC4295FFA514E0B3CE11ADBD706403ADA4F4A4C4D0842C79061534C30F00D7FA)
    
2.  登录成功后，返回DevEco Studio进入软件包上传界面，确认用户名称和团队信息，在当前工程已构建的App包列表中选择需要上传的软件包，点击**Distribute App**开始上传。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c5/v3/T3hwCTZZQoGALTgqJwOU8A/zh-cn_image_0000002624994631.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=EA45B3D80EF9416DCA15A7F723B0962881DF8346F3FC9CC590A15B407C5960CD)
    
3.  选择所需的上传类型，上传类型包含AppGallery Connect、Testing Only、Custom三种，然后点击**Next**。
    
    *   **AppGallery Connect**：使用云管理证书和Profile，对应用重新签名；将软件包上传到AGC用于测试和发布，同时上传符号表信息。
    *   **Testing Only**：使用云管理证书和Profile，对应用重新签名；将软件包上传到AGC用于测试，同时上传符号表信息。
    *   **Custom**：自定义上传配置。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f0/v3/d0ZNGEOLRoW7LP4TnYvwiQ/zh-cn_image_0000002594475262.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=A9CBACB6B0E46E402F19EB42DF07CC22DCD106394A8AA5CB02CFF8248AF2C20C)
    
4.  检查应用是否[在AGC注册或关联创建待发布的应用](https://developer.huawei.com/consumer/cn/doc/app/agc-help-create-app-0000002247955506#section16423184171915)，未注册或未关联待发布的应用可在DevEco Studio中创建或关联。
    
    *   应用未在AGC注册，在窗口中配置应用名称、应用包名等信息，创建应用和发布应用，点击**Next**。
        
        *   **Project**：项目名称，可创建新项目或选择团队已有项目。
        *   **App type**：应用类型，从软件包中获取。
        *   **App name**：应用名称。
        *   **App package name**：应用包名，从软件包中获取。
        *   **App category**：应用分类。
        *   **Device Type**：设备类型。
        *   **Language**：默认语言。
        
        各选项更多说明请参考[为HarmonyOS应用创建APP ID](https://developer.huawei.com/consumer/cn/doc/app/agc-help-create-app-0000002247955506#section16423184171915)。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/31/v3/is0CqaK6RuCc-XvIJOatww/zh-cn_image_0000002594635186.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=75BE3779D0DF5D46F25A4CB630E64B1366BC35DE4FA776A3440D57C91A7B9BAF)
        
    *   应用在AGC已注册但未关联创建待发布的应用，在窗口中配置**App name**（应用名称）、**App package name**（应用包名）、**Device Type**（设备类型）、**Language**（默认语言），点击**Next**，会同步在AGC上关联创建待发布的应用。
        
        各选项更多说明请参考[为APP ID关联创建待发布的HarmonyOS应用](https://developer.huawei.com/consumer/cn/doc/app/agc-help-create-app-0000002247955506#section1502161513011)。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3b/v3/ctIHjLf0Qom6g9QEmBdmsg/zh-cn_image_0000002594635188.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=6E974C3B39F9695F554D96DBF6B9CDA63F4D3611D0919DD44D280C504A5E5AE2)
        
    *   应用已在AGC注册并且已关联创建待发布的应用，选择**AppGallery Connect**或**Testing Only**的上传类型，会跳转至[步骤8](#li1944219257111)查看软件包上传结果；选择**Custom**上传类型，进入下一步配置软件包的使用场景。
    
5.  选择Custom上传类型，点击**Next**，进入签名配置界面。使用场景如下：
    
    *   **Upload to AppGallery Connect for test and publish**：上传的软件包用于测试和发布。
    *   **Upload to AppGallery Connect for test**：上传的软件包用于测试。
    *   **Upload Symbol table**：上传符号表。
    *   **Manage Build Version**：自动管理构建版本，Build Version值由AGC计算后更新。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b9/v3/qlD_IbEGROqlMQWqfSNBfw/zh-cn_image_0000002625074769.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=559BC8981C86255773CD05056A0B614C95A3230AA938CE8CE5A5E2AD969847C4)
    
6.  选择签名管理方式。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/14/v3/lTmdAhAzS66CLResassxmg/zh-cn_image_0000002625074767.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=44363A17E62A008816051ABEAAA4B160BD5C74EE6A16A5B5F8068240DD94040D)
    
    *   **Automatically manage signing**：自动管理签名，使用云管理证书和Profile，对应用重新签名。
    *   **Manually manage signing**：手动管理签名，开发者自行配置签名信息。
    
    手动管理签名时，在Distribution Certificate选择**Create Certificate**（创建证书）或**Import Certificate**（导入证书），在Distribution Profile选择**Import Profile**（导入Profile）和**Download Profile**（下载Profile）。
    
    *   **创建或导入证书**
        
        创建证书时，操作界面如下，各选项含义和填写要求请参考[生成密钥和证书请求文件](#section1079214271414)。创建完成后，在AGC申请[发布Profile](https://developer.huawei.com/consumer/cn/doc/app/agc-help-release-profile-0000002248341090)。
        
        导入证书时，则需要导入本地已有的密钥库文件（.p12的密钥库文件）和证书（.cer文件）。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/eb/v3/iGZzws-nRKKQezo_WJ87GA/zh-cn_image_0000002625074775.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=4543F314AF99468DCFB0A5A0BC77E612B7F62CE6ED5DA51D002678A7CF952023)
        
    *   **导入或下载Profile**
        
        导入Profile，在本地选择与证书匹配的.p7b文件，或在AGC下载Profile后导入。
        
        下载Profile，开发者可以选择.p7b文件，选择后会从AGC下载到本地。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2c/v3/tY8865VWSvOmTBtx0wH0lQ/zh-cn_image_0000002625074773.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=CDD83552DC0AA57ACD43C95CE68AC189DC4579E11BBA0BED1BDF41878044418B)
        
    
7.  签名成功后，在选择的软件包路径下会生成"re-signed.app"为后缀的软件包，检查软件包信息，点击**Upload**上传软件包。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a7/v3/ucU4XjIER62t49n4ed4CDQ/zh-cn_image_0000002624994627.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=7E42654C9B426E75490FC12FF5FB55C7FEA24662EDD1CF6C76F25A392E2A2260)
    
8.  上传软件包成功后，点击**AppGallery Connect**可进入AGC查看软件包上传记录和检测结果，具体请参考[上传软件包](https://developer.huawei.com/consumer/cn/doc/app/agc-help-release-app-upload-pkg-0000002277983368)。点击**OK**，关闭上传页面。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/fb/v3/xR2ild2FR-6d0DAWCu8wwQ/zh-cn_image_0000002625074765.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=99CF85AA77F4265DC19305500674341E5F96296FA1AE66E143DCD671E11775B9)
    

#### \[h2\]发布.app文件到应用市场

将HarmonyOS应用/元服务打包成.app文件后上架到应用市场，发布详细操作指导请参考[发布HarmonyOS应用](https://developer.huawei.com/consumer/cn/doc/app/agc-help-release-app-0000002271695230)或[发布元服务](https://developer.huawei.com/consumer/cn/doc/app/agc-help-release-atomic-0000002327731065)。

#### 26.0.0 Beta1以下版本

#### \[h2\]发布流程

开发者完成HarmonyOS应用/元服务开发后，需要将应用/元服务打包成App Pack（.app文件），用于上架到AppGallery Connect。发布应用/元服务的流程如下图所示：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/5a/v3/qvBlpKMYQKGzHjEV6EHA5Q/zh-cn_image_0000002624994629.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=4B42E0D7F6A461885955BEE40EE30C997F44B6CEA4930C8CFD3C34364D787769)

#### \[h2\]生成密钥和证书请求文件

HarmonyOS应用/元服务通过数字证书（.cer文件）和Profile文件（.p7b文件）来保证应用/元服务的完整性。在申请数字证书和Profile文件前，需要提前生成密钥（存储在格式为.p12的密钥库文件中）和证书请求文件（.csr文件）。

**基本概念**

*   **密钥**：包含非对称加密中使用的公钥和私钥，存储在密钥库文件中，格式为.p12，公钥和私钥对用于数字签名和验证。
*   **证书请求文件**：格式为.csr，全称为Certificate Signing Request，包含密钥对中的公钥和公共名称、组织名称、组织单位等信息，用于向AppGallery Connect申请数字证书。
*   **数字证书**：格式为.cer，由AppGallery Connect颁发。
*   **Profile文件**：格式为.p7b，包含HarmonyOS应用/元服务的包名、数字证书信息、描述应用/元服务允许申请的证书权限列表，以及允许应用/元服务调试的设备列表（如果应用/元服务类型为Release类型，则设备列表为空）等内容，每个应用/元服务包中均必须包含一个Profile文件。

当前支持通过DevEco Studio和[CertificateTool](#section72897415171)两种方式生成密钥和证书请求文件。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3c/v3/Rm2LrOi8T_us11GJVWz6ug/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=0E7D0D0D527D5758956DC76F77DAA1055DE6959E85F6F066C5BE8AFDB36A8430)

CertificateTool生成密钥和证书请求文件的操作界面与DevEco Studio 6.1.0 Beta2及以上版本一致，文档以DevEco Studio进行说明。

使用CertificateTool生成时，操作界面中各选项的含义和填写要求请参考DevEco Studio 6.1.0 Beta2及以上版本。

**DevEco Studio 6.1.0 Beta2及以上版本**

1.  在主菜单栏单击**Build > Generate Key** **and CSR**。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e5/v3/LeXmZj42TLyG-x1ag8Mk8Q/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=EC517393B06303FD4E96EB566C29242EC13A09DA403304298137207911E19F58)
    
    如果本地已有对应的密钥，无需新生成密钥，可以在**Generate Key**界面中单击下方的Skip跳过密钥生成过程，直接使用已有密钥生成证书请求文件。
    
2.  填写密钥库文件，若已有的密钥库文件（存储有密钥的.p12文件），单击**Select an existing key**进行选择。下面以新创建密钥库文件为例进行说明。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/94/v3/TVyXYdbEQKeXmpWTBh7PXQ/zh-cn_image_0000002594635174.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=44BC260ACC70A16B7FD7EEDF68D487C7D4EC4D792AB37042E70593B71ECD55C1)
    
3.  在**Generate Key**窗口，填写密钥库信息后，点击**Next**。
    
    *   **Keystore Name**：填写p12文件名称，仅允许包含字母、数字、下划线（\_）、中划线（-）、句点（．）。
    *   **Select file save path**：设置密钥库文件存储路径。
    *   **Key store Password**：设置密钥库密码，必须由大写字母、小写字母、数字和特殊符号中的两种以上字符的组合，长度至少为8位。请记住该密码，后续签名配置需要使用。
    *   **Confirm password**：再次输入密钥库密码。
    *   **Alias**：密钥别名。请记住该别名，后续签名配置需要使用。
    *   **Advance Setting**：密钥库文件的高级设置，选填。
        
        *   **Validity(years)：**选填，证书有效期，建议设置为25年及以上，覆盖应用/元服务的完整生命周期。
        *   **First and last name：**选填，通用名称，可填写应用名称或开发者姓名等。
        *   **Organizational unit**：选填，组织单位，可填写部门名称或个人开发等。
        *   **Organization：**选填，组织名称，可填写公司全称或开发者姓名等。
        *   **City or locality：**选填，城市或地区。
        *   **State or province：**选填，州或省。
        *   **Country code(XX)：**选填，[国家码](https://developer.huawei.com/consumer/cn/doc/app/agc-help-connect-api-appendix-countrycode-0000002236201362)。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/58/v3/ejOpCZsbQwShvbWESh66Eg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=88BE4CC3034C8EF3696B1A6E93898B6A944187847A87AE83C6B446998F4A302C)
        
        First and last name、Organizational unit、Organization、City or locality、State or province填写要求小于64个字符，不可使用双引号（"）、单引号（\`）、斜杠（\\）。
        
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/cf/v3/RXclZs9ZRbSE4hHiwpj5VA/zh-cn_image_0000002594635178.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=C769F3CD38C3DD9CE5E8562E68B89D66EB54B1204660E72D9F34A6F1E7E05FCE)
    
4.  在**Generate** **Certificate Request File (CSR)**窗口，设置CSR文件名和CSR文件存储路径后，点击**Finish**。
    
    *   **CSR File Name**：填写CSR文件名称，仅允许包含字母、数字、下划线（\_）、中划线（-）、句点（．）。
    *   **Select file save path**：设置CSR文件存储路径。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/45/v3/rbbe62d5Rd2LSYrQN3PRzg/zh-cn_image_0000002624994615.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=04EFBE27893AC7A71B39C1A2035C957D3497D859349344435D230122334AAA37)
    
5.  创建CSR文件成功，可以在存储路径下获取生成的密钥库文件（.p12）、证书请求文件（.csr）。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/28/v3/qXTBiYtGQjOAq8MRzhk6QQ/zh-cn_image_0000002594475248.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=FCE8700F120D355AD488B1587B01318CF67D2A88AFAD69E305CEFEFE5EC7D66A)
    

**DevEco Studio 6.1.0 Beta2以下版本**

1.  在主菜单栏单击**Build > Generate Key** **and CSR**。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/78/v3/27utSoSETHK_wHIAO4FQ2w/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=39069FCA5AFFC44F8E4EF77007392DFBB5B60CFC95B1EE8C02A97E3A0087A38D)
    
    如果本地已有对应的密钥，无需新生成密钥，可以在**Generate Key**界面中单击下方的Skip跳过密钥生成过程，直接使用已有密钥生成证书请求文件。
    
2.  在**Key Store File**中，可以单击**Choose Existing**选择已有的密钥库文件（存储有密钥的.p12文件）；如果没有密钥库文件，单击**New**进行创建。下面以新创建密钥库文件为例进行说明。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2d/v3/bMdp_XQ3Tbup-T9JNbu1gQ/zh-cn_image_0000002594635180.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=0E06991D395D924F2A69240CB3910DCDB93E105270C081B1352E4736EB9E7A5B "点击放大")
    
3.  在**Create Key Store**窗口中，填写密钥库信息后，单击**OK**。
    
    *   **Key Store File**：设置密钥库文件存储路径，并填写p12文件名。
    *   **Password**：设置密钥库密码，必须由大写字母、小写字母、数字和特殊符号中的两种以上字符的组合，长度至少为8位。请记住该密码，后续签名配置需要使用。
    *   **Confirm Password**：再次输入密钥库密码。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/93/v3/R_C52fhtSamATqNGnWlEgA/zh-cn_image_0000002594635166.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=F26113961B0A08631AA8A5965FF5422379A0617AFA6A15D7ED2727A3104DB66D "点击放大")
    
4.  在**Generate Key** **and CSR**界面中，继续填写密钥信息后，单击**Next**。
    
    *   **Alias**：必填，别名，用于标识密钥名称。请记住该别名，后续签名配置需要使用。
    *   **Password**：必填，密码，与密钥库密码保持一致，无需手动输入。
    
    *   **Validity(years)：**选填，证书有效期，建议设置为25年及以上，覆盖应用/元服务的完整生命周期。
    *   **First and last name：**选填，通用名称，可填写应用名称或开发者姓名等。字符长度为（0，64），且不可使用（双引号）"、（斜杠）\\、（反引号）\`。
    *   **Organizational unit**：选填，组织单位，可填写部门名称或个人开发等。字符长度为（0，64），且不可使用（双引号）"、（斜杠）\\、（反引号）\`。
    *   **Organization：**选填，组织名称，可填写公司全称或开发者姓名等。字符长度为（0，64），且不可使用（双引号）"、（斜杠）\\、（反引号）\`。
    *   **City or locality：**选填，城市或地区。字符长度为（0，64），且不可使用（双引号）"、（斜杠）\\、（反引号）\`。
    *   **State or province：**选填，州或省。字符长度为（0，64），且不可使用（双引号）"、（斜杠）\\、（反引号）\`。
    *   **Country code(XX)：**选填，[国家码](https://developer.huawei.com/consumer/cn/doc/app/agc-help-connect-api-appendix-countrycode-0000002236201362)。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/dc/v3/8Ld52JFHTGGGjOyk9VZOVw/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=BEE65E677F7B763E9711188F7349D7830F7CD0E062DC003BA67FC6CC4D85ED19)
    
    First and last name、Organizational unit、Organization、City or locality、State or province要求：字符长度为（0，64），且不可使用（双引号）"、（斜杠）\\、（反引号）\`。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/5e/v3/lk7tON70SvyyJO6-GjWDvQ/zh-cn_image_0000002594635168.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=EBFEA8435184418F793F305BD4947F6D7185F1F06ABE19D47F73D49DE7DA6772)
    
5.  在**Generate Key** **and CSR**界面，设置CSR文件存储路径和CSR文件名。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/80/v3/buSTdKTIS6mzfNtlXXyPNw/zh-cn_image_0000002624994617.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=73DAE355261172C39593AF2E88688EB5755E85863D93AD0F0F092FFC970E5F97 "点击放大")
    
6.  单击**OK**按钮，创建CSR文件成功，可以在存储路径下获取生成的密钥库文件（.p12）和证书请求文件（.csr）。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/7c/v3/T7L4QNbaS7uHM7p35gcg6Q/zh-cn_image_0000002624994609.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=D39A893F3BD47F1918C65619C294D6F661ED3C0F43C2AFC963925D98E7C4E622)
    

#### \[h2\]申请发布证书和发布Profile文件

1.  创建HarmonyOS应用/元服务。在AGC中创建一个HarmonyOS应用/元服务，用于申请发布证书和Profile文件，具体请参考[创建HarmonyOS应用](https://developer.huawei.com/consumer/cn/doc/app/agc-help-create-app-0000002247955506)和[创建元服务](https://developer.huawei.com/consumer/cn/doc/app/agc-help-create-atomic-service-0000002247795706)。
2.  申请发布证书和发布Profile文件。在AGC中申请、下载发布证书和Profile文件，具体请参考[申请发布证书](https://developer.huawei.com/consumer/cn/doc/app/agc-help-release-cert-0000002283336729)和[申请发布Profile](https://developer.huawei.com/consumer/cn/doc/app/agc-help-release-profile-0000002248341090)。
3.  申请完发布证书和发布Profile文件后，请在DevEco Studio中进行签名，具体请参考[配置签名信息](#section945904791115)。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c3/v3/Tc18WGcHQNi8v6Vee-NZXA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=9F2777C5D94933936D20F13E1B82847EB61D647625FFE1D3552770553D36C048)
    
    *   如果申请元服务的签名证书，在“创建应用”操作时，“是否元服务”选项请选择“**是**”。
    *   使用发布证书和发布Profile文件进行手动签名，只能用来打包应用上架，不能用来运行调试工程。
    

#### \[h2\]配置签名信息

使用制作的私钥（.p12）文件、在AppGallery Connect中申请的证书（.cer）文件和Profile（.p7b）文件，在DevEco Studio配置工程的签名信息，构建携带发布签名信息的APP。

在**File >** **Project Structure >** **Project > Signing Configs** **> default**界面中，取消勾选“Automatically generate signature”和“Associate with registered application”，分别配置密钥(.p12文件)、Profile(.p7b文件)和数字证书(.cer文件)的路径等信息。

*   **Store File**：选择密钥库文件，文件后缀为.p12。
*   **Store Password**：输入密钥库密码。
*   **Key Alias**：输入密钥的别名信息。
*   **Key Password**：输入密钥的密码。
*   **Sign Alg**：签名算法，固定为SHA256withECDSA。
*   **Profile File**：选择申请的发布Profile文件，文件后缀为.p7b。
*   **Certpath File**：选择申请的发布数字证书文件，文件后缀为.cer。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/cb/v3/eWi08XnAQ3e5vaRZ_DAF7g/zh-cn_image_0000002624994625.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=0A7708F596921ED30A8BC63375E03EE9C8F4F723EA76BB104A815298D342E0EE "点击放大")

设置完签名信息后，单击**OK**进行保存，然后使用DevEco Studio生成APP，请参考[编译构建.app文件](#section212415961214)。

#### \[h2\]编译构建.app文件

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/cf/v3/YTCkiN4-RyqzW23fB8I9WA/notice_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=A7C2D1A85559A57C586CCD0B2545A926BA204831195401A985A28A0D8DDB18D9)

应用上架时，要求应用包类型为Release类型。

1.  单击**Build > Build Hap(s)/APP(s) > Build APP(s)**，等待编译构建完成已签名的应用包。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ad/v3/ZjOFQhU2R9y-rHMyaZIBdg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=1C10347E2028EBE0EAFE92C2E694685EBF327B47A7168AF19A78DB6915E89646)
    
    当未指定[构建模式](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-hvigor-compilation-options-customizing-guide#section192461528194916)时，构建APP包，默认Release模式；构建HAP/HSP/HAR包，默认Debug模式。
    
    即**Build APP(s)**时，默认构建的APP包为Release类型，符合上架要求，开发者无需进行另外设置。
    
2.  编译构建完成后，可以在工程目录**build > outputs > default**下，获取带签名的应用包。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2/v3/D-aP6YMdQyaCflkmokTEPA/zh-cn_image_0000002625074741.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=3D4B7E6AFE756E3A77A6328599CF001C64CAA5BCAE26280D4213E95D50F288AD)
    

#### \[h2\]上传软件包

DevEco Studio 5.0.5.200版本开始，支持在DevEco Studio内上传应用软件包。上传软件包前，请先[创建应用](https://developer.huawei.com/consumer/cn/doc/app/agc-help-create-app-0000002247955506)。

**约束与限制**

*   该功能仅支持中国境内（香港特别行政区、澳门特别行政区、中国台湾除外）。
*   该功能将会把您的应用包传至AppGallery Connect用于测试或上架。为了您的信息安全，请勿上传带有个人敏感信息的数据（如密码、源代码、私钥、调试安装包、业务日志等信息）。
*   仅Build Mode为Release的应用支持上传软件包，且确保软件包已配置Release签名。
*   同时支持通过[AppGallery Connect上传软件包](https://developer.huawei.com/consumer/cn/doc/app/agc-help-release-app-upload-pkg-0000002277983368)。

**操作步骤**

1.  在DevEco Studio菜单栏，点击**Build > Upload Product。**若未登录，请点击**Sign in**登录华为开发者账号。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/bf/v3/Y8zfyKrGTNK_DvezA9D85A/zh-cn_image_0000002624994599.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=5D55131867964C0BB8220C9B3F37F08419F42D2965145262800C8003CFA87D7E "点击放大")
    
2.  登录成功后，返回DevEco Studio进入软件包上传界面。确认当前工程的product信息，选择需要上传的软件包类型，点击**OK**开始上传。
    
    *   若当前上传的软件包仅做测试发布，请选择**Generate app package and upload it to AppGallery Connect for test**。
    *   若软件包需要在全网正式发布，请选择**Generate app package and upload it to AppGallery Connect for test and publish**。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e6/v3/iKqDmHZVQHajfwl2woAXMA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=E4DB1A57380156156DF0379163631DFD23E9870377E69621D24A26B5CA0FA0AD)
    
    *   如需上传符号表信息，请勾选**Upload your app's symbols**选项。
    *   上传的product可以通过点击DevEco Studio编辑区域右上方![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/74/v3/Ytooz0YtTi2mXV3uQM0glQ/zh-cn_image_0000002594635176.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=08515CD340A0FF41F5AD44B651EBC176DA43D1281BBB690D7C7A44516CDCFDBF)图标进行查看及切换。
    *   可通过app.json5中bundleName/versionName字段修改当前product对应的包名/版本号信息。必须使用当前开发者账号下已在AppGallery注册且真实存在的包名。
    *   Build Version值由AGC计算后回传填入。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b4/v3/tLfCyFYKRdeZ1BFadKHrKg/zh-cn_image_0000002625074747.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=9E0798C11E36DCD91F36D6CC78A4C1EDF995EEDD772A7715864213F8C4E1D416)
    
3.  上传完成后，出现云测试的结果，点击**View Full result in AppGallery Connect**可进入AGC查看软件包上传记录和检测结果，具体请参考[上传软件包](https://developer.huawei.com/consumer/cn/doc/app/agc-help-release-app-upload-pkg-0000002277983368)。点击**Close**关闭上传页面。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/78/v3/ogm--mphSmWLAg2M-iInPg/zh-cn_image_0000002594475250.png?HW-CC-KV=V1&HW-CC-Date=20260612T073914Z&HW-CC-Expire=86400&HW-CC-Sign=F74CC2CEF59FF08706648A98728B3140DFA9B84EBA3C5DD7BAA40D9D48DE5DD1)
    

#### \[h2\]发布.app文件到应用市场

将HarmonyOS应用/元服务打包成.app文件后上架到应用市场，发布详细操作指导请参考[发布HarmonyOS应用](https://developer.huawei.com/consumer/cn/doc/app/agc-help-release-app-0000002271695230)或[发布元服务](https://developer.huawei.com/consumer/cn/doc/app/agc-help-release-atomic-0000002327731065)。

#### 附录

#### \[h2\]CertificateTool下载

| 
平台

 | 

包名

 | 

版本号

 | 

SHA256校验码

 | 

更新时间

 |
| :-- | :-- | :-- | :-- | :-- |
| 

Windows(64-bit)

 | 

[certificate-tool-windows-x64-1.0.0.1.zip](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_package_901_9/92/v3/aqVWHUspRTO9BJKZ-5NULQ/certificate-tool-windows-x64-1.0.0.1.zip?HW-CC-KV=V1&HW-CC-Date=20260420T021601Z&HW-CC-Expire=315360000&HW-CC-Sign=71B0174C33B7E64463BA3D3E0530998CF4FDEB56D80C6F177BAED3E8E7488750)

 | 

1.0.0.1

 | 

dee6c2ae3b300fd7450bbeb2aadd96f1099ee5235ae627afcfad9b3ed3ded7da

 | 

2026/04/20

 |
| 

Mac(64-bit)

 | 

[certificate-tool-mac-x64-1.0.0.1.zip](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_package_901_9/bc/v3/l9egptIHRIyxS4tM_SPzuQ/certificate-tool-mac-x64-1.0.0.1.zip?HW-CC-KV=V1&HW-CC-Date=20260420T021701Z&HW-CC-Expire=315360000&HW-CC-Sign=A3B7F4BA42F7790DDA25A916B3EEFDDA52C905DCCE85D362AF4A576F152FFC67)

 | 

1.0.0.1

 | 

8afc53e6714cb7e8840114065012b5f706c265c056491c240e5433be311bf084

 | 

2026/04/20

 |
| 

Mac(ARM64)

 | 

[certificate-tool-mac-arm64-1.0.0.1.zip](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_package_901_9/90/v3/TeaUV0NbSvSx15zqhZRY0Q/certificate-tool-mac-arm64-1.0.0.1.zip?HW-CC-KV=V1&HW-CC-Date=20260420T021801Z&HW-CC-Expire=315360000&HW-CC-Sign=604E5AA8AFCCE2FF2127308E0F94B0830DB8E52C24DFF0AA5E0118E55EAAA878)

 | 

1.0.0.1

 | 

07283684624b11c2db0c2ce2654729b5114b3085df68736a43967eda247a7b4e

 | 

2026/04/20

 |