OpenHarmony Windows环境IDE打包ARK应用教程

1.下载并安装IDE, 当前版本3.0.0.600

https://developer.harmonyos.com/cn/develop/deveco-studio

直接解压安装。安装完成后，首次打开IDE，按照引导设置npm位置并下载SDK。

当前默认下载的是OpenHarmony SDK的API7。HarmonyOS Legacy SDK 对应API4-6，可以手动在HarmonyOS Legacy SDK页面选择下载或者打开工程的时候按照提示下载。

2.替换自己的SDK

自己本地编译镜像的情况下，我们需要使用与本地环境一致的SDK，这时候需要我们本地编出SDK，并替换到IDE的SDK路径下。

OHOS代码根目录下执行命令编出SDK：

./build.sh --product-name ohos-sdk

将out\ohos-arm64-release\ohos-sdk\windows\ets路径下的生成文件覆盖到本地SDK的SDK\ets\3.0.0.0路径下，

将out\ohos-arm64-release\ohos-sdk\windows\js路径下的生成文件覆盖到本地SDK的SDK\js\3.0.0.0路径下。

在本地SDK\js\3.0.0.0\build-tools\ace-loader和SDK\ets\3.0.0.0\build-tools\ets-loader路径下分别执行：

npm install

这样，SDK就替换成功了。

备注：每次替换SDK都需要执行npm install。

3.应用源码下载

以settings源码为例

git clone https://gitee.com/openharmony/applications_settings.git

4.打开工程

第一次打开某个工程，可能工程内容刷新不全，重新打开即可。

备注：蓝区环境中，不要直接用Windows IDE打开wsl系统中的工程。

5.修改工程配置

每个工程可能有多个子模块，工程有一个公共的配置文件build.gradle，每个子模块也分别有一个单独的配置文件build.gradle。

可以看到，supportSystem当前是在公共配置文件中设置的，不要在子模块的配置文件中添加。

备注：每次修改完配置文件后，都要重新进行工程同步。

6.应用打包

工程同步完成后，可以进行应用打包，选择Build Hap(s)。到这里，已经能打包出未签名的hap包，生成目录在每个子模块的"build\outputs\hap\debug"目录下，如果有多个子模块，每个子模块的对应目录下都会有一个hap。

备注：每次重新打包，要先执行Clean Project。

7.应用签名

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

b.在系统环境变量中配置JDK的环境变量（不需要自己安装JDK，只需要使用DevEco Studio 3.0.0.600下的JDK工具）

c.本地OpenHarmony SDK目录SDK\toolchains\lib下执行

keytool -gencert -alias "OpenHarmony Application CA" -infile D:\key\keys.csr -outfile IDE.cer -keystore OpenHarmony.p12 -sigalg SHA384withECDSA -storepass 123456 -ext KeyUsage:"critical=digitalSignature" -validity  3650 -rfcjava -jar provisionsigtool.jar sign --in UnsgnedReleasedProfileTemplate.json --out myApplication_ohos_Provision.p7b --keystore OpenHarmony.p12 --storepass 123456 --alias "OpenHarmony Application Profile Release" --sigAlg SHA256withECDSA --cert OpenHarmonyProfileRelease.pem --validity 365 --developer-id ohosdeveloper --bundle-name ohos.samples.jshelloworld  --distribution-certificate IDE.cer

其中，第一次命令的-infile为上面生成的本地.csr文件路径，第一条命令的-outfile文件对应第二条命令的–distribution-certificate文件。

d.* p12，.csr， .cer和 *.p7b这四个文件生成完之后，开始配置签名信息

以release版本为例，在File > Project Structure > Project > Signing Configs > Release窗口中，配置工程的签名信息。

配置之后点击apply，可以看到工程的配置文件中已经有了release版本的签名信息

用同样的方法可以配置debug版本的签名信息。到这里，就可以生成签名后的应用了。

IDE可以打包debug或release版本的应用，两个版本分别使用debug和release的签名配置。打包版本配置方法如下

备注：第一次通过IDE生成完签名信息后，以后都可以直接将上面的签名信息拷贝到build.gradle中，不需要再通过IDE生成。

8.确认Ark应用

生成的hap包可以通过修改后缀名为.zip打开，通过里面config.json文件判断是否是Ark应用，如果有virtualMachine字段，且其值包含ark字样，则为Ark应用。

当前IDE在ohos库版本配置为3.0.3.2之后，默认会编Ark应用，如果需要编quickjs应用，需要在每个子模块的配置文件中加入arkEnable字段。

rtualMachine字段，且其值包含ark字样，则为Ark应用。

当前IDE在ohos库版本配置为3.0.3.2之后，默认会编Ark应用，如果需要编quickjs应用，需要在每个子模块的配置文件中加入arkEnable字段。