保存用户文件

在从网络下载文件到本地、或将已有用户文件另存为新的文件路径等场景下，需要使用FilePicker提供的保存用户文件的能力。

对音频、图片、视频、文档类文件的保存操作类似，均通过调用对应picker的save()接口并传入对应的saveOptions来实现。通过Picker访问相关文件，无需申请权限。

当前所有picker的save接口都是用户可感知的，具体行为是拉起FilePicker, 将文件保存在系统文件管理器管理的特定目录，与图库管理的资源隔离，无法在图库中看到。

如需要在图库中看到所保存的图片、视频资源，请使用用户无感的安全控件创建媒体资源。

保存图片或视频类文件

本例展示了从图库中选择一张图片，保存到文件管理器的示例代码。

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

调用select()接口从设备中选择一张图片，并用一个全局变量存储返回的uri。

import photoAccessHelper from '@ohos.file.photoAccessHelper';
import { BusinessError } from '@ohos.base';

let selectUris: Array<string> = [];
try {
   let PhotoSelectOptions = new photoAccessHelper.PhotoSelectOptions();
   PhotoSelectOptions.MIMEType = photoAccessHelper.PhotoViewMIMETypes.IMAGE_TYPE;
   PhotoSelectOptions.maxSelectNumber = 1;
   let photoPicker = new photoAccessHelper.PhotoViewPicker();
   photoPicker.select(PhotoSelectOptions).then((PhotoSelectResult: photoAccessHelper.PhotoSelectResult) => {
      selectUris = PhotoSelectResult.photoUris;
      console.info('PhotoViewPicker.select successfully, PhotoSelectResult uri: ' + JSON.stringify(PhotoSelectResult));
   }).catch((err: BusinessError) => {
      console.error(`PhotoViewPicker.select failed with err: ${err.code}, ${err.message}`);
   });
} catch (error) {
   let err: BusinessError = error as BusinessError;
   console.error(`PhotoViewPicker failed with err: ${err.code}, ${err.message}`);
}

调用save()接口拉起FilePicker界面进行文件保存。用户选择目标文件夹，用户选择与文件类型相对应的文件夹，即可完成文件保存操作。保存成功后，并用一个全局变量存储返回的uri。

save返回的uri权限是读写权限，可以根据结果集里面的uri进行文件读写等操作。

import picker from '@ohos.file.picker';
import { BusinessError } from '@ohos.base';

let saveUris: Array<string> = [];
try {
    const photoSaveOptions = new picker.PhotoSaveOptions(); // 创建文件管理器保存选项实例
    photoSaveOptions.newFileNames = ["PhotoViewPicker01.png"]; // 保存文件名（可选），方括号里的文件名自定义，每次不能重复，设备里已有这个文件的话，名字就需要改个不一样的，不然接口会报错
    const photoViewPicker = new picker.PhotoViewPicker();
    try {
        let photoSaveResult = await photoViewPicker.save(photoSaveOptions);
        if (photoSaveResult != undefined) {
            saveUris = photoSaveResult;
            console.info('photoViewPicker.save to file succeed and uris are:' + photoSaveResult);
        }
    } catch (error) {
        let err: BusinessError = error as BusinessError;
        console.error(`[picker] Invoke photoViewPicker.save failed, code is ${err.code}, message is ${err.message}`);
    }
} catch (error) {
    let err: BusinessError = error as BusinessError;
    console.info("[picker] photoViewPickerSave error = " + JSON.stringify(err));
}

使用fs.openSync接口，通过选择和保存uri打开这两个文件得到fd，这里需要注意接口权限参数分别是fs.OpenMode.READ_ONLY和fs.OpenMode.WRITE_ONLY。再调用fs.copyFileSync接口进行复制，修改完成后关闭两个文件。

import fs from '@ohos.file.fs';
import { BusinessError } from '@ohos.base';

try {
	let photoSelect = fs.openSync(selectUris[0], fs.OpenMode.READ_ONLY);
    let photoSave = fs.openSync(saveUris[0], fs.OpenMode.WRITE_ONLY);
    fs.copyFileSync(photoSelect.fd, photoSave.fd);
    fs.close(photoSelect);
    fs.close(photoSave);
} catch (error) {
    let err: BusinessError = error as BusinessError;
    console.info("[picker] Photo Save error = " + JSON.stringify(err));
}

保存文档类文件

导入选择器模块和文件管理模块。

import picker from '@ohos.file.picker';
import fs from '@ohos.file.fs';
import { BusinessError } from '@ohos.base';

创建文档保存选项实例。

const documentSaveOptions = new picker.DocumentSaveOptions(); // 创建文件管理器选项实例
documentSaveOptions.newFileNames = ["DocumentViewPicker01.txt"]; // 保存文件名（可选）
documentSaveOptions.fileSuffixChoices = ['.png', '.txt', '.mp4']; // 保存文件类型（可选）

创建文档选择器实例。调用save()接口拉起FilePicker界面进行文件保存。用户选择目标文件夹，用户选择与文件类型相对应的文件夹，即可完成文件保存操作。保存成功后，返回保存文档的uri。

save返回的uri权限是读写权限，可以根据结果集中uri进行文件读写等操作。注意不能在picker的回调里直接使用此uri进行打开文件操作，需要定义一个全局变量保存uri，使用类似一个按钮去触发打开文件。

import { BusinessError } from '@ohos.base';

let uris: Array<string> = [];
const documentViewPicker = new picker.DocumentViewPicker(); // 创建文件选择器实例
documentViewPicker.save(documentSaveOptions).then((documentSaveResult: Array<string>) => {
  uris = documentSaveResult;
  console.info('documentViewPicker.save to file succeed and uris are:' + uris);
}).catch((err: BusinessError) => {
  console.error(`Invoke documentViewPicker.save failed, code is ${err.code}, message is ${err.message}`);
})

待界面从FilePicker返回后，再通过类似一个按钮调用其他函数，使用fs.openSync接口，通过uri打开这个文件得到fd。这里需要注意接口权限参数是fs.OpenMode.READ_WRITE。
```
import fs from '@ohos.file.fs';

const uri = '';
let file = fs.openSync(uri, fs.OpenMode.READ_WRITE);
console.info('file fd: ' + file.fd);
```

通过fd使用fs.writeSync接口对这个文件进行编辑修改，编辑修改完成后关闭fd。

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

let writeLen: number = fs.writeSync(file.fd, 'hello, world');
console.info('write data to file succeed and size is:' + writeLen);
fs.closeSync(file);

保存音频类文件

导入选择器模块和文件管理模块。

import picker from '@ohos.file.picker';
import fs from '@ohos.file.fs';
import { BusinessError } from '@ohos.base';

创建音频保存选项实例。

const audioSaveOptions = new picker.AudioSaveOptions(); // 创建文件管理器选项实例
audioSaveOptions.newFileNames = ['AudioViewPicker01.mp3']; // 保存文件名（可选）

创建音频选择器实例。调用save()接口拉起FilePicker界面进行文件保存。用户选择目标文件夹，用户选择与文件类型相对应的文件夹，即可完成文件保存操作。保存成功后，返回保存文档的uri。

save返回的uri权限是读写权限，可以根据结果集中uri进行文件读写等操作。注意不能在picker的回调里直接使用此uri进行打开文件操作，需要定义一个全局变量保存uri，使用类似一个按钮去触发打开文件。
```
let uri: string = '';
const audioViewPicker = new picker.AudioViewPicker();
audioViewPicker.save(audioSaveOptions).then((audioSelectResult: Array<string>) => {
  uri = audioSelectResult[0];
  console.info('audioViewPicker.save to file succeed and uri is:' + uri);
}).catch((err: BusinessError) => {
  console.error(`Invoke audioViewPicker.save failed, code is ${err.code}, message is ${err.message}`);
})
```
待界面从FilePicker返回后，再通过类似一个按钮调用其他函数，使用fs.openSync接口，通过uri打开这个文件得到fd。这里需要注意接口权限参数是fs.OpenMode.READ_WRITE。
```
let file = fs.openSync(uri, fs.OpenMode.READ_WRITE);
console.info('file fd: ' + file.fd);
```

通过fd使用fs.writeSync接口对这个文件进行编辑修改，编辑修改完成后关闭fd。

let writeLen = fs.writeSync(file.fd, 'hello, world');
console.info('write data to file succeed and size is:' + writeLen);
fs.closeSync(file);