提交 922f61f7 编写于 作者: Z zengyawen

update permissions docs

Signed-off-by: Nzengyawen <zengyawen1@huawei.com>
上级 1f4c61f8
......@@ -6,10 +6,18 @@
本文将从如下场景分别介绍:
- [配置文件权限声明](#配置文件权限声明)
- [ACL方式声明](#acl方式声明)
- [向用户申请授权](#向用户申请授权)
- [user_grant权限预授权](#user_grant权限预授权)
- [访问控制授权申请指导](#访问控制授权申请指导)
- [场景介绍](#场景介绍)
- [配置文件权限声明](#配置文件权限声明)
- [Stage模型](#stage模型)
- [FA模型](#fa模型)
- [权限使用理由的文案内容规范](#权限使用理由的文案内容规范)
- [ACL方式声明](#acl方式声明)
- [向用户申请授权](#向用户申请授权)
- [Stage模型](#stage模型-1)
- [FA模型](#fa模型-1)
- [user\_grant权限预授权](#user_grant权限预授权)
- [相关实例](#相关实例)
## 配置文件权限声明
......@@ -100,41 +108,35 @@
### 权限使用理由的文案内容规范
当申请的权限为user_grant权限时,字段reason(申请权限的原因)必填。所有的user_grant权限均被归类到某个权限组中,使用时均通过[权限组](accesstoken-overview.md#权限组和子权限)进行申请。当前支持的权限组请查看[应用权限组列表](permission-group-list.md)
当申请的权限为user_grant权限时,字段reason(申请权限的原因)必填。开发者需要在应用配置文件中,配置每一个需要使用的权限
**reason字段的内容写作规范及建议如下:**
1. 如果需要申请“电话、信息、日历、通讯录、通话记录”这五个权限组的权限,根据工信部要求,需要展示具体子权限的内容与用途。
**建议句式**
中文:包括子权限A和子权限B,用于某事。
英文:Includes: PermissionA and PermissionB. This is used to do/for something.
> **说明:**<br> 中文使用逗号分割,英文使用句点分割。
但在实际向用户弹窗申请授权时,user_grant权限将会以[权限组](accesstoken-overview.md#权限组和子权限)向用户申请。当前支持的权限组请查看[应用权限组列表](permission-group-list.md)
**示例**:用于获取通话状态和移动网络信息,用于安全运营和统计计费服务。
**reason字段的内容写作规范及建议如下:**
2. 如果当前权限组申请不涉及子权限
1. 保持句子简洁、不要加入多余的分割符号
**建议句式**:用于某事。
**示例**:用于扫码拍照。
> **说明:**<br> 保持句子简洁、不要加入多余的分割符号。
3. 用途描述的字串建议小于72个字符(即36个中文字符,UI界面显示大约为两行)。不能超过256个字符,以免在多语言适配后体验不好。
2. 用途描述的字串建议小于72个字符(即36个中文字符,UI界面显示大约为两行)。不能超过256个字符,以免在多语言适配后体验不好。
4. 如果不写,将展示默认的申请理由。
3. 如果不写,将展示默认的申请理由。
**权限使用理由展示方式:**
向用户申请授权时,弹窗将以权限组维度显示,但在应用权限配置时,需要配置每个需要使用的子权限。
权限使用理由有两个展示途径:授权弹窗界面和“设置(Settings)”界面。“设置”的具体路径:设置-隐私-权限管理-某应用某权限详情
1. 如果是申请“电话、信息、日历、通讯录、通话记录”这五个权限组中的权限,根据工信部要求,将展示具体子权限的内容与用途。
**句式**:包括子权限A和子权限B,用于某事。
**样例**:用于获取通话状态和移动网络信息,用于安全运营和统计计费服务。
该用途有两个展示途径:授权弹窗界面和“设置(Settings)”界面。“设置”的具体路径:设置-隐私-权限管理-某应用某权限详情
2. 如果是申请其他权限组中的权限。系统将使用权限组内当前被申请的第一个子权限的使用理由,作为该权限组的使用理由进行展示。组内的排序,固定按照权限管理内排列的权限组数组顺序。
系统将使用权限组内当前被申请的第一个子权限的使用理由,作为该权限组的使用理由进行展示。组内的排序,固定按照权限管理内排列的权限组数组顺序。举例说明:权限组A = {权限A, 权限B, 权限C};申请传入的是{权限C, 权限B},界面将展示权限B中的权限使用理由。
举例说明:权限组A = {权限A, 权限B, 权限C};申请传入的是{权限C, 权限B},界面将展示权限B中的权限使用理由。
## ACL方式声明
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册