鸿蒙权限管理：受限权限申请(六)

本文同步发表于我的微信公众号微信搜索程语新视界即可关注每个工作日都有文章更新一、受限权限受限权限是指默认不允许普通应用申请只有在特殊场景下通过应用市场AGC审核后才能使用的权限。受限权限的特点特点说明默认不可用普通应用默认无法申请需要审核必须通过AGC审核才能使用场景限制仅限特殊场景使用上架管控上架时会严格审核为了保护用户隐私和系统安全系统将一些敏感度极高的权限设置为受限开放。这些权限如果被滥用可能对用户造成严重的影响。申请原则在申请前请审视是否符合受限权限的使用场景。开发者应优先使用Picker/控件等替代方案仅少量符合特殊场景的应用被允许申请受限权限。二、受限权限列表可以通过受限开放权限列表查询哪些权限属于受限开放每个权限的可用场景推荐的替代方案提示必须查询受限开放权限列表确认开发的应用是否符合使用场景如果不符合要求应用的上架申请将被驳回。三、申请前的准备工作在申请受限权限前需要查阅权限列表确认要申请的权限是否属于受限开放阅读使用场景每个权限都有明确的可用场景说明评估替代方案是否有Picker/控件等替代方案准备申请材料权限说明文档、视频说明等如果应用场景不符合要求但试图在配置文件中声明此类权限将会导致安装失败应用无法安装上架驳回应用市场审核不通过四、申请步骤申请流程图步骤1确认权限是否受限开放 ↓ 步骤2在AGC申请Profile文件并申请权限 ↓ 步骤3下载Profile文件用于签名 ↓ 步骤4在module.json5中声明权限 ↓ 步骤5如果是user_grant权限向用户申请授权 ↓ 步骤6应用上架审核步骤1确认权限是否受限开放查阅受限开放权限列表确认该权限是否属于受限开放自己的应用是否符合使用场景是否有替代方案步骤2在AGC申请Profile文件在应用市场AGC侧申请Profile文件并同步申请使用相应受控权限。详细步骤请参阅申请发布Profile关键点在添加Profile页面时必须申请使用相应权限请确保提供的场景和功能信息准确如果权限超出申请范围将影响上架步骤3下载Profile文件申请通过后下载Profile文件用于后续的应用签名信息配置。步骤4在配置文件中声明权限在module.json5配置文件中声明需要申请的权限。{ module: { requestPermissions: [ { name: ohos.permission.READ_MEDIA, // 受限权限示例 reason: $string:read_media_reason, usedScene: { abilities: [EntryAbility], when: inuse } } ] } }步骤5向用户申请授权如果需要通过权限列表中的授权方式字段判断是否需要用户授权授权方式是否需要用户授权system_grant不需要安装时自动授予user_grant需要运行时弹窗申请manual_settings需要引导用户去设置如果是user_grant权限还需要通过弹窗向用户申请授权。import { abilityAccessCtrl, common, Permissions } from kit.AbilityKit; async function requestPermission(permission: Permissions, context: common.UIAbilityContext) { let atManager abilityAccessCtrl.createAtManager(); try { let result await atManager.requestPermissionsFromUser(context, [permission]); if (result.authResults[0] 0) { console.info(用户授权成功); } else { console.warn(用户拒绝授权); } } catch (error) { console.error(申请权限失败, error); } }步骤6应用上架审核在应用上架时应用市场将根据应用的使用场景审核是否可以使用对应的受限权限。需要准备的材料为每个受限权限项填写相应的权限说明上传视频说明使用场景详情请见发布HarmonyOS应用五、调试与发布的区别调试阶段在调试阶段可以通过DevEco Studio自动签名完成申请。# DevEco Studio中 Build Generate Key and CSR...在自动签名的过程中将由DevEco Studio完成向AGC申请受限权限的步骤开发者可直接使用。具体请参考自动签名-操作步骤发布阶段在发布阶段必须根据申请发布Profile完成受限权限的手动申请。不能依赖自动签名必须走正式申请流程。六、注意事项审核要求审核项要求使用场景必须符合权限列表中的可用场景权限说明需要为每个权限填写说明视频证明需要上传视频说明使用场景权限范围不能超出申请的范围常见驳回原因原因说明场景不符应用场景不符合权限的可用场景替代方案存在Picker/控件等替代方案却未使用说明不清权限使用理由不明确超范围使用申请的权限超出了实际使用的范围备注:如果应用未申请相应的权限证书却试图在配置文件中声明此类权限将会导致应用安装失败。请确保应用申请受限开放权限时提供的场景和功能信息准确。如果应用内使用的受限开放权限超出您申请的范围或申请权限后使用的功能和场景超出可使用的范围将影响您的应用上架。总结申请流程速查表步骤操作注意事项1确认权限是否受限开放查阅受限开放权限列表2确认使用场景必须符合可用场景3准备申请材料权限说明、视频等4AGC申请Profile同时申请权限5下载Profile用于签名6配置文件声明module.json57向用户申请如需user_grant权限8应用上架审核通过原则优先使用替代方案仅特殊场景才申请受限权限总之一句话受限权限申请 确认场景符合 AGC申请Profile 配置文件声明 上架审核