Windows x64

配置JAVA环境

安装jdk

https://www.oracle.com/java/technologies/downloads/

配置jdk

找到自己的jdk安装路径：

例如：C:\Program Files\Java\jdk1.8.0_131

打开我的电脑 > 属性 > 高级系统设置 > 环境变量，在用户变量中新增变量JAVA_HOME值为该jdk安装目录。

然后，在系统变量Path中新增该jdk路径：

%JAVA_HOME%\bin

启动cmd执行：

# 输入 
java -version

看到以下内容配置成功。

找到自己的jre安装路径：

例如：C:\Program Files\Java\jre1.8.0_131\bin

打开我的电脑 > 属性 > 高级系统设置 > 环境变量，在系统变量Path中新增该jre路径。

启动cmd执行：

# 输入 
keytool -list -v -keystore debug.keystore

看到以下内容配置成功。

安装DevEco Studio 3.0 Beta1

下载地址：https://developer.harmonyos.com/cn/develop/deveco-studio#download

当前最新版本DevEco Studio 3.0.0.601 x64

配置OpenHarmony SDK

官方文档地址：https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/configuring-openharmony-sdk.md

注：在工程的local.properties中可以查看当前工程使用的是Openharmony SDK还是HarmonyOS SDK

按照文档操作即可。

想要查看SDK本地路径及安装SDK，可在DevEco中File > Setting > SDK Manager中查看。

创建OpenHarmony工程

官方文档地址：https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/use-wizard-to-create-project.md

按照文档操作即可。

注：按文档选择 [Standard]Empty Ability模板创建的工程才会使用OpenHarmony SDK

创建APP

• Project Type选择：Application

• Compatible API Version推荐选择：SDK: API Version 7

• Language推荐选择：eTS

OpenHarmony应用签名

官方文档地址

生成密钥和证书请求文件参考文档：https://developer.harmonyos.com/cn/docs/documentation/doc-guides/publish_app-0000001053223745#section9752152162813

发布签名包参考文档：https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/configuring-openharmony-app-signature.md

注1：需要安装至3516板上的应用，不论是OpenHarmony应用还是HarmonyOS应用都需要签名。两种工程都可以采取以下方式进行签名。

注2：通过DevEco Studio来生成密钥文件（.p12文件）和证书请求文件（.csr文件）时，请按照文档在Generate Key界面中将所有密钥信息填写完整，否则可能导致签名失败。简单测试建议直接使用命令行生成。

注3：需要成功配置好JAVA环境。

注4：需要成功配置好OpenHarmony SDK。

签名准备

使用DevEco Studio生成密钥和证书请求文件

1. 在主菜单栏点击Build > Generate Key and CSR。

   如果本地已有对应的密钥，无需新生成密钥，可以在Generate Key界面中点击下方的Skip跳过密钥生成过程，直接使用已有密钥生成证书请求文件。

2. 在Key Store File中，可以点击Choose Existing选择已有的密钥库文件（存储有密钥的.p12文件）；如果没有密钥库文件，点击New进行创建。下面以新创建密钥库文件为例进行说明。

   

3. 在Create Key Store窗口中，填写密钥库信息后，点击OK。

   • Key Store File：选择密钥库文件存储路径。

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

   • Confirm Password：再次输入密钥库密码。

   

4. 在Generate Key界面中，继续填写密钥信息后，点击Next。

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

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

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

   • Certificate【必须填写完整】：输入证书基本信息，如组织、城市或地区、国家码等。

   

5. 在Generate CSR界面，选择密钥和设置CSR文件存储路径。

   

6. 点击OK按钮，创建CSR文件成功，可以在存储路径下获取生成的密钥库文件（.p12）和证书请求文件（.csr）。

命令行生成密钥文件（.p12文件）

keytool -genkeypair -alias "{{别名}}" -keyalg EC -sigalg SHA256withECDSA -dname "C=CN,O=HUAWEI,OU=HUAWEI IDE,CN={{别名}}" -keystore {{输出的.p12文件完整路径}} -storetype pkcs12 -validity 9125 -storepass {{设置密码}} -keypass {{设置密码}} ​ 

## 按要求替换{{XXXX}}即可 

########################### 例如 ################################# 

keytool -genkeypair -alias "myapplication" -keyalg EC -sigalg SHA256withECDSA -dname "C=CN,O=HUAWEI,OU=HUAWEI IDE,CN=myapplication" -keystore D:\myapplication.p12 -storetype pkcs12 -validity 9125 -storepass abc12345 -keypass abc12345

请记住配置的别名及密码。

密码设置要求：至少8位、至少包含数字与英文。

DevEco配置密码要求

The password must contain at least 8 characters and include any two of the following:

1. Lowercase letters: a-z

2. Uppercase letters : A-Z

3. Digits : 0-9

4. Special characters : "`~!@#$%^*()-_=+|[{}];:'",.>/? \

命令行生成证书请求文件（.csr文件）

keytool -certreq -alias "{{别名}}" -keystore {{.p12密钥文件完整路径}} -storetype pkcs12 -file {{输出的.csr文件完整路径}} ​ 

## 按要求替换{{XXXX}}即可 

########################### 例如 ################################# 

keytool -certreq -alias "myapplication" -keystore D:\myapplication.p12 -storetype pkcs12 -file D:\myapplication.csr

执行后会要求输入密码，输入生成密钥文件（.p12文件）相同的配置密码即可。

命令行生成应用证书文件（.cer文件）

以下步骤参考文档即可，HarmonyOS应用也可以使用该方式。

https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/configuring-openharmony-app-signature.md

1、首先进入OpenHarmony SDK安装目录。

一般默认安装在C:\Users\admin\AppData\Local\OpenHarmony\Sdk

然后进入toolchains\lib目录，在该目录下启动cmd命令行工具。

2、执行命令行

keytool -gencert -alias "OpenHarmony Application CA" -infile {{.csr文件完整路径}} -outfile {{输出的.cer文件完整路径}} -keystore OpenHarmony.p12 -sigalg SHA384withECDSA -storepass 123456 -ext KeyUsage:"critical=digitalSignature" -validity 3650 -rfc ​ 

## 按要求替换{{XXXX}}即可 

########################### 例如 ################################# 

keytool -gencert -alias "OpenHarmony Application CA" -infile D:\myapplication.csr -outfile D:\myapplication.cer -keystore OpenHarmony.p12 -sigalg SHA384withECDSA -storepass 123456 -ext KeyUsage:"critical=digitalSignature" -validity 3650 -rfc

命令行生成应用Profile文件（.p7b文件）

1、首先进入OpenHarmony SDK安装目录。

一般默认安装在C:\Users\admin\AppData\Local\OpenHarmony\Sdk

然后进入toolchains\lib目录，在该目录下启动cmd命令行工具。

2、执行命令行

java -jar provisionsigtool.jar sign --in UnsgnedReleasedProfileTemplate.json --out {{输出的.p7b文件完整路径}} --keystore OpenHarmony.p12 --storepass 123456 --alias "OpenHarmony Application Profile Release" --sigAlg SHA256withECDSA --cert OpenHarmonyProfileRelease.pem --validity 365 --developer-id ohosdeveloper --bundle-name {{当前应用包名}}  --distribution-certificate {{生成.cer文件完整路径}} ​ 

## 按要求替换{{XXXX}}即可 

## 注意应用包名一致，应用包名可在entry\src\config.json中查看bundleName 

########################### 例如 ################################# 

java -jar provisionsigtool.jar sign --in UnsgnedReleasedProfileTemplate.json --out D:\myapplication.p7b --keystore OpenHarmony.p12 --storepass 123456 --alias "OpenHarmony Application Profile Release" --sigAlg SHA256withECDSA --cert OpenHarmonyProfileRelease.pem --validity 365 --developer-id ohosdeveloper --bundle-name com.example.myapplication  --distribution-certificate D:\myapplication.cer

配置签名

参考文档：https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/configuring-openharmony-app-signature.md

按照文档操作即可。

打开 File > Project Structure，点击 Project > Signing Configs > debug窗口中，去除勾选“Automatically generate signing”，然后配置指定模块的调试签名信息。

生成签名包

最后执行Build > Build Hap(s)/APP(s) > Build Hap(s)，签名成功后，可以在entry\build\outputs\hap中看到签名包。

hdc_std安装应用

官方文档地址：https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/subsystems/subsys-toolchain-hdc-guide.md#%E6%B3%A8%E6%84%8F%E4%BA%8B%E9%A1%B9

配置hdc_std

在OpenHarmony SDK安装目录下找到hdc_std.exe所在目录。

一般默认在：C:\Users\admin\AppData\Local\OpenHarmony\Sdk\toolchains\

打开我的电脑 > 属性 > 高级系统设置 > 环境变量，然后，在系统变量Path中新增该路径。

启动cmd执行：

hdc_std -v

看到以下内容则配置成功

连接3516开发板

hdc_std list targets

看到设备码则设备连接成功

安装应用

找到.hap应用路径，执行：

hdc_std install [-r/-d/-g] 应用路径

# 注意：应用必须签名
# 例如：
hdc_std install D:\entry-debug-standard-ark-signed.hap

安装成功

hdc_std工作异常

可以执行"hdc kill"或者"hdc start -r"杀掉hdc服务或者重启hdc服务，然后再执行hdc list targets查看是否已经可以获取设备信息。