权限分类及受限权限未审批前如何进行应用调试
=====================

#### 问题现象

应用开发过程中需要使用各种权限，具体权限的分类是怎样的？如果需要使用特殊的权限是否需要审批？审批通过前能否先获取权限进行调试？

#### 背景知识

1.  应用在开发和运行过程中需要用到相应的权限，应用在申请权限时，需在项目的配置文件中逐个声明所需权限，否则无法获取授权，并可能导致应用上架申请被驳回。配置方式可参考[声明权限](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/declare-permissions)。
2.  权限列表可分为开放权限、[受限开放权限](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/restricted-permissions)（也可称为ACL权限）、[企业类应用可用权限](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/permissions-for-enterprise-apps)和[仅MDM应用可用权限](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/permissions-for-mdm-apps)。根据授权方式的不同，权限类型可分为[system\_grant（系统授权）](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-permission-mgmt-overview#system_grant系统授权)、[user\_grant（用户授权）](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-permission-mgmt-overview#user_grant用户授权)和[manual\_settings（手动设置授权）](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-permission-mgmt-overview#manual_settings手动设置授权)。

*   应用申请了system\_grant权限后，系统将在用户安装应用时，自动把相应权限授予给应用。
*   应用申请user\_grant的权限，不仅需要在安装包中申请权限，还需要在应用动态运行时，通过发送弹窗的方式请求用户授权。在用户手动允许授权后，应用才会真正获取相应权限，从而成功访问操作目标对象。
*   从API 21开始，新增支持manual\_settings权限。该类型权限需在安装包中申请，无法通过弹窗请求用户授权，只能由用户在系统设置应用中授权。当用户手动设置授权后，应用才能获取相应权限，从而成功访问目标对象。

3.  [受限开放权限](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/restricted-permissions)仅适用于少量符合特殊场景的应用，需要在通过审批后，才能使用受限权限。在申请前，请审视是否符合受限权限的使用场景。为避免应用的上架申请被驳回，开发者应优先使用Picker/控件等替代方案。[受限开放权限](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/restricted-permissions)列表展示了所有可以申请的权限名称，申请场景，权限级别，授权方式和起始版本。申请方式参考[申请ACL权限](https://developer.huawei.com/consumer/cn/doc/app/agc-help-apply-acl-0000002394212138)。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/6d/v3/2LAcQ9s9SFC-ym_LZzUbIA/notice_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T134331Z&HW-CC-Expire=86400&HW-CC-Sign=3FBA8E042915DD53379DD004BE95C2A53432FBC1331C4B1F49C3B54CB308329B)
    
    注意：部分ACL权限只对受邀应用开放，非受邀应用在AGC上无法申请该权限。
    

#### 解决方案

申请Profile文件时可以关联受限权限，应用上架必须使用发布Profile，如果受限权限未审批，应用无法上架。但是本地可以使用调试Profile提前获取相关受限权限进行应用调试。提供两种方案：

1.  通过DevEco Studio自动签名完成申请。在自动签名的过程中，将由DevEco Studio完成向AGC申请受限权限的步骤，开发者可直接使用。
    *   在module.json5配置文件的requestPermissions标签中声明需要申请的ACL权限。具体操作可参考[声明权限](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/declare-permissions)。
    *   使用真机设备连接开发工具DevEco Studio后，进入File > Project Structure... > Project > Signing Configs界面，勾选“Automatically generate signature”即可完成签名。如果未登录，请先单击Sign In进行登录，然后自动完成签名。申请了受限权限页面也会弹窗提示：
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/97/v3/sxSQRI3HQmG0p56_0vC8WQ/zh-cn_image_0000002658793903.png?HW-CC-KV=V1&HW-CC-Date=20260709T134331Z&HW-CC-Expire=86400&HW-CC-Sign=08815DA4E64018CA880B4ADB7B609FB1607232F3804A3CAAF2BDA050F0DA4AF1 "点击放大")
        
    *   签名完成后，将鼠标悬停在Provisioning Profile: DevEco Managed Profile后![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3b/v3/QURmaR0xSOWq_HlwVS9XTQ/zh-cn_image_0000002628394636.png?HW-CC-KV=V1&HW-CC-Date=20260709T134331Z&HW-CC-Expire=86400&HW-CC-Sign=7C860B13F188075FC5BAA05613A922D12F27CF4C183BFE3B999941F321E9E9EB)，也可查看申请的ACL权限信息：
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ba/v3/kjq33kUbSvKr37C0oKAt-w/zh-cn_image_0000002628554528.png?HW-CC-KV=V1&HW-CC-Date=20260709T134331Z&HW-CC-Expire=86400&HW-CC-Sign=E02EC30196EE85AAC4CA01279F60C27FB25B66C6B3F882015F369ABB68AAAEBF "点击放大")
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/39/v3/4PcE-NMHTkmm9MPWGEQjQg/notice_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T134331Z&HW-CC-Expire=86400&HW-CC-Sign=D8641ED89EF33D8CCA03B32CA382CB98CA0E3E4ED1DB5D54D7631D48EDDC7382)
        
        注意：只有在[自动签名支持的ACL权限](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section5301916183411)权限列表的权限才可以通过自动签名申请。
        

2.  在AGC[创建试用调试Profile](https://developer.huawei.com/consumer/cn/doc/app/agc-help-apply-acl-0000002394212138#section1443958124819)，完成[申请ACL权限](https://developer.huawei.com/consumer/cn/doc/app/agc-help-apply-acl-0000002394212138)后，在审核等待期间，还可以创建试用调试Profile来提前试用您申请的这些权限。试用调试Profile有效期为5天，到期即失效。具体操作指导如下：

*   在提交ACL权限申请后弹出的提示框中，点击“Profile页面”链接。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2a/v3/_KKafWfkSbiv0lgFneix2g/zh-cn_image_0000002658913847.png?HW-CC-KV=V1&HW-CC-Date=20260709T134331Z&HW-CC-Expire=86400&HW-CC-Sign=990C740421FF9A28D4B32A5D176A74EC9A62C65F3AF9A8CE8EF2D3EF92BEC5C8)
    
*   进入“添加试用调试Profile”页面，配置Profile信息。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/42/v3/t7ahdBb7Qqie_gIpanyrCw/zh-cn_image_0000002658793905.png?HW-CC-KV=V1&HW-CC-Date=20260709T134331Z&HW-CC-Expire=86400&HW-CC-Sign=955C1EF6D2E36F305DA29F23E144D54C6E3F23916751A5FD2A19B78C838290B9 "点击放大")
    
*   添加ACL权限到Profile。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/db/v3/pyCpIdPGT_u4alU4_Xjs4Q/zh-cn_image_0000002628394638.png?HW-CC-KV=V1&HW-CC-Date=20260709T134331Z&HW-CC-Expire=86400&HW-CC-Sign=A3C80645F3DEC13AC8A5F78C5B4604C08CA5DE0DFB6EA7BC079003C353F3DA57 "点击放大")
    
*   核对Profile信息无误后，点击右上角“添加”，试用调试Profile创建成功。点击“下载”，将生成的Profile保存至本地，供后续签名使用。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b2/v3/QIhyMN0nTTir8ECZxJvc3Q/zh-cn_image_0000002628554530.png?HW-CC-KV=V1&HW-CC-Date=20260709T134331Z&HW-CC-Expire=86400&HW-CC-Sign=8C9AA1D48EE082976BB0195B507BD1F5554C2E2959376541D23B20F79EC7AB1F "点击放大")
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ab/v3/YE1eMe6RR72WArkdWhKr6A/notice_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T134331Z&HW-CC-Expire=86400&HW-CC-Sign=61D011FE8D9D022DE06640A96C2F04649F9B6900C63793EC4A66C44E183200B2)
    
    注意：必须先提交ACL权限申请，才能创建试用调试Profile。不支持直接创建试用调试Profile。
    

#### 常见FAQ

Q：一个应用可以创建多少个试用调试Profile？

A：一个应用或元服务最多支持创建5个试用调试Profile。

Q：企业类应用可用权限是什么意思，权限是否需要申请后使用？

A：企业类应用包括企业普通应用和MDM（Mobile Device Management）设备管理应用。企业类应用仅在企业定制设备上运行，不会在普通消费者设备上运行；分发类型分别为enterprise\_normal（企业普通应用）和enterprise\_mdm（MDM应用）；不会上架华为应用市场。

Q：企业类应用可用权限和仅MDM应用可用权限是否支持自动签名？

A：不支持自动签名，因此在调试和发布阶段，均需参照[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)的步骤，完成手动签名。