harmony 鸿蒙File Management Subsystem Changelog

2023-06-24
浏览 (434)

File Management Subsystem Changelog

cl.file.1 mediaLibrary APIs Changed

The MediaLibrary class of the multimedia component is replaced by the FilePicker class.

Change Impact

For applications developed based on earlier versions, pay attention to the changes of APIs. FilePicker is a system application preset in OpenHarmony. You can use it to select and save files.

Key API/Component Changes

The APIs of MediaLibrary, located in @ohos.multimedia.medialibrary, are deprecated. The FilePicker class, located in @ohos.file.picker is used.

Module	Method/Attribute/Enum/Constant	Change Type
medialibrary	function getMediaLibrary(): MediaLibrary;	Deprecated
medialibrary	function getMediaLibrary(context: Context): MediaLibrary;	Deprecated
medialibrary	function getFileAssets(options: MediaFetchOptions, callback: AsyncCallback<FetchFileResult>): void	Deprecated
medialibrary	function getFileAssets(options: MediaFetchOptions): Promise<FetchFileResult>	Deprecated
medialibrary	function on(type: ‘deviceChange’\|‘albumChange’\|‘imageChange’\|‘audioChange’\|‘videoChange’\|‘fileChange’\|‘remoteFileChange’, callback: Callback<void>): void	Deprecated
medialibrary	function off(type: ‘deviceChange’\|‘albumChange’\|‘imageChange’\|‘audioChange’\|‘videoChange’\|‘fileChange’\|‘remoteFileChange’, callback?: Callback<void>): void	Deprecated
medialibrary	function createAsset(mediaType: MediaType, displayName: string, relativePath: string, callback: AsyncCallback<FileAsset>): void	Deprecated
medialibrary	function createAsset(mediaType: MediaType, displayName: string, relativePath: string): Promise<FileAsset>	Deprecated
medialibrary	function deleteAsset(uri: string): Promise<void>	Deprecated
medialibrary	function deleteAsset(uri: string, callback: AsyncCallback<void>): void	Deprecated
medialibrary	function getPublicDirectory(type: DirectoryType, callback: AsyncCallback<string>): void	Deprecated
medialibrary	function getPublicDirectory(type: DirectoryType): Promise<string>	Deprecated
medialibrary	function getAlbums(options: MediaFetchOptions, callback: AsyncCallback<Array<Album>>): void	Deprecated
medialibrary	function getAlbums(options: MediaFetchOptions): Promise<Array<Album>>	Deprecated
medialibrary	function release(callback: AsyncCallback<void>): void	Deprecated
medialibrary	function release(): Promise<void>	Deprecated
medialibrary	function storeMediaAsset(option: MediaAssetOption, callback: AsyncCallback<string>): void	Deprecated
medialibrary	function storeMediaAsset(option: MediaAssetOption): Promise<string>	Deprecated
medialibrary	function startImagePreview(images: Array<string>, index: number, callback: AsyncCallback<void>): void	Deprecated
medialibrary	function startImagePreview(images: Array<string>, callback: AsyncCallback<void>): void	Deprecated
medialibrary	function startImagePreview(images: Array<string>, index?: number): Promise<void>	Deprecated
medialibrary	function startMediaSelect(option: MediaSelectOption, callback: AsyncCallback<Array<string>>): void	Deprecated
medialibrary	function startMediaSelect(option: MediaSelectOption): Promise<Array<string>>	Deprecated
medialibrary	function getActivePeers(): Promise<Array<PeerInfo>>;	Deprecated
medialibrary	function getActivePeers(callback: AsyncCallback<Array<PeerInfo>>): void;	Deprecated
medialibrary	function getAllPeers(): Promise<Array<PeerInfo>>;	Deprecated
medialibrary	function FileAsset.isDirectory(callback: AsyncCallback<boolean>): void	Deprecated
medialibrary	function FileAsset.isDirectory():Promise<boolean>	Deprecated
medialibrary	function FileAsset.commitModify(callback: AsyncCallback<void>): void	Deprecated
medialibrary	function FileAsset.commitModify(): Promise<void>	Deprecated
medialibrary	function FileAsset.open(mode: string, callback: AsyncCallback<number>): void	Deprecated
medialibrary	function FileAsset.open(mode: string): Promise<number>	Deprecated
medialibrary	function FileAsset.close(fd: number, callback: AsyncCallback<void>): void	Deprecated
medialibrary	function FileAsset.close(fd: number): Promise<void>	Deprecated
medialibrary	function FileAsset.getThumbnail(callback: AsyncCallback<image.PixelMap>): void	Deprecated
medialibrary	function FileAsset.getThumbnail(size: Size, callback: AsyncCallback<image.PixelMap>): void	Deprecated
medialibrary	function FileAsset.getThumbnail(size?: Size): Promise<image.PixelMap>	Deprecated
medialibrary	function FileAsset.favorite(isFavorite: boolean, callback: AsyncCallback<void>): void	Deprecated
medialibrary	function FileAsset.favorite(isFavorite: boolean): Promise<void>	Deprecated
medialibrary	function FileAsset.isFavorite(callback: AsyncCallback<boolean>): void	Deprecated
medialibrary	function FileAsset.isFavorite():Promise<boolean>	Deprecated
medialibrary	function FileAsset.trash(isTrash: boolean, callback: AsyncCallback<void>): void	Deprecated
medialibrary	function FileAsset.trash(isTrash: boolean): Promise<void>	Deprecated
medialibrary	function FileAsset.isTrash(callback: AsyncCallback<boolean>): void	Deprecated
medialibrary	function FileAsset.isTrash():Promise<boolean>	Deprecated
medialibrary	function FetchFileResult.getCount(): number	Deprecated
medialibrary	function FetchFileResult.isAfterLast(): boolean	Deprecated
medialibrary	function FetchFileResult.close(): void	Deprecated
medialibrary	function FetchFileResult.getFirstObject(callback: AsyncCallback<FileAsset>): void	Deprecated
medialibrary	function FetchFileResult.getFirstObject(): Promise<FileAsset>	Deprecated
medialibrary	function FetchFileResult.getNextObject(callback: AsyncCallback<FileAsset>): void	Deprecated
medialibrary	function FetchFileResult.getNextObject(): Promise<FileAsset>	Deprecated
medialibrary	function FetchFileResult.getLastObject(callback: AsyncCallback<FileAsset>): void	Deprecated
medialibrary	function FetchFileResult.getLastObject(): Promise<FileAsset>	Deprecated
medialibrary	function FetchFileResult.getPositionObject(index: number, callback: AsyncCallback<FileAsset>): void	Deprecated
medialibrary	function FetchFileResult.getPositionObject(index: number): Promise<FileAsset>	Deprecated
medialibrary	function FetchFileResult.getAllObject(callback: AsyncCallback<Array<FileAsset>>): void	Deprecated
medialibrary	function FetchFileResult.getAllObject(): Promise<Array<FileAsset>>	Deprecated
medialibrary	function Album.commitModify(callback: AsyncCallback<void>): void	Deprecated
medialibrary	function Album.commitModify(): Promise<void>	Deprecated
medialibrary	function Album.getFileAssets(options: MediaFetchOptions, callback: AsyncCallback<FetchFileResult>): void	Deprecated
medialibrary	function Album.getFileAssets(options?: MediaFetchOptions): Promise<FetchFileResult>	Deprecated
medialibrary	enum DeviceType	Deprecated
medialibrary	enum FileKey	Deprecated
medialibrary	enum DirectoryType	Deprecated
medialibrary	enum MediaType	Deprecated
medialibrary	interface PeerInfo	Deprecated
medialibrary	interface Size	Deprecated
medialibrary	interface MediaFetchOptions	Deprecated
medialibrary	interface MediaAssetOption	Deprecated
medialibrary	interface MediaSelectOption	Deprecated
medialibrary	interface FileAsset	Deprecated

Adaptation Guide

For example, refer to the code snippet below to call an API to select an image:

import picker from '@ohos.file.picker';

async function example() {
    try {  
        let PhotoSelectOptions = new picker.PhotoSelectOptions();
        PhotoSelectOptions.MIMEType = picker.PhotoViewMIMETypes.IMAGE_TYPE;
        PhotoSelectOptions.maxSelectNumber = 1;
        let photoPicker = new picker.PhotoViewPicker();
        photoPicker.select(PhotoSelectOptions).then((PhotoSelectResult) => {
            if (PhotoSelectResult !== undefined) {
                console.info("PhotoViewPicker.select pass, PhotoSelectResult uri: " + JSON.stringify(PhotoSelectResult));
            } else {
                console.error("PhotoViewPicker.select PhotoSelectResult is undefined");
            }
        }).catch((err) => {
            console.error("PhotoViewPicker.select fail, err: " + err);
        });
    } catch (err) {
        console.error("PhotoViewPicker fail, err: " + err);
    }
}