• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 程序访问控制子系统变更说明
2
3## cl.access_token.1 位置控件功能变更
4
5**访问级别**
6
7公开接口
8
9**变更原因**
10
11从最新的大数据分析，在需要获取位置信息时，大部分应用使用地图picker或者权限弹窗来申请位置权限，仅有极少数应用使用位置控件，该特性的价值有限，经谨慎评估将该特性下架。
12
13位置控件已经在API 15版本开始废弃，此次需要将位置控件的接口删除。
14
15**变更影响**
16
17该变更涉及应用适配。
18
19变更前：
20
21应用界面上集成位置控件，用户点击位置控件后，应用可获取临时的位置权限。其中，用户首次在应用中使用位置控件时，会弹出确认弹窗请求用户允许或者拒绝。
22
23变更后：
24
251. 位置控件相关的接口从SDK中删除。
262. 升级镜像后，存量的应用可以继续使用位置控件功能。位置控件每次被点击后，都会弹出确认弹窗请求用户允许或者拒绝。
27
28**起始 API Level**
29
3010
31
32**变更发生版本**
33
34从OpenHarmony SDK 6.0.0.39 版本开始。
35
36**变更的接口/组件**
37
38@internal/component/ets/location_button.d.ts中所有接口。
39
40**适配指导**
41
42开发者通过权限弹窗申请用户授权，指导：[申请应用权限](../../../application-dev/security/AccessToken/request-user-authorization.md)。
43
44## cl.access_token.2 去除保存控件系统提示弹框变更
45
46**访问级别**
47
48公开接口
49
50**变更原因**
51
52当前，保存控件支持自定义UI样式。应用选择使用自定义UI，当用户点击保存控件，成功保存媒体文件时，系统将弹出系统弹框提示用户。在开发过程中，开发者可以调用指定API调整该系统弹框的位置。
53
54保存控件系统提示弹框：
55![savebutton_tip](figures/savebutton_tip.png)
56
57经评估，强制弹出系统弹框会与应用内已有弹框冲突，体验不够友好，系统将取消该系统强制弹框的行为。
58
59**变更影响**
60
61该变更涉及应用适配。
62
63变更前：当开发者需要自定义保存控件的图标和文本时，或者保存控件不满足[约束与限制](../../../application-dev/security/AccessToken/security-component-overview.md#约束与限制)，点击保存控件时会弹出系统提示弹框。开发者可以使用`tipPosition`接口设置保存控件系统提示弹框展示在屏幕上的位置。
64
65变更后：保存控件被点击后不会弹出系统提示弹框。开发者无法调用系统提示弹框的位置设置接口`tipPosition`。应用可根据自身UX设计，自行选择是否实现应用内保存提示。
66
67**起始 API Level**
68
6920
70
71**变更发生版本**
72
73从OpenHarmony SDK 6.0.0.39版本开始。
74
75**变更的接口/组件**
76
77删除接口如下
78
79| 类名           | 删除接口声明                                                 |
80| -------------- | ------------------------------------------------------------ |
81| SaveButtonAttribute | tipPosition(position: SaveButtonTipPosition)|
82
83删除枚举如下：
84
85| 枚举类型 | 删除的键值 |
86| -------- | ---- |
87| SaveButtonTipPosition | ABOVE_BOTTOM |
88| SaveButtonTipPosition | BELOW_TOP |
89
90**适配指导**
91
92取消对设置系统提示位置接口`tipPosition`的调用，否则会导致编译和运行失败。