• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 文件管理子系统ChangeLog
2
3## cl.filemanagement.1 environment模块变更
4
5文件管理子系统d.ts归档整改，现统一整改到file一层目录下。environment模块支持错误码处理。
6
7**变更影响**
8
9基于此前版本开发的应用，需注意d.ts位置的变更及import模块名的变更。现environment模块支持错误码处理，需注意错误码处理的使用。[相关适配指导参考](../v3.2-beta4/changelogs-filemanagement.md)
10
11**关键接口/组件变更**
12
13原environment使用的是@ohos.environment，以以下方式import:
14
15```js
16import environment from '@ohos.environment';
17```
18
19现environment使用的是@ohos.file.environment，以以下方式import:
20
21```js
22import environment from '@ohos.file.environment';
23```
24
25## cl.filemanagement.2 securityLabel模块变更
26
27文件管理子系统d.ts归档整改，现统一整改到file一层目录下。securityLabel模块支持错误码处理。
28
29**变更影响**
30
31基于此前版本开发的应用，需注意d.ts位置的变更及import模块名的变更。现securityLabel模块支持错误码处理，需注意错误码处理的使用。[相关适配指导参考](../v3.2-beta4/changelogs-filemanagement.md)
32
33**关键接口/组件变更**
34
35原securityLabel使用的是@ohos.securityLabel，以以下方式import:
36
37```js
38import securityLabel from '@ohos.securityLabel';
39```
40
41现securityLabel使用的是@ohos.file.securityLabel，以以下方式import:
42
43```js
44import securityLabel from '@ohos.file.securityLabel';
45```
46
47## cl.filemanagement.3 fs模块变更
48
49fs模块下Stat接口ino属性类型变更。
50
51**变更影响**
52
53fs模块下Stat接口ino属性类型变更，由number变更为bigint，以适配文件系统下所有类型文件的inode范围。
54
55**关键接口/组件变更**
56
57原Stat接口ino属性类型为number，现变更为bigint。
58
59## cl.filemanagement.4 fileAccess模块变更
60
61文件管理子系统d.ts归档整改，现统一整改到file一层目录下。fileAccess模块支持错误码处理。
62
63**变更影响**
64
65基于此前版本开发的应用，需注意d.ts位置的变更及import模块名的变更。现fileAccess模块支持错误码处理，需注意错误码处理的使用。[相关适配指导参考](../v3.2-beta4/changelogs-filemanagement.md)
66
67**关键接口/组件变更**
68
69原fileAccess使用的是@ohos.data.fileAccess，以以下方式import:
70
71```js
72import fileAccess from '@ohos.data.fileAccess';
73```
74
75现fileAccess使用的是@ohos.file.fileAccess，以以下方式import:
76
77```js
78import fileAccess from '@ohos.file.fileAccess';
79```
80
81## cl.filemanagement.5 fileExtensionInfo模块变更
82
83文件管理子系统d.ts归档整改，现统一整改到file一层目录下。fileExtensionInfo模块支持错误码处理。
84
85**变更影响**
86
87基于此前版本开发的应用，需注意d.ts位置的变更及import模块名的变更。现fileExtensionInfo模块支持错误码处理，需注意错误码处理的使用。[相关适配指导参考](../v3.2-beta4/changelogs-filemanagement.md)
88
89**关键接口/组件变更**
90
91原fileExtensionInfo使用的是@ohos.fileExtensionInfo，以以下方式import:
92
93```js
94import fileExtensionInfo from '@ohos.fileExtensionInfo';
95```
96
97现fileExtensionInfo使用的是@ohos.file.fileExtensionInfo，以以下方式import:
98
99```js
100import fileExtensionInfo from '@ohos.file.fileExtensionInfo';
101```
102
103## cl.filemanagement.6 storageStatistics模块变更
104
105文件管理子系统d.ts归档整改，现统一整改到file一层目录下。fileExtensionInfo模块支持错误码处理。
106
107**变更影响**
108
109基于此前版本开发的应用，需注意d.ts位置的变更及import模块名的变更。现storageStatistics模块支持错误码处理，需注意错误码处理的使用。[相关适配指导参考](../v3.2-beta4/changelogs-filemanagement.md)
110
111**关键接口/组件变更**
112
113原storageStatistics使用的是@ohos.storageStatistics，以以下方式import:
114
115```js
116import storageStatistics from '@ohos.storageStatistics';
117```
118
119现storageStatistics使用的是@ohos.file.storageStatistics，以以下方式import:
120
121```js
122import storageStatistics from '@ohos.file.storageStatistics';
123```
124
125## cl.filemanagement.7 volumeManager模块变更
126
127文件管理子系统d.ts归档整改，现统一整改到file一层目录下。fileExtensionInfo模块支持错误码处理。
128
129**变更影响**
130
131基于此前版本开发的应用，需注意d.ts位置的变更及import模块名的变更。现volumeManager模块支持错误码处理，需注意错误码处理的使用。[相关适配指导参考](../v3.2-beta4/changelogs-filemanagement.md)
132
133**关键接口/组件变更**
134
135原volumeManager使用的是@ohos.volumeManager，以以下方式import:
136
137```js
138import volumeManager from '@ohos.volumeManager';
139```
140
141现volumeManager使用的是@ohos.file.volumeManager，以以下方式import:
142
143```js
144import volumeManager from '@ohos.file.volumeManager';
145```
146
147## cl.filemanagement.8 fileio相关接口异常处理方式变更
148
149file_api部件fileio接口返回值不包含错误码error.code，现进行错误码整改，废弃原有相关接口，新增相关接口。
150
151**变更影响**
152
153基于此前版本开发的应用，需注意废弃接口的迭代更新。新接口在接口规格上进行了微调，需注意新接口使用方法。
154
155**关键接口/组件变更**
156
157为适配统一的API异常处理方式，对fileio相关接口进行废弃，并新增对应接口，原接口位于@ohos.fileio，新接口位于@ohos.file.fs。新增接口支持统一的错误码异常处理规范，功能上与原接口保持一致，参数上有微调，以下为规格调整的接口列表。
158废弃与新增方法同名，请在列表中对应查看。
159
160| 模块名                    | 方法/属性/枚举/常量                                          | 变更类型 |
161| ------------------------- | ------------------------------------------------------------ | -------- |
162| @ohos.fileio        |  **function** access(path: string, mode?: number, callback?: AsyncCallback\<void>): void \| Promise\<void> | 废弃     |
163| @ohos.fileio        |  **function** accessSync(path: string, mode?: number): void | 废弃     |
164| @ohos.file.fs |  **function**  access(path: string, callback?: AsyncCallback\<boolean>): void \| Promise\<boolean> | 新增     |
165| @ohos.file.fs |  **function** accessSync(path: string): boolean | 新增     |
166| @ohos.fileio        |  **function** close(fd: number, callback?: AsyncCallback\<void>): void \| Promise\<void> | 废弃     |
167| @ohos.fileio        |  **function** closeSync(fd: number): void | 废弃     |
168| @ohos.file.fs |  **function** close(file: File \| number, callback?: AsyncCallback\<void>): void \| Promise\<void> | 新增     |
169| @ohos.file.fs |  **function** closeSync(file: File \| number): void | 新增     |
170| @ohos.fileio        |  **function** mkdir(path: string, mode?: number, callback?: AsyncCallback\<void>): void \| Promise\<void> | 废弃     |
171| @ohos.fileio        |  **function** mkdirSync(path: string, mode?: number): void | 废弃     |
172| @ohos.file.fs |  **function** mkdir(path: string, callback?: AsyncCallback\<void>): void \| Promise\<void> | 新增     |
173| @ohos.file.fs |  **function** mkdirSync(path: string): void | 新增     |
174| @ohos.fileio        |  **function** readText(filePath: string, options?: { position?: number; length?: number; encoding?: string; }, callback?: AsyncCallback\<string>): void \| Promise\<string> | 废弃     |
175| @ohos.fileio        |  **function** readTextSync(filePath: string, options?: { position?: number; length?: number; encoding?: string; }): string | 废弃     |
176| @ohos.file.fs |  **function** readText(filePath: string, options?: { offset?: number; length?: number; encoding?: string; }, callback?: AsyncCallback\<string>): void \| Promise\<string> | 新增     |
177| @ohos.file.fs |  **function** readTextSync(filePath: string, options?: { offset?: number; length?: number; encoding?: string; }): string | 新增     |
178| @ohos.fileio        |  **function** Stream.read(buffer: ArrayBuffer, options?: { offset?: number; length?: number; position?: number; }, callback?: AsyncCallback\<ReadOut>): void \| Promise\<ReadOut> | 废弃     |
179| @ohos.fileio        |  **function** Stream.readSync(buffer: ArrayBuffer, options?: { offset?: number; length?: number; position?: number; }): number | 废弃     |
180| @ohos.file.fs |  **function** Stream.read(fd: number, buffer: ArrayBuffer, options?: { offset?: number; length?: number; }, callback?: AsyncCallback\<number>): void \| Promise\<number> | 新增     |
181| @ohos.file.fs |  **function** Stream.readSync(fd: number, buffer: ArrayBuffer, options?: { offset?: number; length?: number; }): number | 新增     |
182| @ohos.fileio        |  **function** Stream.write(buffer: ArrayBuffer \| string, options?: { offset?: number; length?: number; position?: number; encoding?: string; }, callback?: AsyncCallback\<number>): void \| Promise\<void> | 废弃     |
183| @ohos.fileio        |  **function** Stream.writeSync(buffer: ArrayBuffer \| string, options?: { offset?: number; length?: number; position?: number; encoding?: string; }): number | 废弃     |
184| @ohos.file.fs |  **function** Stream.write(buffer: ArrayBuffer \| string, options?: { offset?: number; length?: number; encoding?: string; }, callback?: AsyncCallback\<number>): void \| Promise\<void> | 新增     |
185| @ohos.file.fs |  **function** Stream.writeSync(buffer: ArrayBuffer \| string, options?: { offset?: number; length?: number; encoding?: string; }): number | 新增     |
186
187**适配指导**
188
189@ohos.file.fs新增统一的API异常处理方式，具体示例代码请参考[接口文档](../../../application-dev/reference/apis/js-apis-file-fs.md)。
190