文档开发者中心
我的
|

HarmonyOS 5

ArkUI

HarmonyOS SDK

ArkTS

关于鸿蒙应用的权限申请原因reason

30
在申请权限的时候,敏感权限必须要有申请原因,那么这个原因在官方文档或者社区里有申请原因reason的模板吗
点赞
收藏
回复
8
分享
举报
浏览180 发布于2025-12-15 06:29黑龙江
全部评论
最多点赞
最新发布
最早发布

一、基本写作规范

  • 句式要求

必须为完整的短句,采用主动语态并明确用途。建议句式:"用于做某事"。

  • 正例:"用于视频通话"(摄像头权限申请)
  • 反例:"用于功能需要"(描述不具体)
  • 内容长度

建议中文不超过36字(约72个英文字符),避免多语言适配时文本溢出。最大长度限制为256字符。

  • 工信部特殊要求

对于电话、信息、日历、通讯录、通话记录权限组,需明确列出子权限用途,例如:

"包括子权限A和子权限B,用于安全运营和统计计费服务"

二、申请原因模板结构

官方建议按照以下三部分组织权限申请理由(尤其适用于账号类等敏感权限):

收起
自动换行
深色代码主题
复制
应用介绍:说明应用类型,例如XXX应用属于XXX类型的应用。
使用场景:在XXX场景下,需要使用XX能力(需匹配预设场景类型)。
申请用途:用户使用XXX功能后,进行XXX操作,提供XXX服务。

三、使用场景类型对照

开发者在填写使用场景时需参考官方分类,部分场景示例如下:

场景类型 业务描述示例
即时通信类 提供文字、图片、语音等通信服务
网络支付类 实现网络支付、提现、转账功能
问诊挂号类 提供在线咨询问诊、预约挂号服务
本地生活类 支持家政维修、二手闲置交易服务

四、配置示例

在module.json5中配置权限时需遵循以下格式:

收起
自动换行
深色代码主题
复制
{
  "module": {
    "requestPermissions": [
      {
        "name": "ohos.permission.CAMERA",
        "reason": "$string:camera_reason",  // 对应strings.json中的描述
        "usedScene": {
          "abilities": ["MainAbility"],
          "when": "inuse"
        }
      }
    ]
  }
}

其中strings.json中需定义具体描述:

收起
自动换行
深色代码主题
复制
{
  "string": [
    {
      "name": "camera_reason",
      "value": "用于扫描二维码和视频通话"
    }
  ]
}

五、注意事项

  • 权限组展示规则

若同时申请同一权限组内多个权限,系统将优先展示第一个子权限的reason内容。

  • 企业开发者限制

部分高危权限(如账号权限)仅对企业开发者开放申请入口,需在AGC平台完成企业认证。

展开全部
7楼回复于2025-12-18 14:40 来自广东

有模板和示例的。

这个也我提审的时候审核反馈的。具体参考以下文档:
声明权限-申请应用权限-应用权限管控-程序访问控制-安全-系统 - 华为HarmonyOS开发者 (huawei.com)

cke_1866.png

6楼回复于2025-12-17 03:04 来自上海
根据自己的app使用这个权限实现什么功能,写上去就行
5楼回复于2025-12-16 15:54 来自安徽
简单说明这个权限适用于什么功能的,当然不能涉及到特别敏感信息
4楼回复于2025-12-16 08:52 来自山东
就是把你申请这个权限要干啥写一下而已,简短明了一点就好。
1
3楼回复于2025-12-15 07:16 来自广东
  • 思琛不想挂科
    关键要求: 1. 多语种适配: reason必须通过 $string:xxx引用多语言资源,在 string.json中配置对应内容(如中文 "name": "camera_reason",英文需另配)。 2. 内容规范(权限使用理由的文案内容规范): 明确说明权限用途(如“用于扫描二维码完成支付”); 禁止模糊描述(如“提升用户体验”); 与功能强相关,不得超出业务范围。 3. 必填场景: user_grant(用户授权)或 manual_settings(需手动设置)类权限; 受限开放权限(如位置、通讯录)。
    2025-12-15 07:21 来自广东

你好,以申请定位权限为例,申请理由据实填写。

1、在对应模块的 src/main/module.json5 中填写申请理由和使用场景

收起
自动换行
深色代码主题
复制
"requestPermissions": [
  {
    "name": "ohos.permission.LOCATION",
    "reason": "$string:location",
    "usedScene": {
      "when": "inuse"
    }
  },
  {
    "name": "ohos.permission.APPROXIMATELY_LOCATION",
    "reason": "$string:location",
    "usedScene": {
      "when": "inuse"
    }
  }
]

2、在 src/main/resources/base/element/string.json 中填写具体的申请理由文本

收起
自动换行
深色代码主题
复制
{
  "string": [
    {
      "name": "page_show",
      "value": "page from package"
    },
    {
      "name": "location",
      "value": "获取你当前所在的国家城市,用于自动填充位置信息"
    }
  ]
}
展开全部
2楼回复于2025-12-15 06:40 来自四川
reason自己根据需要写就可以,并明确 使用原因,简单明了,基本就是申请这个权限的场景和功能作用
1楼回复于2025-12-15 06:31 来自河北
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。