【入门到实战】OpenHarmony南向子系统开发：预置应用配置与安装指南

往期鸿蒙5.0全套实战文章必看：（文中附带全栈鸿蒙5.0学习资料）

• 鸿蒙开发核心知识点，看这篇文章就够了

• 最新版！鸿蒙HarmonyOS Next应用开发实战学习路线

• 鸿蒙HarmonyOS NEXT开发技术最全学习路线指南

• 鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）

---

预置应用配置与安装

预置应用是指随设备出厂预置的应用。OpenHarmony支持在不同设备上对预置应用进行差异化配置，设备厂商可根据需要对与预置应用进行配置。

将应用配置为预置应用

1. 在进行预置应用配置前，使用如下命令查询系统支持的预置目录。

   命令查询结果如system、chipset、sys_prod、chip_prod等，并且返回的顺序越靠后优先级越高，如chip_prod的优先级高于system的优先级。本文以路径/system/etc/app/为例。

hdc shell param get const.cust.config_dir_layer

1. 在install_list.json中配置hap在设备上的路径。

hdc shell mount -o rw,remount /
hdc file recv /system/etc/app/install_list.json .

1. 按照json中的配置方式，配置对应的字段。

{
    "install_list" : [
        {
            "app_dir":"system/app/xxxx/yyyy",  // 设备上的hap路径，如果不存在，需要手动创建，并推送hap到此目录。
            "removable":true // 是否支持卸载，false表示不可卸载，true表示可以卸载。
        }
    ]
}

1. 修改完成后，将install_list.json文件推送到设备上，并重启设备生效。

    hdc shell mount -o rw,remount /
    hdc file send install_list.json /system/etc/app/install_list.json
    hdc shell reboot

更新预置应用

预置应用更新后，使用如下方法重新安装。

• 方法一：直接清空data，重启设备，应用会自动安装。

    hdc shell mount -o rw,remount / 
    hdc shell rm /data/* -rf
    hdc shell sync
    hdc shell /system/bin/udevadm trigger
    hdc shell reboot

• 方法二：执行如下命令，重启设备，应用即可安装。

  如果应用之前已经安装过，这时推送新的hap到/system/app/路径下，需保证应用的版本号（Stage模型下对应app.json5配置文件中的versionCode标签；FA模型下对应配置文件中的code标签）大于之前的版本号。

    hdc shell mount -o rw,remount /
    hdc shell param set persist.bms.test-upgrade true
    hdc shell reboot

预置不安装列表配置

uninstall_list.json的配置优先级高于install_list.json,在该文件中配置后，则对应的预置应用不会安装。

示例一

/system/etc/app/uninstall_list.json
{
    "uninstall_list" : ["/system/app/Hiworld"],  // 配置后，则Hiworld不会被安装
    "recover_list" : []
}

示例二

/system/etc/app/uninstall_list.json
{
    "uninstall_list" : ["/system/app/Hiworld"],
    "recover_list" : []
}

/chipset/etc/app/uninstall_list.json
{
    "uninstall_list" : [],
    "recover_list" : ["/system/app/Hiworld"] // 配置后，则Hiworld被恢复安装
}