150******47HarmonyOS 5
ArkUI
HarmonyOS SDK
ArkTS
关于鸿蒙应用的权限申请原因reason
丿未来丶一、基本写作规范
- 句式要求
必须为完整的短句,采用主动语态并明确用途。建议句式:"用于做某事"。
- 正例:"用于视频通话"(摄像头权限申请)
- 反例:"用于功能需要"(描述不具体)
- 内容长度
建议中文不超过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平台完成企业认证。
星河小飞船
Yanyan
Mandelx Hemen
思琛不想挂科
思琛不想挂科关键要求: 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": "获取你当前所在的国家城市,用于自动填充位置信息"
}
]
}
乌拉大乌拉
- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要提问题
HarmonyOS 获取到的OAID为00000000-0000-0000-0000-000000000000,这是什么原因?(API12+)
HarmonyOS 位置权限申请(API12+)
USE_FLOAT_BALL权限申请场景及例外审核
HarmonyOS push kit权限申请,邮件需要附带哪些材料?(API12)
HarmonyOS 应用中使用了某些权限,但是系统设置-应用页却没有该权限,这是为什么?(API12+)
HarmonyOS 如何防止频繁弹窗申请读取剪贴板权限(API12+)
HarmonyOS 权限未申请导致应用闪退(API12+)
HarmonyOS 应用向用户索取权限使用目的说明不明确(API12+)





































苏公安网备 32011402010933号