安装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/c0/v3/PF7yOQKyS36FqddTYLiGCw/zh-cn_image_0000002624638688.png?HW-CC-KV=V1&HW-CC-Date=20260709T134412Z&HW-CC-Expire=86400&HW-CC-Sign=B8F857979DAFF67AB6A1AC28E0428C024A0D02B83C36E7572B76234E69B9C4EE)

**解决措施**

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

使用命令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/a1/v3/bqBHTJk4S1invc3kdK_AUQ/zh-cn_image_0000002654838097.png?HW-CC-KV=V1&HW-CC-Date=20260709T134412Z&HW-CC-Expire=86400&HW-CC-Sign=C9912F611424A23E5B137FB9880543770DC680F82A2887D169FA974B4DD69575)，Compatible SDK选择更低的版本号，以兼容设备的API版本。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/05/v3/bu8UqZYwT4Sbt9mx7HbJQg/zh-cn_image_0000002624478780.png?HW-CC-KV=V1&HW-CC-Date=20260709T134412Z&HW-CC-Expire=86400&HW-CC-Sign=3C050D65043BD7A696C86EB1A947C17253C66CF18C4ABEFF3536C0517CE4D18A)

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/50/v3/OnIr1ya0QX-woiJvo4swpA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T134412Z&HW-CC-Expire=86400&HW-CC-Sign=19515C787667610F578B931773AEC0EDD2ECC4538D42FF4F234A058CAB888B83)

*   如果执行命令后返回“\[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**返回的信息。