File Management Subsystem Changelog
cl.filemanagement.1 environment Module Change
The file management subsystem d.ts file has been archived and moved to the file directory. The environment module supports error code handling.
Change Impact
If your application is developed based on earlier versions, note that the d.ts file location and the name of the module to be imported are changed. The environment module supports error code handling. See Adaptation Guide.
Key API/Component Changes
Before the change, environment is imported from @ohos.environment:
import environment from '@ohos.environment';
Now, environment is imported from @ohos.file.environment:
import environment from '@ohos.file.environment';
cl.filemanagement.2 securityLabel Change
Moved the file management subsystem d.ts file to the file directory. The securityLabel module supports error code handling.
Change Impact
If your application is developed based on earlier versions, note that the d.ts file location and the name of the module to be imported are changed. The securityLabel module supports error code handling. See Adaptation Guide.
Key API/Component Changes
Before the change, securityLabel is imported from @ohos.securityLabel:
import securityLabel from '@ohos.securityLabel';
Now, securityLabel is imported from @ohos.file.securityLabel:
import securityLabel from '@ohos.file.securityLabel';
cl.filemanagement.3 fs Change
Changed the ino attribute type of Stat under fs.
Change Impact
The ino attribute type is changed from number to BigInt, to adapt to the inode range of all types of files in the file system.
Key API/Component Changes
The type of the ino attribute of Stat is changed from number to BigInt.
cl.filemanagement.4 fileAccess Change
Moved the file management subsystem d.ts file to the file directory. The fileAccess module supports error code handling.
Change Impact
If your application is developed based on earlier versions, note that the d.ts file location and the name of the module to be imported are changed. The fileAccess module supports error code handling. See Adaptation Guide.
Key API/Component Changes
Before the change, fileAccess is imported from @ohos.data.fileAccess:
import fileAccess from '@ohos.data.fileAccess';
Now, fileAccess is imported from @ohos.file.fileAccess:
import fileAccess from '@ohos.file.fileAccess';
cl.filemanagement.5 fileExtensionInfo Change
Moved the file management subsystem d.ts file to the file directory. The fileExtensionInfo module supports error code handling.
Change Impact
If your application is developed based on earlier versions, note that the d.ts file location and the name of the module to be imported are changed. The fileExtensionInfo module supports error code handling. See Adaptation Guide.
Key API/Component Changes
Before the change, fileExtensionInfo is imported from @ohos.fileExtensionInfo:
import fileExtensionInfo from '@ohos.fileExtensionInfo';
Now, fileExtensionInfo is imported from @ohos.file.fileExtensionInfo:
import fileExtensionInfo from '@ohos.file.fileExtensionInfo';
cl.filemanagement.6 storageStatistics Change
Moved the file management subsystem d.ts file to the file directory. The fileExtensionInfo module supports error code handling.
Change Impact
If your application is developed based on earlier versions, note that the d.ts file location and the name of the module to be imported are changed. The storageStatistics module supports error code handling. See Adaptation Guide.
Key API/Component Changes
Before the change, storageStatistics was imported from @ohos.storageStatistics:
import storageStatistics from '@ohos.storageStatistics';
Now, storageStatistics is imported from @ohos.file.storageStatistics:
import storageStatistics from '@ohos.file.storageStatistics';
cl.filemanagement.7 volumeManager Change
Moved the file management subsystem d.ts file to the file directory. The fileExtensionInfo module supports error code handling.
Change Impact
If your application is developed based on earlier versions, note that the d.ts file location and the name of the module to be imported are changed. The volumeManager module supports error code handling. See Adaptation Guide.
Key API/Component Changes
Before the change, volumeManager was imported from @ohos.volumeManager:
import volumeManager from '@ohos.volumeManager';
Now, volumeManager is imported from @ohos.file.volumeManager:
import volumeManager from '@ohos.file.volumeManager';
cl.filemanagement.8 fileio API Changes
Deprecated the fileio APIs, which do not return error codes; added APIs that return error codes.
Change Impact
For applications developed based on earlier versions, pay attention to the iterative update of deprecated APIs. The specifications of the new APIs are slightly adjusted. Pay attention to the usage of the new APIs.
Key API/Component Changes
The APIs of @ohos.fileio do not support error code handling and are deprecated. New APIs with minor changes in parameters are added in @ohos.file.fs to support unified error code handling specifications. The new APIs function the same as the original APIs. The following table lists the API changes. The API names remain unchanged.
| Module | Method/Attribute/Enum/Constant | Change Type |
|---|---|---|
| @ohos.fileio | function access(path: string, mode?: number, callback?: AsyncCallback<void>): void | Promise<void> | Deprecated |
| @ohos.fileio | function accessSync(path: string, mode?: number): void | Deprecated |
| @ohos.file.fs | function access(path: string, callback?: AsyncCallback<boolean>): void | Promise<boolean> | Added |
| @ohos.file.fs | function accessSync(path: string): boolean | Added |
| @ohos.fileio | function close(fd: number, callback?: AsyncCallback<void>): void | Promise<void> | Deprecated |
| @ohos.fileio | function closeSync(fd: number): void | Deprecated |
| @ohos.file.fs | function close(file: File | number, callback?: AsyncCallback<void>): void | Promise<void> | Added |
| @ohos.file.fs | function closeSync(file: File | number): void | Added |
| @ohos.fileio | function mkdir(path: string, mode?: number, callback?: AsyncCallback<void>): void | Promise<void> | Deprecated |
| @ohos.fileio | function mkdirSync(path: string, mode?: number): void | Deprecated |
| @ohos.file.fs | function mkdir(path: string, callback?: AsyncCallback<void>): void | Promise<void> | Added |
| @ohos.file.fs | function mkdirSync(path: string): void | Added |
| @ohos.fileio | function readText(filePath: string, options?: { position?: number; length?: number; encoding?: string; }, callback?: AsyncCallback<string>): void | Promise<string> | Deprecated |
| @ohos.fileio | function readTextSync(filePath: string, options?: { position?: number; length?: number; encoding?: string; }): string | Deprecated |
| @ohos.file.fs | function readText(filePath: string, options?: { offset?: number; length?: number; encoding?: string; }, callback?: AsyncCallback<string>): void | Promise<string> | Added |
| @ohos.file.fs | function readTextSync(filePath: string, options?: { offset?: number; length?: number; encoding?: string; }): string | Added |
| @ohos.fileio | function Stream.read(buffer: ArrayBuffer, options?: { offset?: number; length?: number; position?: number; }, callback?: AsyncCallback<ReadOut>): void | Promise<ReadOut> | Deprecated |
| @ohos.fileio | function Stream.readSync(buffer: ArrayBuffer, options?: { offset?: number; length?: number; position?: number; }): number | Deprecated |
| @ohos.file.fs | function Stream.read(fd: number, buffer: ArrayBuffer, options?: { offset?: number; length?: number; }, callback?: AsyncCallback<number>): void | Promise<number> | Added |
| @ohos.file.fs | function Stream.readSync(fd: number, buffer: ArrayBuffer, options?: { offset?: number; length?: number; }): number | Added |
| @ohos.fileio | function Stream.write(buffer: ArrayBuffer | string, options?: { offset?: number; length?: number; position?: number; encoding?: string; }, callback?: AsyncCallback<number>): void | Promise<void> | Deprecated |
| @ohos.fileio | function Stream.writeSync(buffer: ArrayBuffer | string, options?: { offset?: number; length?: number; position?: number; encoding?: string; }): number | Deprecated |
| @ohos.file.fs | function Stream.write(buffer: ArrayBuffer | string, options?: { offset?: number; length?: number; encoding?: string; }, callback?: AsyncCallback<number>): void | Promise<void> | Added |
| @ohos.file.fs | function Stream.writeSync(buffer: ArrayBuffer | string, options?: { offset?: number; length?: number; encoding?: string; }): number | Added |
Adaptation Guide
The APIs of @ohos.file.fs support unified exception handling. For details, see File Management.