HarmonyOS鸿蒙Next中添加系统权限后安装应用报错 install failed due to grant request permissions failed

开发者您好，可以按照以下流程进行排查。

背景知识

应用的等级分为normal、system_basic和system_core三个等级，默认情况下，应用的APL等级都为normal等级，如果使用了system_basic或system_core等级的权限，将导致报错。 权限机制中的基本概念

问题定位

• 检查是否在module.json5中申请了受限权限。
• 检查是否申请的权限等级高于应用默认的等级。
• 检查引用依赖组件名是否与依赖名保持一致。

分析结论

• module.json5中申请了受限权限。
• 申请的权限等级高于应用默认的等级。
• 引用依赖组件名与依赖名不一致。

修改建议

• 删除等级高的权限，重新签名及编译。应用服务签名参考：应用/元服务签名。
• 使用自动签名，临时获取提权，打开File->Project Structure ->SingningConfigs，勾选Automatically generate signature，等待重新编译应用，修改完成后，重启DevEco Studio。
• 当应用需要申请system_basic和system_core等级权限时，需要使用权限机制中的基本概念中的访问控制列表（ACL），参考使用ACL的签名配置指导进行签名，申请调试或发布证书。

  • 在应用的module.json5文件中，声明需要申请的权限。

    "module": { 
      "requestPermissions": [ 
        { 
          "name": "权限名"
        } 
      ] 
    }
    

  • 修改“SDK位置\base\toolchains\lib\UnsgnedReleasedProfileTemplate.json”文件。

    "bundle-info":{
      "developer-id": "OpenHarmony",
      "distribution-certificate": "xxx",
      "bundle-name": "com.OpenHarmony.app.test",
      "apl": "system_basic",
      "app-feature": "hos_system_app"
    },
    "acls": {
      "allowed-acls": [
      ]
    }
    

  • 重新签名及编译。

• 引用依赖组件名需要与依赖名保持一致。

该报错是由于权限未正确声明或配置导致。在HarmonyOS Next中，需要在应用的config.json文件中明确定义所需权限，格式需符合规范。权限名称必须与系统提供的权限完全匹配，且需要在manifest文件中声明权限使用意图。对于敏感权限，还需确保在设备设置中已开启相应权限开关。检查权限名称拼写和大小写是否正确，确认权限类型是否与API级别匹配。