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

懂你的大海

墨衍会员 · AI 创作全网分发码龄6年

关注

原创最新推荐文章于 2026-06-04 11:17:17 发布 609 阅读 AI 写同款· GEO 优化 ›

OpenHarmony预置应用--hap包方式与大家分享OpenHarmony预置应用--hap包方式。阅读详情

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

预置应用配置与安装

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

将应用配置为预置应用

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

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

hdc shell param get const.cust.config_dir_layer

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

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

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

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

修改完成后，将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被恢复安装
}