Developing a FileManager Application (Available Only for System Applications)

OpenHarmony is prebuilt with the FileManager application. You can also develop your own FileManager as required.

Available APIs

For details about the APIs, see User File Access and Management.

How to Develop

Configure the permissions required and import dependent modules. Apply for the ohos.permission.FILE_ACCESS_MANAGER and ohos.permission.GET_BUNDLE_INFO_PRIVILEGED permissions. For details, see Applying for Permissions.

NOTE

ohos.permission.FILE_ACCESS_MANAGER is required for using the user file access framework APIs.

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED is required for querying information about file management server applications supported by the system.
Import the dependent modules.
```
import fileAccess from '@ohos.file.fileAccess';
import fileExtensionInfo from '@ohos.file.fileExtensionInfo';
```
The fileAccess module provides APIs for basic file operations, and the fileExtensionInfo module provides key structs for application development.

Query device information. You can obtain attributes of one or all devices managed by the file management server in the current system. You can also filter devices as required.

In the user file access framework, RootInfo indicates the attribute information of a device. For example, obtain RootInfo of all devices.

// Create a helper object for connecting to all file management servers in the system.
let fileAccessHelperAllServer = null;
createFileAccessHelper() {
  try {    // this.context is the context passed from EntryAbility.
    fileAccessHelperAllServer = fileAccess.createFileAccessHelper(this.context);
    if (!fileAccessHelperAllServer) {
      console.error("createFileAccessHelper interface returns an undefined object");
    }
  } catch (error) {    
      console.error("createFileAccessHelper failed, errCode:" + error.code + ", errMessage:" + error.message);
  }
}
async getRoots() {  
  let rootIterator = null;  
  let rootInfos = [];  
  let isDone = false;  
  try {
    rootIterator = await fileAccessHelperAllServer.getRoots();
    if (!rootIterator) {
      console.error("getRoots interface returns an undefined object");
      return;    
    }    
    while (!isDone) {
      let result = rootIterator.next();
      console.info("next result = " + JSON.stringify(result));
      isDone = result.done;
      if (!isDone)
        rootinfos.push(result.value);
    }  
  } catch (error) {
    console.error("getRoots failed, errCode:" + error.code + ", errMessage:" + error.message);
  }
}

View directories. In the user file access framework, FileInfo indicates basic information about a file (directory). You can use listfile() to traverse all files (directories) of the next level to obtain a FileIterator object or use scanfile() to filter the specified directories and obtain the FileIterator object that meets the conditions.

Currently, listfile() and scanfile() can be called by the RootInfo object to traverse lower-level files or filter the entire directory tree. In addition, listfile() and scanfile() can be called by the FileInfo object to traverse lower-level files or filter specified directories.

// Start from the root directory.
let rootInfo = rootinfos[0];
let fileInfos = [];
let isDone = false;
let filter = {suffix: [".txt", ".jpg", ".xlsx"]}; // Set filter criteria.
try {  
  let fileIterator = rootInfo.listFile();          // Traverse the root directory of rootinfos[0] and return an iterator object.
  // let fileIterator = rootInfo.scanFile(filter); // Filter the file information of device rootinfos[0] that meets the specified conditions and return an iteration object.
  if (!fileIterator) {
    console.error("listFile interface returns an undefined object");
    return;  
  }
  while (!isDone) {
    let result = fileIterator.next();
    console.info("next result = " + JSON.stringify(result));
    isDone = result.done;
    if (!isDone)
      fileInfos.push(result.value);
  }
} catch (error) {
  console.error("listFile failed, errCode:" + error.code + ", errMessage:" + error.message);
}

// Start from the specified directory.
let fileInfoDir = fileInfos[0]; // fileInfoDir indicates information about a directory.
let subFileInfos = [];
let isDone = false;
let filter = {suffix: [".txt", ".jpg", ".xlsx"]}; // Set filter criteria.
try {
  let fileIterator = fileInfoDir.listFile(); // Traverse files in the specified directory and return an iterator object.
  // let fileIterator = rootInfo.scanFile(filter); // Filter the files in the specified directory and return an iterator object.
  if (!fileIterator) {
    console.error("listFile interface returns an undefined object");
    return;
  }
  while (!isDone) {
    let result = fileIterator.next();
    console.info("next result = " + JSON.stringify(result));
    isDone = result.done;
    if (!isDone)
      subfileInfos.push(result.value);
  }
} catch (error) {
  console.error("listFile failed, errCode:" + error.code + ", errMessage:" + error.message);
}

Perform operations on files or directories. You can integrate APIs of the user file access framework to implement user behaviors, such as deleting, renaming, creating, and moving a file (directory). The following example shows how to create a file. For details about other APIs, see User File Access and Management.

// The local device is used as an example.
// Create a file.
// sourceUri is the URI in fileinfo of the Download directory.
// You need to use the obtained URI for development.
let sourceUri = "datashare:///media/file/6";
let displayName = "file1";
let fileUri = null;
try {
  // Obtain fileAccessHelper by referring to the sample code of fileAccess.createFileAccessHelper.
  fileUri = await fileAccessHelper.createFile(sourceUri, displayName);
  if (!fileUri) {
    console.error("createFile return undefined object");
    return;
  }
  console.info("createFile sucess, fileUri: " + JSON.stringify(fileUri));
} catch (error) {
  console.error("createFile failed, errCode:" + error.code + ", errMessage:" + error.message);
};