当前位置：GHOST系统之家>系统教程 > OpenHarmony自定义系统应用之实践介绍

OpenHarmony自定义系统应用之实践介绍

来源：Ghost系统之家浏览：时间：2023-06-28 09:01:21

想了解更多关于开源的内容，请访问：

51CTO开源基础软件社区

https://ost.51cto.com

前言

OpenHarmony系统应用是指预装在OpenHarmony操作系统中的应用程序，也称为系统应用。这些应用程序通常由操作系统开发者开发，包括系统设置、电话、短信、浏览器、相机、音乐、视频等常用应用程序。这些应用程序通常具有更高的权限和更深入的系统集成，可以访问更多的系统资源和功能。自定义系统应用是指用户自己开发或定制的OpenHarmony系统应用程序。用户可以根据自己的需求和喜好，开发或定制自己的系统应用程序，如主题、锁屏、桌面、通知栏等。这些应用程序通常具有更高的个性化和定制化，可以满足用户更多的需求和偏好。

本文从文件准备、生成签名包、系统集成几个方面，介绍如何在OpenHarmony系统上开发自定义的系统应用，供开发者学习参考。

1、文件准备

（1）未签名应用包

选模板

在DevEco Studio中选择自定义应用所需的模板。

OpenHarmony自定义系统应用之实践介绍-开源基础软件社区

然后选择自定义应用所需的应用模型、SDK。

OpenHarmony自定义系统应用之实践介绍-开源基础软件社区

最后按照模板引导创建ArkTS工程。

编译包

工程创建成功后，启动编译选项，生成未签名的hap包。

OpenHarmony自定义系统应用之实践介绍-开源基础软件社区

编译成功后，在工程目录\entry\build\default\outputs\default路径下，可见生成的未签名hap包。

OpenHarmony自定义系统应用之实践介绍-开源基础软件社区

（2）签名所需文件

为了保证OpenHarmony应用的完整性和来源可靠，在应用构建时需要对应用进行签名。经过签名的应用才能在真机设备上安装、运行、和调试。本文介绍的是使用签名工具以命令行方式进行Hap包签名的方法，签名所需文件如下：

签名密钥库文件：OpenHarmony.p12Profile签名证书：OpenHarmonyProfileRelease.pem、OpenHarmonyProfileDebug.pemProfile模板文件：UnsgnedReleasedProfileTemplate.json、UnsgnedDebugProfileTemplate.json签名工具：hap-sign-tool.jar

以上文件可在SDK中会获得。

OpenHarmony自定义系统应用之实践介绍-开源基础软件社区

签名工具工具详细说明。

2、生成签名应用包

（1）修改profile

app1-profile-release.json中会定义当前应用名称"bundle-name"、应用的权限等级"apl"。权限等级有normal、system_basic、system_core三种，默认等级为normal，对于系统应用的话，需要修改权限，此处改为system_core。应用名称改为用户自定义的包名即可，此处改为com.example.zjxapp。

{"version-name": "2.0.0","version-code": 2,"app-distribution-type": "os_integration","uuid": "5027b99e-5f9e-465d-9508-a9e0134ffe18","validity": {"not-before": 1594865258,"not-after": 1689473258},"type": "release","bundle-info": {"developer-id": "OpenHarmony","distribution-certificate": "-----BEGIN CERTIFICATE-----\nMIICFTCCAZmgAwIBAgIEFRGSbjAMBggqhkjOPQQDAwUAMGMxCzAJBgNVBAYTAkNO\nMRQwEgYDVQQKEwtPcGVuSGFybW9ueTEZMBcGA1UECxMQT3Blbkhhcm1vbnkgVGVh\nbTEjMCEGA1UEAxMaT3Blbkhhcm1vbnkgQXBwbGljYXRpb24gQ0EwHhcNMjIwNDAy\nMDY1OTA4WhcNMzIwMzMwMDY1OTA4WjBKMRUwEwYDVQQDDAxpZGVfZGVtb19hcHAx\nDTALBgNVBAsTBFVuaXQxFTATBgNVBAoTDE9yZ2FuaXphdGlvbjELMAkGA1UEBhMC\nQ04wWTATBgcqhkjOPQIBBggqhkjOPQMBBwNCAARGc9ftjM6ncln8AqF0AhTsyphc\nhmKWktwgsZwisqy7X+clViYnbw9WpRRoxJYeZ6GL3MUiOHiM9UDpwOmjdYPOo1Iw\nUDAdBgNVHQ4EFgQUG91q9tKNxBRQgQFzfuSnhrP/mKcwDgYDVR0PAQH/BAQDAgeA\nMB8GA1UdIwQYMBaAFNuGtyIW1QuhS7fdJXu58QV9oi1HMAwGCCqGSM49BAMDBQAD\naAAwZQIweNK78cfmJdBVSMowMukZoIevBFNRNVYaUxxWpbn+X2Y9x8STmxqHhPj6\np0wKd9qnAjEAuU/AuW9NO04joHCJnM0I2PkDWJKw+eJiVc3ggLAOJTE9TfXyN0JM\nUdjqqzpQQj4u\n-----END CERTIFICATE-----\n","bundle-name": "com.example.zjxapp","apl": "system_core","app-feature": "hos_system_app"},"acls": {"allowed-acls": [""]},"permissions": {"restricted-permissions": [ ]},"issuer": "pki_internal"}

（2）签名Profile

Profile签名流程如下图：

OpenHarmony自定义系统应用之实践介绍-开源基础软件社区

由图可见，根据sdk中的p12文件、2.1章节的profile文件，可以生成签名的Profile文件，文件格式为*.p7b;命令如下

java -jar hap-sign-tool.jarsign-profile -keyAlias "OpenHarmony Application Release" -signAlg "SHA256withECDSA" -mode "localSign" -profileCertFile "OpenHarmonyApplication.pem" -inFile "app1-profile-release.json" -keystoreFile "OpenHarmony.p12" -outFile "profile.p7b" -keyPwd "123456" -keystorePwd "123456"

（3）签名应用

应用签名流程如下图：

OpenHarmony自定义系统应用之实践介绍-开源基础软件社区

由图可见，根据1.1中未签名的应用包以及2.2签名的Profile文件，可以生成签名的应用，命令如下

java -jar hap-sign-tool.jar sign-app -keyAlias "OpenHarmony Application Release" -signAlg "SHA256withECDSA" -mode "localSign" -appCertFile "OpenHarmonyApplication.pem" -profileFile "profile.p7b" -inFile "entry-default-unsigned.hap" -keystoreFile "OpenHarmony.p12" -outFile "zjxapp.hap" -keyPwd "123456" -keystorePwd "123456"

注意:entry-default-unsigned.hap为你未签名的hap包，zjxapp.hap为签名后生成的包

3、系统集成

（1）增加hap包

将2.3生成的包拷贝到applications\standard\hap路径下

OpenHarmony自定义系统应用之实践介绍-开源基础软件社区

（2）修改gn文件

gn文件路径为：\applications\standard\hap\BUILD.gn，在文件中增加如下代码：

ohos_prebuilt_etc("zjxapp_hap") {source = "zjxapp.hap"module_install_dir = "app/com.ohos.zjxapp"part_name = "prebuilt_hap"subsystem_name = "applications"}

修改依赖项deps，增加zjxapp_hap：

group("hap") {deps = ["//applications/standard/hap:calc_demo_hap","//applications/standard/hap:zjxapp_hap",]