HarmonyOS4.0从零开始的开发教程19HarmonyOS应用/元服务上架

HarmonyOS（十七）HarmonyOS应用/元服务上架

当您开发、调试完HarmonyOS应用/元服务，就可以前往AppGallery Connect申请上架，华为审核通过后，用户即可在华为应用市场获取您的HarmonyOS应用/元服务。

HarmonyOS会通过数字证书与Profile文件等签名信息来保证应用的完整性，需要上架的HarmonyOS应用/元服务都必须通过签名校验，所以上架前，您需要先完成签名操作。

在项目列表中点击需要操作的项目。
点击“添加应用”创建应用/元服务。
- 项目中没有应用，在“项目设置”页面点击“添加应用”。
- 项目中有应用，展开顶部应用列表框，点击“添加应用”。
填写相关信息，点击“确认”。
- 选择平台：选择“APP（HarmonyOS）”。
- 应用包名：需要和app.json5文件（Stage模型）或config.json文件（FA模型）中的“bundleName”值保持一致。
- “是否元服务”：HarmonyOS应用选择“否”，元服务选择“是”。

完整编译流程如下图所示。

打开DevEco Studio，菜单选择“Build > Generate Key and CSR”。
Key Store File可以点击“Choose Existing”选择已有的密钥库文件（存储有密钥的.p12文件），跳转至步骤4继续配置；如果没有密钥库文件，点击“New”，跳转至步骤3进行创建。
在“Create Key Store”界面，填写密钥库信息后，点击“OK”。
- Key Store File：设置密钥库文件存储路径，并填写p12文件名。
- Password：设置密钥库密码，必须由大写字母、小写字母、数字和特殊符号中的两种以上字符的组合，长度至少为8位。请记住该密码，后续签名配置需要使用。
- Confirm Password：再次输入密钥库密码。
在“Generate Key and CSR”界面继续填写密钥信息后，点击“Next”。
- Alias：密钥的别名信息，用于标识密钥名称。请记住该别名，后续签名配置需要使用。
- Password：密钥对应的密码，与密钥库密码保持一致，无需手动输入。
- Validity：证书有效期，建议设置为25年及以上，覆盖元服务的完整生命周期。
- Certificate：输入证书基本信息，如组织、城市或地区、国家码等。
在“Generate Key and CSR”界面设置CSR文件存储路径和CSR文件名，点击“Finish”。

CSR文件创建成功后，将在存储路径下获取生成密钥库文件（.p12）和证书请求文件（.csr）。

登录AppGallery Connect，选择“用户与访问”。
左侧导航栏选择“证书管理”，进入“证书管理”页面，点击“新增证书”。
在弹出“新增证书”界面填写相关信息后，点击“提交”。

参数说明
证书名称不超过100个字符。
证书类型选择“发布证书”。
上传证书请求文件（CSR）上传生成密钥和证书请求文件时获取的.csr文件。
证书申请成功后，“证书管理”页面展示生成的证书内容。
- 点击“下载”将生成的证书保存至本地。
- 每个帐号最多申请1个发布证书，如果证书已过期或者无需使用，点击“废除”即可删除证书。

登录AppGallery Connect，选择“我的项目”。
找到对应项目，点击项目卡片中需要发布的元服务。
导航选择“HarmonyOS应用 > HAP Provision Profile管理”，进入“管理HAP Provision Profile”页面，点击“添加”。

在“HarmonyAppProvision信息”界面填写相关信息，点击“提交”。

参数	说明
名称	不超过100个字符。
类型	选择“发布”。
选择证书	选择申请的发布证书。
申请受限权限	若软件包因特殊场景要求使用受限权限，如读取、添加、移除或更改联系人数据等，务必在此处进行申请，否则元服务将在审核时被驳回。

打开DevEco Studio，菜单选择“Build > Build Hap(s)/APP(s) > Build APP(s)”。
等待编译构建签名的HarmonyOS应用/元服务，编译完成后，可获取用于上架的软件包。
- API 9以前的应用/元服务软件包获取路径：工程目录build > outputs > app > release目录
- API 9应用/元服务软件包获取路径：工程目录build > outputs > default目录