• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 系统账号子系统Changelog
2
3## cl.accountaccount_os_account.1 域账号服务器配置添加、删除、查询接口权限变更
4
5**访问级别**
6
7公开接口。
8
9**变更原因**
10
11系统接口变更为公开接口，接口管控权限跟随变更，新权限允许系统应用和企业应用申请。
12
13**变更影响**
14
15此变更需要应用适配。
16
17| 接口声明 | 变更前 | 变更后 |
18| ------- | ----- | ------ |
19|addServerConfig(parameters: Record\<string, Object>): Promise\<DomainServerConfig>|接口权限为ohos.permission.MANAGE_LOCAL_ACCOUNTS|接口权限为ohos.permission.MANAGE_DOMAIN_ACCOUNT_SERVER_CONFIGS|
20|removeServerConfig(configId: string): Promise\<void>|接口权限为ohos.permission.MANAGE_LOCAL_ACCOUNTS|接口权限为ohos.permission.MANAGE_DOMAIN_ACCOUNT_SERVER_CONFIGS|
21|getAccountServerConfig(domainAccountInfo: DomainAccountInfo): Promise\<DomainServerConfig>|接口权限为ohos.permission.MANAGE_LOCAL_ACCOUNTS|接口权限为ohos.permission.MANAGE_DOMAIN_ACCOUNT_SERVER_CONFIGS|
22
23**起始API Level**
24
25API 12
26
27**变更发生版本**
28
29从OpenHarmony 5.1.0.53 版本开始。
30
31**变更的接口/组件**
32
33[@ohos.account.osAccount.d.ts](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.account.osAccount.d.ts)中如下接口。
34
35- addServerConfig(parameters: Record\<string, Object>): Promise\<DomainServerConfig>
36
37- removeServerConfig(configId: string): Promise\<void>
38
39- getAccountServerConfig(domainAccountInfo: DomainAccountInfo): Promise\<DomainServerConfig>
40
41**适配指导**
42
43应用开发者需申请变更后的新权限：ohos.permission.MANAGE_DOMAIN_ACCOUNT_SERVER_CONFIGS
44
45## cl.accountaccount_os_account.2 addServerConfig接口错误码变更
46
47**访问级别**
48
49公开接口。
50
51**变更原因**
52
53接口新增“重复添加”，“添加配置已达上限”异常。
54
55**变更影响**
56
57此变更需要应用适配。
58
59- 变更前。
60  - addServerConfig 传入的配置信息已添加，返回OK。
61
62- 变更后。
63  - addServerConfig 传入的配置信息已添加，返回12300213 - Server config already exists。
64  - addServerConfig 配置信息已达上限，返回12300215 - The number of server config reaches the upper limit。
65
66
67**起始API Level**
68
69API 12
70
71**变更发生版本**
72
73从OpenHarmony 5.1.0.53 版本开始。
74
75**变更的接口/组件**
76
77[@ohos.account.osAccount.d.ts](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.account.osAccount.d.ts)中如下接口。
78
79- addServerConfig(parameters: Record\<string, Object>): Promise\<DomainServerConfig>
80
81
82**适配指导**
83
84调用addServerConfig接口新增12300213、123000215错误码，示例如下。
85
86```ts
87import { BusinessError, osAccount } from '@kit.BasicServicesKit';
88let configParams: Record<string, Object> = {
89  'uri': 'test.example.com',
90  'port': 100
91};
92osAccount.DomainServerConfigManager.addServerConfig(configParams).then((
93  serverConfig: osAccount.DomainServerConfig) => {
94  console.log('add server configuration successfully, the return config: ' + JSON.stringify(serverConfig));
95}).catch((err: BusinessError) => {
96  console.log('add server configuration failed, error: ' + JSON.stringify(err));
97  if (err.code === 12300213) {
98    // 提示配置项已存在。
99  }
100  if (err.code === 12300215) {
101    // 配置器添加数量已达上限。
102  }
103});
104```
105
106## cl.accountaccount_os_account.3 removeServerConfig接口错误码变更
107
108**访问级别**
109
110公开接口。
111
112**变更原因**
113
114接口新增“服务器配置已绑定账号，无法删除”异常。
115
116**变更影响**
117
118此变更需要应用适配。
119
120- 变更前。
121  - removeServerConfig传入的配置信息已和本地账号绑定，返回OK。
122
123- 变更后。
124  - removeServerConfig传入的配置信息已和本地账号绑定，返回12300214 - Server config has been associated with an account。
125
126
127**起始API Level**
128
129API 12
130
131**变更发生版本**
132
133从OpenHarmony 5.1.0.53 版本开始。
134
135**变更的接口/组件**
136
137[@ohos.account.osAccount.d.ts](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.account.osAccount.d.ts)中如下接口。
138
139- removeServerConfig(configId: string): Promise\<void>
140
141
142**适配指导**
143
144调用removeServerConfig接口新增12300214错误码，示例如下。
145
146```ts
147import { BusinessError, osAccount } from '@kit.BasicServicesKit';
148let configParams: Record<string, Object> = {
149  'uri': 'test.example.com',
150  'port': 100
151};
152osAccount.DomainServerConfigManager.addServerConfig(configParams).then((
153  serverConfig: osAccount.DomainServerConfig) => {
154  console.log('add domain server configuration successfully, the added config: ' + JSON.stringify(serverConfig));
155  osAccount.DomainServerConfigManager.removeServerConfig(serverConfig.id).catch((err: BusinessError) => {
156    console.log('remove server configuration failed, error: ' + JSON.stringify(err));
157    if (err.code === 12300214) {
158      // 提示配置项已绑定无法删除。
159    }
160  });
161}).catch((err: BusinessError) => {
162  console.log('add server configuration failed, error: ' + JSON.stringify(err));
163});
164```
165