安装HAP时提示“compatibleSdkVersion and releaseType of the app do not match the apiVersion and releaseType on the device.”
====================================================================================================================

**问题现象**

在启动调试或运行应用/服务时，安装HAP出现错误，提示“compatibleSdkVersion和releaseType与设备上的apiVersion和releaseType不匹配。”

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/40/v3/kTjCK_g2QkehJwPHgzJn1w/zh-cn_image_0000002247307937.png?HW-CC-KV=V1&HW-CC-Date=20260612T074824Z&HW-CC-Expire=86400&HW-CC-Sign=8E9FC9B1A0069DF68542BE27020C06E383573F072E0F68F9E73D972DFBFD9864)

**解决措施**

出现该问题是因为当前工程配置的最低兼容版本高于设备镜像版本。

使用命令hdc shell param get const.ohos.apiversion查询当前设备的 API 版本，并对比工程级build-profile.json5配置文件中的compatibleSdkVersion字段。如果版本不匹配，可以使用以下解决办法：

方法一：请升级设备镜像版本以匹配当前工程版本。在系统设置界面升级设备系统。

方法二：降低工程的API版本，点击DevEco Studio右上角的![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/05/v3/g6bz-UrXSmCnpWcb4T1f7g/zh-cn_image_0000002489396138.png?HW-CC-KV=V1&HW-CC-Date=20260612T074824Z&HW-CC-Expire=86400&HW-CC-Sign=31B5E8C25AD6FC617964D49B9AA1ADC93E1E04055B6DD19E4C70AFF52CB144F7)，Compatible SDK选择更低的版本号，以兼容设备的API版本。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/33/v3/Pz0UpNm5R9aZ-iAFQ6x0gg/zh-cn_image_0000002521676021.png?HW-CC-KV=V1&HW-CC-Date=20260612T074824Z&HW-CC-Expire=86400&HW-CC-Sign=9D6279F7FA07C6670F8965259BEDAFE3EAE86BA912D34303760F8C5BF863B46C)

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a9/v3/ocvsPkMRQpatahA-wBLcFw/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T074824Z&HW-CC-Expire=86400&HW-CC-Sign=DB7598C66FAC1419D324AE80EC251231A7C8EFF72CF27B9C673D38B19363771D)

*   如果执行命令后返回“\[Fail\]ExecuteCommand need connect-key? please confirm a device by help info”，可能是连接了多台调试设备，或者模拟器和真机同时使用。
    *   如果同时连接了模拟器和真机，请断开模拟器。
    *   如果连接了多台设备，每次执行命令时需要使用-t参数指定目标设备的标识符。您可先执行**hdc list targets命令**查询连接的设备，再通过**hdc -t _connect-key_ shell param get const.ohos.apiversion**命令指定要连接的目标设备，其中connect-key为设备标识符，即**hdc list targets**返回的信息。