鸿蒙ArsTS项目创建打包发布流程_鸿蒙打包教程

项目创建

1、选择项目类别。

2、创建项目信息。

注意：创建项目的包名，使用的是那个版本的api需要记住，测试手机需要相同的api版本才能够进行真机调测。

项目发布流程图。

基本概念：

密钥：包含非对称加密中使用的公钥和私钥，存储在密钥库文件中，格式为.p12，公钥和私钥对用于数字签名和验证。

证书请求文件：格式为.csr，全称为Certificate Signing Request，包含密钥对中的公钥和公共名称、组织名称、组织单位等信息，用于向AppGallery Connect申请数字证书。

数字证书：格式为.cer，由华为AppGallery Connect颁发。

Profile文件：格式为.p7b，包含HarmonyOS应用/服务的包名、数字证书信息、描述应用/服务允许申请的证书权限列表，以及允许应用/服务调试的设备列表（如果应用/服务类型为Release类型，则设备列表为空）等内容，每个应用/服务包中均必须包含一个Profile文件。

准备签名文件

1、在主菜单栏单击 构建(Build)>生成私钥和证书请求文件(Build>Generate Key and CSR)。

2、在Key Store File中，可以单击Choose Existing选择已有的密钥库文件（存储有密钥的.p12文件），如果没有密钥库文件，单击New进行创建。

3、填写密钥库信息。

注意：这里的p12文件存放地址是自己设置，直接选择到需要存放的文件夹，然后在地址栏填写文件名称如testproject。

创建成功后，继续填写信息。

Alias：密钥的别名信息，用于标识密钥名称。请记住该别名，后续签名配置需要使用。

Password：密钥对应的密码，与密钥库密码保持一致，无需手动输入。

Validity：证书有效期，建议设置为25年及以上，覆盖应用/服务的完整生命周期。

Certificate：输入证书基本信息，如组织、城市或地区、国家码等。

4、继续填写密钥信息。

5、选择CSR文件存放路径，创建。

6、使用命令行工具生成证书请求文件，找到DevEco Studio文件，进入找到jbr/bin目录。

7、在在终端打开。

执行命令生成公私钥文件，如生成的密钥文件时testproject.p12，存储到E盘根目录下，回车。

命令：keytool -genkeypair -alias "testproject_release" -keyalg EC -sigalg SHA256withECDSA -dname "C=CN,O=HUAWEI,OU=HUAWEI IDE,CN=testproject_release"  -keystore e:\\testproject.p12 -storetype pkcs12 -validity 9125 -storepass 123456Abc -keypass 123456Abc

参数：

alias：密钥的别名信息，用于标识密钥名称。

sigalg：签名算法，固定为SHA256withECDSA。

dname：按照操作界面提示进行输入。

C：国家/地区代码，如CN。

O：组织名称，如HUAWEI。

OU：组织单位名称，如HUAWEI IDE。

CN：名字与姓氏，建议与别名一致。

validity：证书有效期，建议设置为9125（25年）。

storepass：设置密钥库密码，必须由大写字母、小写字母、数字和特殊符号中的两种以上字符的组合，长度至少为8位。请记住该密码，后续签名配置需要使用。

keypass：设置密钥的密码，请与storepass保持一致。

8、生成证书请求文件，后缀格式为.csr，输入指令，回车，输入密码，回车。

命令：keytool -certreq -alias "testproject_release" -keystore e:\\testproject.p12 -storetype pkcs12 -file e:\\testproject.csr 

参数：

alias：与7中输入的alias保持一致。

file：生成的证书请求文件名称，后缀为.csr。

-keystore：在第七步生成的文件地址。

申请数字证书

1、登录AppGallery Connect，选择“用户与访问”。

2、在左侧导航栏点击“证书管理”，进入“证书管理”页面，点击“新增证书”。

3、在弹出的“新增证书”窗口填写要申请的证书信息，点击“提交”。

注意：这里要选择发布证书，因为已经生成过一个发布证书，不能重新生成，这里为了做演示，选择了调试证书。

4、证书申请成功后，“证书管理”页面展示证书名称等信息。点击“下载”，将生成的证书保存至本地，供后续签名使用。

申请发布Profile

1、登录AppGallery Connect，选择“我的项目”。

2、找到您的项目，点击您创建的HarmonyOS应用。

3、填写相关信息。

4、选择我的项目。

5、选择在我的应用中创建的项目。

6、填写包名（需要跟在开发工具创建的项目包名一致）。

注意：因为包名是唯一的，如果别人创建了相同的名称，会出现包名已存在提示。

7、创建好后，进入到此界面，选择HarmonyOS应用 > HAP Provision Profile管理。

8、点击新建，填写信息。

注意：证书是在证书管理新建（上操作已经新建好）。

9、将文件下载到本地。

配置签名信息

1. 打开DevEco Studio，菜单选择“文件(File) >项目结构(Project Structure)”，进入“Project Structure”界面。

2、导航选择“Project”，点击“Signing Configs”页签，取消“Automatically generate signature”勾选项，然后配置工程的签名信息，完成后点击“OK”。

参数：

Store file：密钥库文件，选择生成密钥和证书请求文件时生成的.p12文件。

Store password：密钥库密码，需要与生成密钥和证书请求文件时设置的密钥库密码保持一致。

Key alias：密钥的别名信息，需要与生成密钥和证书请求文件设置的别名保持一致。

Key password：密钥的密码，需要与生成密钥和证书请求文件时设置的密码保持一致。

Sign alg：固定设置为“SHA256withECDSA”。

Profile file：选择申请发布Profile时下载的.p7b文件。

Certpath file：选择申请发布证书时下载的.cer文件。

编译打包应用

1、打开DevEco Studio，菜单选择“构建 (Build）> Build Hap(s)/APP(s) > Build APP(s)”。

2、打包成功后，会得到两个app文件，使用带有签名的app文件。

如果报错，密码不对，包名不对等等，重新看文档，一步一步走下来，密码，包名都需要正确能打包成功。

发布应用

1. 登录AppGallery Connect，选择“我的应用”。
2. 在应用列表首页中选择“HarmonyOS”页签，点击待发布的HarmonyOS应用名称。

3、在左侧导航栏选择“应用信息”菜单。

在这里填写相关信息，填写完成后，点击下一步。

4、填写应用信息（发布国家地址，软件包，是否开放测试，付费情况，应用内资费，内容分级，隐私声明，版权信息（版权证书），备案信息，审核信息等）。

如果未上正式版本，请选择开放式测试版本。

5、软件包管理，上传打包好的app文件，如果解析错误，根据错误提示进行更改，多数是包名对应不上，证书弃用，或者是测试证书用于打包项目发布正式版本等。

其余按照信息填完，正常提交审核即可。