Skip to content

D
Docs

OpenHarmony / Docs
1 年多 前同步成功

通知 159
Star 292
Fork 28
D
Docs
未验证 提交 60468cde 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!24065 [翻译完成】#I7XILM 

Merge pull request !24065 from Annie_wang/PR23573
上级 d7da7907 bef08fae
展开全部 隐藏空白更改
内联 并排
Showing with 583 addition and 449 deletion
en/application-dev/file-management/app-file-access.md
浏览文件 @ 60468cde
...@@ -36,7 +36,7 @@ You can use [ohos.file.fs](../reference/apis/js-apis-file-fs.md) to implement ac ...@@ -36,7 +36,7 @@ You can use [ohos.file.fs](../reference/apis/js-apis-file-fs.md) to implement ac
First, obtain the [application file path](../application-models/application-context-stage.md#obtaining-application-file-paths). The following example shows how to obtain a HAP file path using **UIAbilityContext**. For details about how to obtain **UIAbilityContext**, see [Obtaining the Context of UIAbility](../application-models/uiability-usage.md#obtaining-the-context-of-uiability). First, obtain the [application file path](../application-models/application-context-stage.md#obtaining-application-file-paths). The following example shows how to obtain a HAP file path using **UIAbilityContext**. For details about how to obtain **UIAbilityContext**, see [Obtaining the Context of UIAbility](../application-models/uiability-usage.md#obtaining-the-context-of-uiability).
Then, perform common file operations. Then, perform file operations.
### Creating, Reading, and Writing a File ### Creating, Reading, and Writing a File
...@@ -46,21 +46,29 @@ The following example demonstrates how to create a file, read data from it, and ...@@ -46,21 +46,29 @@ The following example demonstrates how to create a file, read data from it, and
// pages/xxx.ets // pages/xxx.ets
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
import buffer from '@ohos.buffer';
function createFile() { // Obtain the application file path.
// Obtain the application file path. let context = getContext(this) as common.UIAbilityContext;
let context = getContext(this) as common.UIAbilityContext; let filesDir = context.filesDir;
let filesDir = context.filesDir;
// Create a file and open it. function createFile() {
// Create a file and open it.
let file = fs.openSync(filesDir + '/test.txt', fs.OpenMode.READ_WRITE | fs.OpenMode.CREATE); let file = fs.openSync(filesDir + '/test.txt', fs.OpenMode.READ_WRITE | fs.OpenMode.CREATE);
// Write data to the file. // Write data to the file.
let writeLen = fs.writeSync(file.fd, "Try to write str."); let writeLen = fs.writeSync(file.fd, "Try to write str.");
console.info("The length of str is: " + writeLen); console.info("The length of str is: " + writeLen);
// Read data from the file. // Read data from the file.
let buf = new ArrayBuffer(1024); let arrayBuffer = new ArrayBuffer(1024);
let readLen = fs.readSync(file.fd, buf, { offset: 0 }); class Option {
console.info("the content of file: " + String.fromCharCode.apply(null, new Uint8Array(buf.slice(0, readLen)))); public offset: number = 0;
public length: number;
}
let option = new Option();
option.length = arrayBuffer.byteLength;
let readLen = fs.readSync(file.fd, arrayBuffer, option);
let buf = buffer.from(arrayBuffer, 0, readLen);
console.info("the content of file: " + buf.toString());
// Close the file. // Close the file.
fs.closeSync(file); fs.closeSync(file);
} }
...@@ -75,11 +83,11 @@ function createFile() { ...@@ -75,11 +83,11 @@ function createFile() {
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
function readWriteFile() { // Obtain the application file path.
// Obtain the application file path. let context = getContext(this) as common.UIAbilityContext;
let context = getContext(this) as common.UIAbilityContext; let filesDir = context.filesDir;
let filesDir = context.filesDir;
function readWriteFile() {
// Open the source and destination files. // Open the source and destination files.
let srcFile = fs.openSync(filesDir + '/test.txt', fs.OpenMode.READ_WRITE); let srcFile = fs.openSync(filesDir + '/test.txt', fs.OpenMode.READ_WRITE);
let destFile = fs.openSync(filesDir + '/destFile.txt', fs.OpenMode.READ_WRITE | fs.OpenMode.CREATE); let destFile = fs.openSync(filesDir + '/destFile.txt', fs.OpenMode.READ_WRITE | fs.OpenMode.CREATE);
...@@ -87,11 +95,18 @@ function readWriteFile() { ...@@ -87,11 +95,18 @@ function readWriteFile() {
let bufSize = 4096; let bufSize = 4096;
let readSize = 0; let readSize = 0;
let buf = new ArrayBuffer(bufSize); let buf = new ArrayBuffer(bufSize);
let readLen = fs.readSync(srcFile.fd, buf, { offset: readSize }); class Option {
public offset: number = 0;
public length: number = bufSize;
}
let option = new Option();
option.offset = readSize;
let readLen = fs.readSync(srcFile.fd, buf, option);
while (readLen > 0) { while (readLen > 0) {
readSize += readLen; readSize += readLen;
fs.writeSync(destFile.fd, buf); fs.writeSync(destFile.fd, buf);
readLen = fs.readSync(srcFile.fd, buf, { offset: readSize }); option.offset = readSize;
readLen = fs.readSync(srcFile.fd, buf, option);
} }
// Close the files. // Close the files.
fs.closeSync(srcFile); fs.closeSync(srcFile);
...@@ -112,11 +127,11 @@ The following example demonstrates how to read and write file data using a strea ...@@ -112,11 +127,11 @@ The following example demonstrates how to read and write file data using a strea
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
async function readWriteFileWithStream() { // Obtain the application file path.
// Obtain the application file path. let context = getContext(this) as common.UIAbilityContext;
let context = getContext(this) as common.UIAbilityContext; let filesDir = context.filesDir;
let filesDir = context.filesDir;
async function readWriteFileWithStream() {
// Open the file streams. // Open the file streams.
let inputStream = fs.createStreamSync(filesDir + '/test.txt', 'r+'); let inputStream = fs.createStreamSync(filesDir + '/test.txt', 'r+');
let outputStream = fs.createStreamSync(filesDir + '/destFile.txt', "w+"); let outputStream = fs.createStreamSync(filesDir + '/destFile.txt', "w+");
...@@ -124,11 +139,18 @@ async function readWriteFileWithStream() { ...@@ -124,11 +139,18 @@ async function readWriteFileWithStream() {
let bufSize = 4096; let bufSize = 4096;
let readSize = 0; let readSize = 0;
let buf = new ArrayBuffer(bufSize); let buf = new ArrayBuffer(bufSize);
let readLen = await inputStream.read(buf, { offset: readSize }); class Option {
public offset: number = 0;
public length: number = bufSize;
}
let option = new Option();
option.offset = readSize;
let readLen = await inputStream.read(buf, option);
readSize += readLen; readSize += readLen;
while (readLen > 0) { while (readLen > 0) {
await outputStream.write(buf); await outputStream.write(buf);
readLen = await inputStream.read(buf, { offset: readSize }); option.offset = readSize;
readLen = await inputStream.read(buf, option);
readSize += readLen; readSize += readLen;
} }
// Close the streams. // Close the streams.
...@@ -148,8 +170,7 @@ async function readWriteFileWithStream() { ...@@ -148,8 +170,7 @@ async function readWriteFileWithStream() {
The following example demonstrates how to list files that meet the specified conditions. The following example demonstrates how to list files that meet the specified conditions.
```ts ```ts
// List files. import fs, { Filter } from '@ohos.file.fs';
import fs from '@ohos.file.fs';
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
// Obtain the application file path. // Obtain the application file path.
...@@ -157,18 +178,20 @@ let context = getContext(this) as common.UIAbilityContext; ...@@ -157,18 +178,20 @@ let context = getContext(this) as common.UIAbilityContext;
let filesDir = context.filesDir; let filesDir = context.filesDir;
// List files that meet the specified conditions. // List files that meet the specified conditions.
let options = { function getListFile() {
recursion: false, class ListFileOption {
listNum: 0, public recursion: boolean = false;
filter: { public listNum: number = 0;
suffix: ['.png', '.jpg', '.txt'], // The filename extension can be '.png', '.jpg', or '.txt'. public filter: Filter
displayName: ['test%'], // The filename starts with 'test'. }
fileSizeOver: 0, // The file size is greater than or equal to 0. let option = new ListFileOption();
lastModifiedAfter: new Date(0).getTime(), // The latest modification time of the file is later than January 1, 1970. option.filter.suffix = ['.png', '.jpg', '.txt']; // The file name extension can be '.png', '.jpg', or '.txt'.
}, option.filter.displayName = ['test%']; // The file name starts with 'test'.
} option.filter.fileSizeOver = 0; // The file size is greater than or equal to 0.
let files = fs.listFileSync(filesDir, options); option.filter.lastModifiedAfter = new Date(0).getTime(); // The latest modification time of the file is later than January 1, 1970.
for (let i = 0; i < files.length; i++) { let files = fs.listFileSync(filesDir, option);
console.info(`The name of file: ${files[i]}`); for (let i = 0; i < files.length; i++) {
console.info(`The name of file: ${files[i]}`);
}
} }
``` ```
en/application-dev/file-management/app-file-backup.md
浏览文件 @ 60468cde
...@@ -32,17 +32,25 @@ The capability file of an application contains the device type, device version, ...@@ -32,17 +32,25 @@ The capability file of an application contains the device type, device version,
Use **backup.getLocalCapabilities()** to obtain capability files. Use **backup.getLocalCapabilities()** to obtain capability files.
```js ```ts
import backup from '@ohos.file.backup';
import common from '@ohos.app.ability.common';
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
// Obtain the application file path.
let context = getContext(this) as common.UIAbilityContext;
let filesDir = context.filesDir;
async function getLocalCapabilities() { async function getLocalCapabilities() {
try { try {
let fileData = await backup.getLocalCapabilities(); let fileData = await backup.getLocalCapabilities();
console.info('getLocalCapabilities success'); console.info('getLocalCapabilities success');
let fpath = await globalThis.context.filesDir + '/localCapabilities.json'; let fpath = filesDir + '/localCapabilities.json';
fs.copyFileSync(fileData.fd, fpath); fs.copyFileSync(fileData.fd, fpath);
fs.closeSync(fileData.fd); fs.closeSync(fileData.fd);
} catch (err) { } catch (error) {
console.error('getLocalCapabilities failed with err: ' + err); let err: BusinessError = error as BusinessError;
console.error('getLocalCapabilities failed with err: ' + JSON.stringify(err));
} }
} }
``` ```
...@@ -88,17 +96,24 @@ You can save the file to a local directory as required. ...@@ -88,17 +96,24 @@ You can save the file to a local directory as required.
**Example** **Example**
```ts ```ts
import backup from '@ohos.file.backup';
import common from '@ohos.app.ability.common';
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
import { BusinessError } from '@ohos.base';
// Obtain the sandbox path.
let context = getContext(this) as common.UIAbilityContext;
let filesDir = context.filesDir;
// Create a SessionBackup instance for data backup. // Create a SessionBackup instance for data backup.
let g_session; let g_session: backup.SessionBackup;
function createSessionBackup() { function createSessionBackup() {
let sessionBackup = new backup.SessionBackup({ let generalCallbacks: backup.GeneralCallbacks = {
onFileReady: async (err, file) => { onFileReady: (err: BusinessError, file: backup.File) => {
if (err) { if (err) {
console.info('onFileReady err: ' + err); console.info('onFileReady err: ' + JSON.stringify(err));
} }
try { try {
let bundlePath = await globalThis.context.filesDir + '/' + file.bundleName; let bundlePath = filesDir + '/' + file.bundleName;
if (!fs.accessSync(bundlePath)) { if (!fs.accessSync(bundlePath)) {
fs.mkdirSync(bundlePath); fs.mkdirSync(bundlePath);
} }
...@@ -109,23 +124,23 @@ You can save the file to a local directory as required. ...@@ -109,23 +124,23 @@ You can save the file to a local directory as required.
console.error('onFileReady failed with err: ' + e); console.error('onFileReady failed with err: ' + e);
} }
}, },
onBundleBegin: (err, bundleName) => { onBundleBegin: (err: BusinessError, bundleName: string) => {
if (err) { if (err) {
console.info('onBundleBegin err: ' + err); console.info('onBundleBegin err: ' + JSON.stringify(err));
} else { } else {
console.info('onBundleBegin bundleName: ' + bundleName); console.info('onBundleBegin bundleName: ' + bundleName);
} }
}, },
onBundleEnd: (err, bundleName) => { onBundleEnd: (err: BusinessError, bundleName: string) => {
if (err) { if (err) {
console.info('onBundleEnd err: ' + err); console.info('onBundleEnd err: ' + JSON.stringify(err));
} else { } else {
console.info('onBundleEnd bundleName: ' + bundleName); console.info('onBundleEnd bundleName: ' + bundleName);
} }
}, },
onAllBundlesEnd: (err) => { onAllBundlesEnd: (err: BusinessError) => {
if (err) { if (err) {
console.info('onAllBundlesEnd err: ' + err); console.info('onAllBundlesEnd err: ' + JSON.stringify(err));
} else { } else {
console.info('onAllBundlesEnd'); console.info('onAllBundlesEnd');
} }
...@@ -133,16 +148,16 @@ You can save the file to a local directory as required. ...@@ -133,16 +148,16 @@ You can save the file to a local directory as required.
onBackupServiceDied: () => { onBackupServiceDied: () => {
console.info('onBackupServiceDied'); console.info('onBackupServiceDied');
}, },
}); }
let sessionBackup = new backup.SessionBackup(generalCallbacks);
return sessionBackup; return sessionBackup;
} }
async function sessionBackup () async function sessionBackup () {
{
g_session = createSessionBackup(); g_session = createSessionBackup();
// Select the application to be backed up based on the capability file obtained by backup.getLocalCapabilities(). // Select the application to be backed up based on the capability file obtained by backup.getLocalCapabilities().
// You can also back up data based on the application bundle name. // You can also back up data based on the application bundle name.
const backupApps = [ const backupApps: string[] = [
"com.example.hiworld", "com.example.hiworld",
] ]
await g_session.appendBundles(backupApps); await g_session.appendBundles(backupApps);
...@@ -161,24 +176,26 @@ When all the data of the application is ready, the service starts to restore the ...@@ -161,24 +176,26 @@ When all the data of the application is ready, the service starts to restore the
**Example** **Example**
```ts ```ts
import backup from '@ohos.file.backup';
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
import { BusinessError } from '@ohos.base';
// Create a SessionRestore instance for data restoration. // Create a SessionRestore instance for data restoration.
let g_session; let g_session: backup.SessionRestore;
async function publishFile(file) async function publishFile(file: backup.File) {
{ let fileMeta: backup.FileMeta = {
await g_session.publishFile({
bundleName: file.bundleName, bundleName: file.bundleName,
uri: file.uri uri: file.uri
}); }
await g_session.publishFile(fileMeta);
} }
function createSessionRestore() { function createSessionRestore() {
let sessionRestore = new backup.SessionRestore({ let generalCallbacks: backup.GeneralCallbacks = {
onFileReady: (err, file) => { onFileReady: (err: BusinessError, file: backup.File) => {
if (err) { if (err) {
console.info('onFileReady err: ' + err); console.info('onFileReady err: ' + JSON.stringify(err));
} }
// Set bundlePath based on the actual situation. // Set bundlePath based on the actual situation.
let bundlePath; let bundlePath: string;
if (!fs.accessSync(bundlePath)) { if (!fs.accessSync(bundlePath)) {
console.info('onFileReady bundlePath err : ' + bundlePath); console.info('onFileReady bundlePath err : ' + bundlePath);
} }
...@@ -188,52 +205,51 @@ When all the data of the application is ready, the service starts to restore the ...@@ -188,52 +205,51 @@ When all the data of the application is ready, the service starts to restore the
publishFile(file); publishFile(file);
console.info('onFileReady success'); console.info('onFileReady success');
}, },
onBundleBegin: (err, bundleName) => { onBundleBegin: (err: BusinessError, bundleName: string) => {
if (err) { if (err) {
console.error('onBundleBegin failed with err: ' + err); console.error('onBundleBegin failed with err: ' + JSON.stringify(err));
} }
console.info('onBundleBegin success'); console.info('onBundleBegin success');
}, },
onBundleEnd: (err, bundleName) => { onBundleEnd: (err: BusinessError, bundleName: string) => {
if (err) { if (err) {
console.error('onBundleEnd failed with err: ' + err); console.error('onBundleEnd failed with err: ' + JSON.stringify(err));
} }
console.info('onBundleEnd success'); console.info('onBundleEnd success');
}, },
onAllBundlesEnd: (err) => { onAllBundlesEnd: (err: BusinessError) => {
if (err) { if (err) {
console.error('onAllBundlesEnd failed with err: ' + err); console.error('onAllBundlesEnd failed with err: ' + JSON.stringify(err));
} }
console.info('onAllBundlesEnd success'); console.info('onAllBundlesEnd success');
}, },
onBackupServiceDied: () => { onBackupServiceDied: () => {
console.info('service died'); console.info('service died');
} }
}); }
let sessionRestore = new backup.SessionRestore(generalCallbacks);
return sessionRestore; return sessionRestore;
} }
async function restore () async function restore01 () {
{
g_session = createSessionRestore(); g_session = createSessionRestore();
const backupApps = [ const restoreApps: string[] = [
"com.example.hiworld", "com.example.hiworld",
] ]
// You can obtain the capability file based on actual situation. The following is an example only. // You can obtain the capability file based on actual situation. The following is an example only.
// You can also construct capability files as required. // You can also construct capability files as required.
let fileData = await backup.getLocalCapabilities(); let fileData = await backup.getLocalCapabilities();
await g_session.appendBundles(fileData.fd, backupApps); await g_session.appendBundles(fileData.fd, restoreApps);
console.info('appendBundles success'); console.info('appendBundles success');
// After the applications to be restored are added, call getFileHandle() to obtain the handles of the application files to be restored based on the application name. // After the applications to be restored are added, call getFileHandle() to obtain the handles of the application files to be restored based on the application name.
// The number of application data files to be restored varies depending on the number of backup files. The following is only an example. // The number of application data files to be restored varies depending on the number of backup files. The following is only an example.
await g_session.getFileHandle({ let handle: backup.FileMeta = {
bundleName: restoreApps[0], bundleName: restoreApps[0],
uri: "manage.json" uri: "manage.json"
}); }
await g_session.getFileHandle({ await g_session.getFileHandle(handle);
bundleName: restoreApps[0], handle.uri = "1.tar";
uri: "1.tar" await g_session.getFileHandle(handle);
});
console.info('getFileHandle success'); console.info('getFileHandle success');
} }
``` ```
...@@ -249,23 +265,30 @@ If the application has not been installed, you can install the application and t ...@@ -249,23 +265,30 @@ If the application has not been installed, you can install the application and t
**Example** **Example**
```ts ```ts
import backup from '@ohos.file.backup';
import common from '@ohos.app.ability.common';
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
import { BusinessError } from '@ohos.base';
// Obtain the sandbox path.
let context = getContext(this) as common.UIAbilityContext;
let filesDir = context.filesDir;
// Create a SessionRestore instance for data restoration. // Create a SessionRestore instance for data restoration.
let g_session; let g_session: backup.SessionRestore;
async function publishFile(file) async function publishFile(file: backup.File) {
{ let fileMeta: backup.FileMeta = {
await g_session.publishFile({
bundleName: file.bundleName, bundleName: file.bundleName,
uri: file.uri uri: file.uri
}); }
await g_session.publishFile(fileMeta);
} }
function createSessionRestore() { function createSessionRestore() {
let sessionRestore = new backup.SessionRestore({ let generalCallbacks: backup.GeneralCallbacks = {
onFileReady: (err, file) => { onFileReady: (err: BusinessError, file: backup.File) => {
if (err) { if (err) {
console.info('onFileReady err: ' + err); console.info('onFileReady err: ' + JSON.stringify(err));
} }
let bundlePath; let bundlePath: string;
if( file.uri == "/data/storage/el2/restore/bundle.hap" ) if( file.uri == "/data/storage/el2/restore/bundle.hap" )
{ {
// Set the path of the application installation package based on actual situation. // Set the path of the application installation package based on actual situation.
...@@ -281,61 +304,57 @@ If the application has not been installed, you can install the application and t ...@@ -281,61 +304,57 @@ If the application has not been installed, you can install the application and t
publishFile(file); publishFile(file);
console.info('onFileReady success'); console.info('onFileReady success');
}, },
onBundleBegin: (err, bundleName) => { onBundleBegin: (err: BusinessError, bundleName: string) => {
if (err) { if (err) {
console.error('onBundleBegin failed with err: ' + err); console.error('onBundleBegin failed with err: ' + JSON.stringify(err));
} }
console.info('onBundleBegin success'); console.info('onBundleBegin success');
}, },
onBundleEnd: (err, bundleName) => { onBundleEnd: (err: BusinessError, bundleName: string) => {
if (err) { if (err) {
console.error('onBundleEnd failed with err: ' + err); console.error('onBundleEnd failed with err: ' + JSON.stringify(err));
} }
console.info('onBundleEnd success'); console.info('onBundleEnd success');
}, },
onAllBundlesEnd: (err) => { onAllBundlesEnd: (err: BusinessError) => {
if (err) { if (err) {
console.error('onAllBundlesEnd failed with err: ' + err); console.error('onAllBundlesEnd failed with err: ' + JSON.stringify(err));
} }
console.info('onAllBundlesEnd success'); console.info('onAllBundlesEnd success');
}, },
onBackupServiceDied: () => { onBackupServiceDied: () => {
console.info('service died'); console.info('service died');
} }
}); }
let sessionRestore = new backup.SessionRestore(generalCallbacks);
return sessionRestore; return sessionRestore;
} }
async function restore () async function restore02 () {
{
g_session = createSessionRestore(); g_session = createSessionRestore();
const backupApps = [ const restoreApps: string[] = [
"com.example.hiworld", "com.example.hiworld",
] ]
let fpath = await globalThis.context.filesDir + '/localCapabilities.json'; let fpath = filesDir + '/localCapabilities.json';
let file = fs.openSync(fpath, fileIO.OpenMode.CREATE | fileIO.OpenMode.READ_WRITE); let file = fs.openSync(fpath, fs.OpenMode.CREATE | fs.OpenMode.READ_WRITE);
let content = "{\"bundleInfos\" :[{\"allToBackup\" : false,\"extensionName\" : \"\"," + let content = "{\"bundleInfos\" :[{\"allToBackup\" : false,\"extensionName\" : \"\"," +
"\"name\" : \"cn.openharmony.inputmethodchoosedialog\",\"needToInstall\" : true,\"spaceOccupied\" : 0," + "\"name\" : \"cn.openharmony.inputmethodchoosedialog\",\"needToInstall\" : true,\"spaceOccupied\" : 0," +
"\"versionCode\" : 1000000,\"versionName\" : \"1.0.0\"}],\"deviceType\" : \"default\",\"systemFullName\" : \"OpenHarmony-4.0.6.2(Canary1)\"}"; "\"versionCode\" : 1000000,\"versionName\" : \"1.0.0\"}],\"deviceType\" : \"default\",\"systemFullName\" : \"OpenHarmony-4.0.6.2(Canary1)\"}";
fs.writeSync(file.fd, content); fs.writeSync(file.fd, content);
fs.fsyncSync(file.fd); fs.fsyncSync(file.fd);
await g_session.appendBundles(file.fd, backupApps); await g_session.appendBundles(file.fd, restoreApps);
console.info('appendBundles success'); console.info('appendBundles success');
// Obtain the file handle of the application to be installed. // Obtain the file handle of the application to be installed.
await g_session.getFileHandle({ let handle: backup.FileMeta = {
bundleName: restoreApps[0], bundleName: restoreApps[0],
uri: "/data/storage/el2/restore/bundle.hap" uri: "/data/storage/el2/restore/bundle.hap"
}); }
await g_session.getFileHandle(handle);
await g_session.getFileHandle({ handle.uri = "manage.json";
bundleName: restoreApps[0], await g_session.getFileHandle(handle);
uri: "manage.json" handle.uri = "1.tar";
}); await g_session.getFileHandle(handle);
await g_session.getFileHandle({
bundleName: restoreApps[0],
uri: "1.tar"
});
console.info('getFileHandle success'); console.info('getFileHandle success');
} }
``` ```
......
en/application-dev/file-management/app-file-upload-download.md
浏览文件 @ 60468cde
...@@ -19,6 +19,7 @@ The following example demonstrates how to upload a file in the **cache** directo ...@@ -19,6 +19,7 @@ The following example demonstrates how to upload a file in the **cache** directo
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
import request from '@ohos.request'; import request from '@ohos.request';
import { BusinessError } from '@ohos.base';
// Obtain the application file path. // Obtain the application file path.
let context = getContext(this) as common.UIAbilityContext; let context = getContext(this) as common.UIAbilityContext;
...@@ -30,32 +31,36 @@ fs.writeSync(file.fd, 'upload file test'); ...@@ -30,32 +31,36 @@ fs.writeSync(file.fd, 'upload file test');
fs.closeSync(file); fs.closeSync(file);
// Configure the upload task. // Configure the upload task.
let uploadConfig = { let header = new Map<Object, string>();
header.set('key1', 'value1');
header.set('key2', 'value2');
let files: Array<request.File> = [
{ filename: 'test.txt', name: 'test', uri: 'internal://cache/test.txt', type: 'txt' }
]
let data: Array<request.RequestData> = [{ name: 'name', value: 'value' }];
let uploadConfig: request.UploadConfig = {
url: 'https://xxx', url: 'https://xxx',
header: { key1: 'value1', key2: 'value2' }, header: header,
method: 'POST', method: 'POST',
files: [ files: files,
{ filename: 'test.txt', name: 'test', uri: 'internal://cache/test.txt', type: 'txt' } data: data
],
data: [
{ name: 'name', value: 'value' }
]
} }
// Upload the created application file to the network server. // Upload the created application file to the network server.
try { try {
request.uploadFile(context, uploadConfig) request.uploadFile(context, uploadConfig)
.then((uploadTask) => { .then((uploadTask: request.UploadTask) => {
uploadTask.on('complete', (taskStates) => { uploadTask.on('complete', (taskStates: Array<request.TaskState>) => {
for (let i = 0; i < taskStates.length; i++) { for (let i = 0; i < taskStates.length; i++) {
console.info(`upload complete taskState: ${JSON.stringify(taskStates[i])}`); console.info(`upload complete taskState: ${JSON.stringify(taskStates[i])}`);
} }
}); });
}) })
.catch((err) => { .catch((err: BusinessError) => {
console.error(`Invoke uploadFile failed, code is ${err.code}, message is ${err.message}`); console.error(`Invoke uploadFile failed, code is ${err.code}, message is ${err.message}`);
}) })
} catch (err) { } catch (error) {
let err: BusinessError = error as BusinessError;
console.error(`Invoke uploadFile failed, code is ${err.code}, message is ${err.message}`); console.error(`Invoke uploadFile failed, code is ${err.code}, message is ${err.message}`);
} }
``` ```
...@@ -78,6 +83,8 @@ The following example demonstrates how to download a network resource file to a ...@@ -78,6 +83,8 @@ The following example demonstrates how to download a network resource file to a
import common from '@ohos.app.ability.common'; import common from '@ohos.app.ability.common';
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
import request from '@ohos.request'; import request from '@ohos.request';
import { BusinessError } from '@ohos.base';
import buffer from '@ohos.buffer';
// Obtain the application file path. // Obtain the application file path.
let context = getContext(this) as common.UIAbilityContext; let context = getContext(this) as common.UIAbilityContext;
...@@ -87,19 +94,21 @@ try { ...@@ -87,19 +94,21 @@ try {
request.downloadFile(context, { request.downloadFile(context, {
url: 'https://xxxx/xxxx.txt', url: 'https://xxxx/xxxx.txt',
filePath: filesDir + '/xxxx.txt' filePath: filesDir + '/xxxx.txt'
}).then((downloadTask) => { }).then((downloadTask: request.DownloadTask) => {
downloadTask.on('complete', () => { downloadTask.on('complete', () => {
console.info('download complete'); console.info('download complete');
let file = fs.openSync(filesDir + '/xxxx.txt', fs.OpenMode.READ_WRITE); let file = fs.openSync(filesDir + '/xxxx.txt', fs.OpenMode.READ_WRITE);
let buf = new ArrayBuffer(1024); let arrayBuffer = new ArrayBuffer(1024);
let readLen = fs.readSync(file.fd, buf); let readLen = fs.readSync(file.fd, arrayBuffer);
console.info(`The content of file: ${String.fromCharCode.apply(null, new Uint8Array(buf.slice(0, readLen)))}`); let buf = buffer.from(arrayBuffer, 0, readLen);
console.info(`The content of file: ${buf.toString()}`);
fs.closeSync(file); fs.closeSync(file);
}) })
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`Invoke downloadTask failed, code is ${err.code}, message is ${err.message}`); console.error(`Invoke downloadTask failed, code is ${err.code}, message is ${err.message}`);
}); });
} catch (err) { } catch (error) {
let err: BusinessError = error as BusinessError;
console.error(`Invoke downloadFile failed, code is ${err.code}, message is ${err.message}`); console.error(`Invoke downloadFile failed, code is ${err.code}, message is ${err.message}`);
} }
``` ```
en/application-dev/file-management/app-fs-space-statistics.md
浏览文件 @ 60468cde
...@@ -10,13 +10,13 @@ For details about the APIs, see [ohos.file.statvfs](../reference/apis/js-apis-fi ...@@ -10,13 +10,13 @@ For details about the APIs, see [ohos.file.statvfs](../reference/apis/js-apis-fi
| Module| API| Description| | Module| API| Description|
| -------- | -------- | -------- | | -------- | -------- | -------- |
| \@ohos.file.storageStatistics | getCurrentBundleStats | Obtains the storage space of the current application, in bytes.| | \@ohos.file.storageStatistics | getCurrentBundleStats | Obtains the storage space of the current application, in bytes.|
| \@ohos.file.statvfs | getFreeSize | Obtains the free space of a file system, in bytes.| | \@ohos.file.statvfs | getFreeSize | Obtains the free space of a file system, in bytes.|
| \@ohos.file.statvfs | getTotalSize | Obtains the total space of a file system, in bytes.| | \@ohos.file.statvfs | getTotalSize | Obtains the total space of a file system, in bytes.|
**Table 2** Attributes for application space statistics **Table 2** Attributes for application space statistics
| BundleStats Attribute| Description| Directory for Statistics| | BundleStats Attribute| Description| Directory for Statistics|
| -------- | -------- | -------- | | -------- | -------- | -------- |
| appSize | Size of the application installation files, in bytes.| /data/storage/el1/bundle | | appSize | Size of the application installation files, in bytes.| /data/storage/el1/bundle |
| cacheSize | Size of the application cache files, in bytes.| /data/storage/el1/base/cache<br>/data/storage/el1/base/haps/entry/cache<br>/data/storage/el2/base/cache<br>/data/storage/el2/base/haps/entry/cache | | cacheSize | Size of the application cache files, in bytes.| /data/storage/el1/base/cache<br>/data/storage/el1/base/haps/entry/cache<br>/data/storage/el2/base/cache<br>/data/storage/el2/base/haps/entry/cache |
...@@ -25,12 +25,13 @@ For details about the APIs, see [ohos.file.statvfs](../reference/apis/js-apis-fi ...@@ -25,12 +25,13 @@ For details about the APIs, see [ohos.file.statvfs](../reference/apis/js-apis-fi
## Development Example ## Development Example
- Obtain the free space of **/data** of the file system. - Obtain the free space of **/data** of the file system.
```ts ```ts
import statvfs from '@ohos.file.statvfs'; import statvfs from '@ohos.file.statvfs';
import { BusinessError } from '@ohos.base';
let path = "/data"; let path = "/data";
statvfs.getFreeSize(path, (err, number) => { statvfs.getFreeSize(path, (err: BusinessError, number: number) => {
if (err) { if (err) {
console.error(`Invoke getFreeSize failed, code is ${err.code}, message is ${err.message}`); console.error(`Invoke getFreeSize failed, code is ${err.code}, message is ${err.message}`);
} else { } else {
...@@ -40,11 +41,12 @@ For details about the APIs, see [ohos.file.statvfs](../reference/apis/js-apis-fi ...@@ -40,11 +41,12 @@ For details about the APIs, see [ohos.file.statvfs](../reference/apis/js-apis-fi
``` ```
- Obtain the space occupied by the current application. - Obtain the space occupied by the current application.
```ts ```ts
import storageStatistics from "@ohos.file.storageStatistics"; import storageStatistics from "@ohos.file.storageStatistics";
import { BusinessError } from '@ohos.base';
storageStatistics.getCurrentBundleStats((err, bundleStats) => { storageStatistics.getCurrentBundleStats((err: BusinessError, bundleStats: storageStatistics.BundleStats) => {
if (err) { if (err) {
console.error(`Invoke getCurrentBundleStats failed, code is ${err.code}, message is ${err.message}`); console.error(`Invoke getCurrentBundleStats failed, code is ${err.code}, message is ${err.message}`);
} else { } else {
......
en/application-dev/file-management/dev-user-file-manager.md
浏览文件 @ 60468cde
...@@ -8,82 +8,89 @@ For details about the APIs used to develop a file manager application, see [User ...@@ -8,82 +8,89 @@ For details about the APIs used to develop a file manager application, see [User
## How to Develop ## How to Develop
1. Apply for permissions required.<br> 1. Apply for permissions required.
Apply for the **ohos.permission.FILE_ACCESS_MANAGER** and **ohos.permission.GET_BUNDLE_INFO_PRIVILEGED** permissions. For details, see [Applying for Permissions](../security/accesstoken-guidelines.md).
Apply for the **ohos.permission.FILE_ACCESS_MANAGER** and **ohos.permission.GET_BUNDLE_INFO_PRIVILEGED** permissions. For details, see [Applying for Permissions](../security/accesstoken-guidelines.md).
> **NOTE** > **NOTE**
> >
> **ohos.permission.FILE_ACCESS_MANAGER** allows your application to use the user file access framework APIs. > - **ohos.permission.FILE_ACCESS_MANAGER** allows your application to use the user file access framework APIs.
> >- **ohos.permission.GET_BUNDLE_INFO_PRIVILEGED** allows your application to obtain information about file management server applications supported by the system.
> **ohos.permission.GET_BUNDLE_INFO_PRIVILEGED** allows your application to obtain information about file management server applications supported by the system.
2. Import dependent modules. 2. Import dependent modules.
```ts ```ts
import fileAccess from '@ohos.file.fileAccess'; import fileAccess from '@ohos.file.fileAccess';
import fileExtensionInfo from '@ohos.file.fileExtensionInfo'; import fileExtensionInfo from '@ohos.file.fileExtensionInfo';
import { Filter } from '@ohos.file.fs';
import common from '@ohos.app.ability.common';
import { BusinessError } from '@ohos.base';
``` ```
The **fileAccess** module provides APIs for basic file operations, and the **fileExtensionInfo** module provides key structs for application development. The **fileAccess** module provides APIs for basic file operations, and the **fileExtensionInfo** module provides key structs for application development.
3. Query device information.<br> 3. Query device information.
You can obtain attributes of the devices managed by one or all file management servers in the system. You can also filter devices as required. You can obtain attributes of the devices managed by one or all file management servers in the 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. In the user file access framework, **RootInfo** indicates the attribute information of a device. For example, obtain **RootInfo** of all devices.
```ts ```ts
// Obtain the application context.
let context = getContext(this) as common.UIAbilityContext;
// Create a helper object for connecting to all file management servers in the system. // Create a helper object for connecting to all file management servers in the system.
let fileAccessHelperAllServer = null; let fileAccessHelperAllServer: fileAccess.FileAccessHelper;
createFileAccessHelper() { function createFileAccessHelper() {
try { // this.context is the context passed from EntryAbility. try { // this.context is the context passed from EntryAbility.
fileAccessHelperAllServer = fileAccess.createFileAccessHelper(this.context); fileAccessHelperAllServer = fileAccess.createFileAccessHelper(context);
if (!fileAccessHelperAllServer) { if (!fileAccessHelperAllServer) {
console.error("createFileAccessHelper interface returns an undefined object"); console.error("createFileAccessHelper interface returns an undefined object");
} }
} catch (error) { } catch (err) {
let error: BusinessError = err as BusinessError;
console.error("createFileAccessHelper failed, errCode:" + error.code + ", errMessage:" + error.message); console.error("createFileAccessHelper failed, errCode:" + error.code + ", errMessage:" + error.message);
} }
} }
async getRoots() { let rootInfos: Array<fileAccess.RootInfo> = [];
let rootIterator = null; async function getRoots() {
let rootInfos = []; let rootIterator: fileAccess.RootIterator;
let isDone = false; let isDone: boolean = false;
try { try {
rootIterator = await fileAccessHelperAllServer.getRoots(); rootIterator = await fileAccessHelperAllServer.getRoots();
if (!rootIterator) { if (!rootIterator) {
console.error("getRoots interface returns an undefined object"); console.error("getRoots interface returns an undefined object");
return; return;
} }
while (!isDone) { while (!isDone) {
let result = rootIterator.next(); let result = rootIterator.next();
console.info("next result = " + JSON.stringify(result)); console.info("next result = " + JSON.stringify(result));
isDone = result.done; isDone = result.done;
if (!isDone) if (!isDone)
rootinfos.push(result.value); rootInfos.push(result.value);
} }
} catch (error) { } catch (err) {
let error: BusinessError = err as BusinessError;
console.error("getRoots failed, errCode:" + error.code + ", errMessage:" + error.message); console.error("getRoots failed, errCode:" + error.code + ", errMessage:" + error.message);
} }
} }
``` ```
4. View directories. 4. View directories.
In the user file access framework, **FileInfo** indicates basic information about a file (directory). You can use **listfile()** to obtain a **FileIterator** object that traverses all files (directories) of the next level or use **scanfile()** to obtain a **FileIterator** object that meets the specified conditions. In the user file access framework, **FileInfo** indicates basic information about a file (directory). You can use **listfile()** to obtain a **FileIterator** object that traverses all files (directories) of the next level or use **scanfile()** to obtain a **FileIterator** object that meets the specified conditions.
Currently, **listfile()** and **scanfile()** can be called by the **RootInfo** object to traverse the next-level files or filter the entire directory tree. In addition, **listfile()** and **scanfile()** can be called by the **FileInfo** object to traverse the next-level files or filter the specified directories. Currently, **listfile()** and **scanfile()** can be called by the **RootInfo** object to traverse the next-level files or filter the entire directory tree. In addition, **listfile()** and **scanfile()** can be called by the **FileInfo** object to traverse the next-level files or filter the specified directories.
```ts ```ts
// Start from the root directory. // Start from the root directory.
let rootInfo = rootinfos[0]; let rootInfo = rootInfos[0];
let fileInfos = []; let fileInfos: Array<fileAccess.FileInfo> = [];
let isDone = false; let isDone: boolean = false;
let filter = {suffix: [".txt", ".jpg", ".xlsx"]}; // Set filter criteria. let filter: Filter = {suffix : [".txt", ".jpg", ".xlsx"]}; // Set the filter.
try { try {
let fileIterator = rootInfo.listFile(); // Traverse the root directory of rootinfos[0] and return an iterator object. let fileIterator = rootInfo.listFile(); // Traverse the root directory of rootinfos[0] and return an iterator object.
// let fileIterator = rootInfo.scanFile(filter); // Filter device rootinfos[0] files that meet the specified conditions and return an iteration object. // let fileIterator = rootInfo.scanFile(filter); // Filter device rootinfos[0] files that meet the specified conditions and return an iteration object.
if (!fileIterator) { if (!fileIterator) {
console.error("listFile interface returns an undefined object"); console.error("listFile interface returns an undefined object");
return;
} }
while (!isDone) { while (!isDone) {
let result = fileIterator.next(); let result = fileIterator.next();
...@@ -92,35 +99,37 @@ For details about the APIs used to develop a file manager application, see [User ...@@ -92,35 +99,37 @@ For details about the APIs used to develop a file manager application, see [User
if (!isDone) if (!isDone)
fileInfos.push(result.value); fileInfos.push(result.value);
} }
} catch (error) { } catch (err) {
let error: BusinessError = err as BusinessError;
console.error("listFile failed, errCode:" + error.code + ", errMessage:" + error.message); console.error("listFile failed, errCode:" + error.code + ", errMessage:" + error.message);
} }
// Start from the specified directory. // Start from the specified directory.
let fileInfoDir = fileInfos[0]; // fileInfoDir indicates information about a directory. let fileInfoDir = fileInfos[0]; // fileInfoDir indicates information about a directory.
let subFileInfos = []; let subFileInfos: Array<fileAccess.FileInfo> = [];
let isDone = false; let isDone02: boolean = false;
let filter = {suffix: [".txt", ".jpg", ".xlsx"]}; // Set filter criteria. let filter02: Filter = {suffix : [".txt", ".jpg", ".xlsx"]}; // Set the filter.
try { try {
let fileIterator = fileInfoDir.listFile(); // Traverse files in the specified directory and return an iterator object. 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. // let fileIterator = rootInfo.scanFile(filter02); // Filter the files in the specified directory and return an iterator object.
if (!fileIterator) { if (!fileIterator) {
console.error("listFile interface returns an undefined object"); console.error("listFile interface returns an undefined object");
return;
} }
while (!isDone) { while (!isDone02) {
let result = fileIterator.next(); let result = fileIterator.next();
console.info("next result = " + JSON.stringify(result)); console.info("next result = " + JSON.stringify(result));
isDone = result.done; isDone02 = result.done;
if (!isDone) if (!isDone02)
subfileInfos.push(result.value); subFileInfos.push(result.value);
} }
} catch (error) { } catch (err) {
let error: BusinessError = err as BusinessError;
console.error("listFile failed, errCode:" + error.code + ", errMessage:" + error.message); console.error("listFile failed, errCode:" + error.code + ", errMessage:" + error.message);
} }
``` ```
5. Perform operations on files or directories. 5. 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](../reference/apis/js-apis-fileAccess.md). 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](../reference/apis/js-apis-fileAccess.md).
```ts ```ts
...@@ -128,18 +137,20 @@ For details about the APIs used to develop a file manager application, see [User ...@@ -128,18 +137,20 @@ For details about the APIs used to develop a file manager application, see [User
// Create a file. // Create a file.
// sourceUri is the URI in fileinfo of the Download directory. // sourceUri is the URI in fileinfo of the Download directory.
// You need to use the obtained URI for development. // You need to use the obtained URI for development.
let sourceUri = "file://media/file/6"; async function creatFile() {
let displayName = "file1"; let sourceUri: string = "file://docs/storage/Users/currentUser/Download";
let fileUri = null; let displayName: string = "file1";
try { let fileUri: string;
// Obtain fileAccessHelper by referring to the sample code of fileAccess.createFileAccessHelper. try {
fileUri = await fileAccessHelper.createFile(sourceUri, displayName); // Obtain fileAccessHelperAllServer by referring to the sample code of fileAccess.createFileAccessHelper.
if (!fileUri) { fileUri = await fileAccessHelperAllServer.createFile(sourceUri, displayName);
console.error("createFile return undefined object"); if (!fileUri) {
return; console.error("createFile return undefined object");
} }
console.info("createFile sucess, fileUri: " + JSON.stringify(fileUri)); console.info("createFile sucess, fileUri: " + JSON.stringify(fileUri));
} catch (error) { } catch (err) {
console.error("createFile failed, errCode:" + error.code + ", errMessage:" + error.message); let error: BusinessError = err as BusinessError;
}; console.error("createFile failed, errCode:" + error.code + ", errMessage:" + error.message);
};
}
``` ```
en/application-dev/file-management/file-access-across-devices.md
浏览文件 @ 60468cde
...@@ -8,8 +8,7 @@ For example, device A and device B are installed with the same application. Afte ...@@ -8,8 +8,7 @@ For example, device A and device B are installed with the same application. Afte
1. Connect the devices to form a Super Device. 1. Connect the devices to form a Super Device.
Connect the devices to a LAN, and complete authentication of the devices. The devices must have the same account number. Connect the devices to a LAN, and complete authentication of the devices. The devices must have the same account number.
2. Implement cross-device access to the files of the same application. 2. Implement cross-device access to the files of the same application.
Place the files in the **distributedfiles/** directory of the application sandbox to implement access from difference devices. Place the files in the **distributedfiles/** directory of the application sandbox to implement access from difference devices.
...@@ -18,11 +17,13 @@ Connect the devices to a LAN, and complete authentication of the devices. The de ...@@ -18,11 +17,13 @@ Connect the devices to a LAN, and complete authentication of the devices. The de
```ts ```ts
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
import common from '@ohos.app.ability.common';
let context =...; // Obtain the UIAbilityContext information of device A. import { BusinessError } from '@ohos.base';
let pathDir = context.distributedFilesDir;
let context = getContext(this) as common.UIAbilityContext; // Obtain the UIAbilityContext of device A.
let pathDir: string = context.distributedFilesDir;
// Obtain the file path of the distributed directory. // Obtain the file path of the distributed directory.
let filePath = pathDir + '/test.txt'; let filePath: string = pathDir + '/test.txt';
try { try {
// Create a file in the distributed directory. // Create a file in the distributed directory.
...@@ -32,7 +33,8 @@ Connect the devices to a LAN, and complete authentication of the devices. The de ...@@ -32,7 +33,8 @@ Connect the devices to a LAN, and complete authentication of the devices. The de
fs.writeSync(file.fd, 'content'); fs.writeSync(file.fd, 'content');
// Close the file. // Close the file.
fs.closeSync(file.fd); fs.closeSync(file.fd);
} catch (err) { } catch (error) {
let err: BusinessError = error as BusinessError;
console.error(`Failed to openSync / writeSync / closeSync. Code: ${err.code}, message: ${err.message}`); console.error(`Failed to openSync / writeSync / closeSync. Code: ${err.code}, message: ${err.message}`);
} }
``` ```
...@@ -41,24 +43,33 @@ Connect the devices to a LAN, and complete authentication of the devices. The de ...@@ -41,24 +43,33 @@ Connect the devices to a LAN, and complete authentication of the devices. The de
```ts ```ts
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
import common from '@ohos.app.ability.common';
import buffer from '@ohos.buffer';
import { BusinessError } from '@ohos.base';
let context =...; // Obtain the UIAbilityContext information of device B. let context = getContext(this) as common.UIAbilityContext; // Obtain the UIAbilityContext of device B.
let pathDir = context.distributedFilesDir; let pathDir: string = context.distributedFilesDir;
// Obtain the file path of the distributed directory. // Obtain the file path of the distributed directory.
let filePath = pathDir + '/test.txt'; let filePath: string = pathDir + '/test.txt';
try { try {
// Open the file in the distributed directory. // Open the file in the distributed directory.
let file = fs.openSync(filePath, fs.OpenMode.READ_WRITE); let file = fs.openSync(filePath, fs.OpenMode.READ_WRITE);
// Set the buffer for receiving the read data. // Set the buffer for receiving the read data.
let buffer = new ArrayBuffer(4096); let arrayBuffer = new ArrayBuffer(4096);
// Read the file. The return value is the number of read bytes. // Read the file. The return value is the number of read bytes.
let num = fs.readSync(file.fd, buffer, { class Option {
offset: 0 public offset: number = 0;
}); public length: number;
}
let option = new Option();
option.length = arrayBuffer.byteLength;
let num = fs.readSync(file.fd, arrayBuffer, option);
// Print the read data. // Print the read data.
console.info('read result: ' + String.fromCharCode.apply(null, new Uint8Array(buffer.slice(0, num)))); let buf = buffer.from(arrayBuffer, 0, num);
} catch (err) { console.info('read result: ' + buf.toString());
} catch (error) {
let err: BusinessError = error as BusinessError;
console.error(`Failed to openSync / readSync. Code: ${err.code}, message: ${err.message}`); console.error(`Failed to openSync / readSync. Code: ${err.code}, message: ${err.message}`);
} }
``` ```
en/application-dev/file-management/manage-external-storage.md
浏览文件 @ 60468cde
...@@ -28,13 +28,13 @@ The following table describes the broadcast related parameters. ...@@ -28,13 +28,13 @@ The following table describes the broadcast related parameters.
**Table 1** Broadcast parameters **Table 1** Broadcast parameters
| Broadcast| Parameter| | Broadcast| Parameter|
| -------- | -------- | | -------- | -------- |
| usual.event.data.VOLUME_REMOVED | **id**: ID of the volume.<br>**diskId**: ID of the disk to which the volume belongs.| | usual.event.data.VOLUME_REMOVED | **id**: ID of the volume.<br>**diskId**: ID of the disk to which the volume belongs.|
| usual.event.data.VOLUME_UNMOUNTED | **id**: ID of the volume.<br>**diskId**: ID of the disk to which the volume belongs.<br>**volumeState**: state of the volume.| | usual.event.data.VOLUME_UNMOUNTED | **id**: ID of the volume.<br>**diskId**: ID of the disk to which the volume belongs.<br>**volumeState**: state of the volume.|
| usual.event.data.VOLUME_MOUNTED | **id**: ID of the volume.<br>**diskId**: ID of the disk to which the volume belongs.<br>**volumeState**: state of the volume.<br>**fsUuid**: universally unique identifier (UUID) of the volume.<br>**path**: path where the volume is mounted.| | usual.event.data.VOLUME_MOUNTED | **id**: ID of the volume.<br>**diskId**: ID of the disk to which the volume belongs.<br>**volumeState**: state of the volume.<br>**fsUuid**: universally unique identifier (UUID) of the volume.<br>**path**: path where the volume is mounted.|
| usual.event.data.VOLUME_BAD_REMOVAL | **id**: ID of the volume.<br>**diskId**: ID of the disk to which the volume belongs.| | usual.event.data.VOLUME_BAD_REMOVAL | **id**: ID of the volume.<br>**diskId**: ID of the disk to which the volume belongs.|
| usual.event.data.VOLUME_EJECT | **id**: ID of the volume.<br>**diskId**: ID of the disk to which the volume belongs.<br>**volumeState**: state of the volume.| | usual.event.data.VOLUME_EJECT | **id**: ID of the volume.<br>**diskId**: ID of the disk to which the volume belongs.<br>**volumeState**: state of the volume.|
## How to Develop ## How to Develop
...@@ -55,29 +55,33 @@ You can subscribe to broadcast events to observe the insertion and removal of ex ...@@ -55,29 +55,33 @@ You can subscribe to broadcast events to observe the insertion and removal of ex
```ts ```ts
import CommonEvent from '@ohos.commonEventManager'; import CommonEvent from '@ohos.commonEventManager';
import volumeManager from '@ohos.file.volumeManager'; import volumeManager from '@ohos.file.volumeManager';
import { BusinessError } from '@ohos.base';
const subscribeInfo = {
let subscriber: CommonEvent.CommonEventSubscriber;
async function example() {
const subscribeInfo: CommonEvent.CommonEventSubscribeInfo = {
events: [ events: [
"usual.event.data.VOLUME_REMOVED", "usual.event.data.VOLUME_REMOVED",
"usual.event.data.VOLUME_UNMOUNTED", "usual.event.data.VOLUME_UNMOUNTED",
"usual.event.data.VOLUME_MOUNTED", "usual.event.data.VOLUME_MOUNTED",
"usual.event.data.VOLUME_BAD_REMOVAL", "usual.event.data.VOLUME_BAD_REMOVAL",
"usual.event.data.VOLUME_EJECT" "usual.event.data.VOLUME_EJECT"
] ]
}; };
let subscriber = await CommonEvent.createSubscriber(subscribeInfo); subscriber = await CommonEvent.createSubscriber(subscribeInfo);
}
``` ```
3. Obtain volume information from the broadcast. 3. Obtain volume information from the broadcast.
```ts ```ts
CommonEvent.subscribe(subscriber, function (err, data) { CommonEvent.subscribe(subscriber, (err: BusinessError, data: CommonEvent.CommonEventData) => {
if (data.event === 'usual.event.data.VOLUME_MOUNTED') { if (data.event === 'usual.event.data.VOLUME_MOUNTED') {
// Manage the volume device based on the information obtained from the broadcast. // Manage the volume device based on the information obtained from the broadcast.
let volId = data.parameters.id; let volId: string = data.parameters.id;
volumeManager.getVolumeById(volId, function(error, vol) { volumeManager.getVolumeById(volId, (error: BusinessError, vol: volumeManager.Volume) => {
if (error) { if (error) {
console.error('volumeManager getVolumeById failed'); console.error('volumeManager getVolumeById failed for ' + JSON.stringify(error));
} else { } else {
console.info('volumeManager getVolumeById successfully, the volume state is ' + vol.state); console.info('volumeManager getVolumeById successfully, the volume state is ' + vol.state);
} }
......
en/application-dev/file-management/save-user-file.md
浏览文件 @ 60468cde
...@@ -11,44 +11,48 @@ The **save()** method saves files in the file manager, not in **Gallery**. ...@@ -11,44 +11,48 @@ The **save()** method saves files in the file manager, not in **Gallery**.
For example, select an image from **Gallery** and save it to the file manager. For example, select an image from **Gallery** and save it to the file manager.
1. Import the [picker](../reference/apis/js-apis-file-picker.md), [fs](../reference/apis/js-apis-file-fs.md), [photoAccessHelper](../reference/apis/js-apis-photoAccessHelper.md), and [dataSharePredicates] (../reference/apis/js-apis-data-dataSharePredicates.md) modules. 1. Import the [picker](../reference/apis/js-apis-file-picker.md), [fs](../reference/apis/js-apis-file-fs.md), [photoAccessHelper](../reference/apis/js-apis-photoAccessHelper.md), and [dataSharePredicates](../reference/apis/js-apis-data-dataSharePredicates.md) modules.
```ts ```ts
import picker from '@ohos.file.picker'; import picker from '@ohos.file.picker';
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
import photoAccessHelper from '@ohos.file.photoAccessHelper'; import photoAccessHelper from '@ohos.file.photoAccessHelper';
import dataSharePredicates from '@ohos.data.dataSharePredicates'; import dataSharePredicates from '@ohos.data.dataSharePredicates';
import common from '@ohos.app.ability.common';
import image from '@ohos.multimedia.image';
import { BusinessError } from '@ohos.base';
``` ```
2. Obtain the thumbnail of the first image on the device. Before performing this operation, ensure that at least one image exists on the device. 2. Obtain the thumbnail of the first image on the device. Before performing this operation, ensure that at least one image exists on the device.
```ts ```ts
const context = getContext(this); let context = getContext(this) as common.UIAbilityContext;
let photoAccessHelper = photoAccessHelper.getPhotoAccessHelper(context); let phAccessHelper = photoAccessHelper.getPhotoAccessHelper(context);
let pixelmapArrayBuffer; let pixelmapArrayBuffer: ArrayBuffer;
async getPixelmap() { async function getPixelmap() {
try { try {
let predicates = new dataSharePredicates.DataSharePredicates(); let predicates = new dataSharePredicates.DataSharePredicates();
let fetchOption = { let fetchOption: photoAccessHelper.FetchOptions = {
fetchColumns: [], fetchColumns: [],
predicates: predicates predicates: predicates
}; };
let fetchResult = await photoAccessHelper.getAssets(fetchOption); let fetchResult = await phAccessHelper.getAssets(fetchOption);
console.info('[picker] getThumbnail fetchResult: ' + fetchResult); console.info('[picker] getThumbnail fetchResult: ' + fetchResult);
const asset = await fetchResult.getFirstObject(); const asset = await fetchResult.getFirstObject();
console.info('[picker] getThumbnail asset displayName = ', asset.displayName); console.info('[picker] getThumbnail asset displayName = ', asset.displayName);
asset.getThumbnail().then((pixelMap) => { asset.getThumbnail().then((pixelMap: image.PixelMap) => {
let pixelBytesNumber = pixelMap.getPixelBytesNumber(); let pixelBytesNumber = pixelMap.getPixelBytesNumber();
const readBuffer = new ArrayBuffer(pixelBytesNumber); const readBuffer = new ArrayBuffer(pixelBytesNumber);
pixelMap.readPixelsToBuffer(readBuffer).then(() => { pixelMap.readPixelsToBuffer(readBuffer).then(() => {
pixelmapArrayBuffer = readBuffer; pixelmapArrayBuffer = readBuffer;
}) })
}).catch((err) => { }).catch((err: BusinessError) => {
console.error('[picker] getThumbnail failed with error: ' + err); console.error('[picker] getThumbnail failed with error: ' + JSON.stringify(err));
}); });
} catch (error) { } catch (error) {
console.error('[picker] getThumbnail error = ' + error); let err: BusinessError = error as BusinessError;
console.error('[picker] getThumbnail error = ' + JSON.stringify(err));
} }
} }
``` ```
...@@ -58,8 +62,8 @@ For example, select an image from **Gallery** and save it to the file manager. ...@@ -58,8 +62,8 @@ For example, select an image from **Gallery** and save it to the file manager.
The permission on the URI returned by **save()** is read/write. Further operations on the file can be performed based on the URI in the result set. Note that the URI cannot be directly used in the **picker** callback to open a file. You need to define a global variable to save the URI and use a button to trigger file opening. The permission on the URI returned by **save()** is read/write. Further operations on the file can be performed based on the URI in the result set. Note that the URI cannot be directly used in the **picker** callback to open a file. You need to define a global variable to save the URI and use a button to trigger file opening.
```ts ```ts
let uri:string; let uris: Array<string>;
async photoViewPickerSave() { async function photoViewPickerSave() {
try { try {
const photoSaveOptions = new picker.PhotoSaveOptions(); // Create a photoSaveOptions instance. const photoSaveOptions = new picker.PhotoSaveOptions(); // Create a photoSaveOptions instance.
photoSaveOptions.newFileNames = ["PhotoViewPicker01.png"]; // (Optional) Name of the file to be saved. The file name in the square brackets can be customized and must be unique. If the file name already exists on the device, change the file name. Otherwise, an error will be returned. photoSaveOptions.newFileNames = ["PhotoViewPicker01.png"]; // (Optional) Name of the file to be saved. The file name in the square brackets can be customized and must be unique. If the file name already exists on the device, change the file name. Otherwise, an error will be returned.
...@@ -68,15 +72,16 @@ For example, select an image from **Gallery** and save it to the file manager. ...@@ -68,15 +72,16 @@ For example, select an image from **Gallery** and save it to the file manager.
try { try {
let photoSaveResult = await photoViewPicker.save(photoSaveOptions); let photoSaveResult = await photoViewPicker.save(photoSaveOptions);
if (photoSaveResult != undefined) { if (photoSaveResult != undefined) {
console.info("[picker] photoViewPickerSave photoSaveResult = " + JSON.stringify(photoSaveResult)); uris = photoSaveResult;
this.uri = photoSaveResult[0]; console.info('photoViewPicker.save to file succeed and uris are:' + uris);
console.info('photoViewPicker.save to file succeed and uri is:' + photoSaveResult[0]);
} }
} catch (err) { } catch (error) {
let err: BusinessError = error as BusinessError;
console.error(`[picker] Invoke photoViewPicker.save failed, code is ${err.code}, message is ${err.message}`); console.error(`[picker] Invoke photoViewPicker.save failed, code is ${err.code}, message is ${err.message}`);
} }
} catch (error) { } catch (error) {
console.info("[picker] photoViewPickerSave error = " + error); let err: BusinessError = error as BusinessError;
console.info("[picker] photoViewPickerSave error = " + JSON.stringify(err));
} }
} }
``` ```
...@@ -86,14 +91,15 @@ For example, select an image from **Gallery** and save it to the file manager. ...@@ -86,14 +91,15 @@ For example, select an image from **Gallery** and save it to the file manager.
Then, use [fs.write](../reference/apis/js-apis-file-fs.md#fswrite) to modify the file based on the FD, and close the FD after the modification is complete. Then, use [fs.write](../reference/apis/js-apis-file-fs.md#fswrite) to modify the file based on the FD, and close the FD after the modification is complete.
```ts ```ts
async writeOnly(uri) { async function writeOnly(uri: string) {
try { try {
let file = fs.openSync(uri, fs.OpenMode.WRITE_ONLY); let file = fs.openSync(uri, fs.OpenMode.WRITE_ONLY);
let writeLen = await fs.write(file.fd, pixelmapArrayBuffer); let writeLen = await fs.write(file.fd, pixelmapArrayBuffer);
fs.closeSync(file); fs.closeSync(file);
console.info("[picker] writeOnly writeLen = " + writeLen); console.info("[picker] writeOnly writeLen = " + writeLen);
} catch (error) { } catch (error) {
console.info("[picker] writeOnly error: " + error); let err: BusinessError = error as BusinessError;
console.info("[picker] writeOnly error: " + JSON.stringify(err));
} }
} }
``` ```
...@@ -105,6 +111,7 @@ For example, select an image from **Gallery** and save it to the file manager. ...@@ -105,6 +111,7 @@ For example, select an image from **Gallery** and save it to the file manager.
```ts ```ts
import picker from '@ohos.file.picker'; import picker from '@ohos.file.picker';
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
import { BusinessError } from '@ohos.base';
``` ```
2. Create a **documentSaveOptions** instance. 2. Create a **documentSaveOptions** instance.
...@@ -112,6 +119,7 @@ For example, select an image from **Gallery** and save it to the file manager. ...@@ -112,6 +119,7 @@ For example, select an image from **Gallery** and save it to the file manager.
```ts ```ts
const documentSaveOptions = new picker.DocumentSaveOptions(); // Create a documentSaveOptions instance. const documentSaveOptions = new picker.DocumentSaveOptions(); // Create a documentSaveOptions instance.
documentSaveOptions.newFileNames = ["DocumentViewPicker01.txt"]; // (Optional) Set the name of the document to save. documentSaveOptions.newFileNames = ["DocumentViewPicker01.txt"]; // (Optional) Set the name of the document to save.
documentSaveOptions.fileSuffixChoices = ['.png', '.txt', '.mp4']; // (Optional) Types of the documents to save.
``` ```
3. Create a **documentViewPicker** instance, and call [save()](../reference/apis/js-apis-file-picker.md#save-3) to open the **FilePicker** page to save the document. After the user selects the destination folder, the document is saved and the URI of the document saved is returned. 3. Create a **documentViewPicker** instance, and call [save()](../reference/apis/js-apis-file-picker.md#save-3) to open the **FilePicker** page to save the document. After the user selects the destination folder, the document is saved and the URI of the document saved is returned.
...@@ -119,12 +127,12 @@ For example, select an image from **Gallery** and save it to the file manager. ...@@ -119,12 +127,12 @@ For example, select an image from **Gallery** and save it to the file manager.
The permission on the URI returned by **save()** is read/write. Further operations on the file can be performed based on the URI in the result set. Note that the URI cannot be directly used in the **picker** callback to open a file. You need to define a global variable to save the URI and use a button to trigger file opening. The permission on the URI returned by **save()** is read/write. Further operations on the file can be performed based on the URI in the result set. Note that the URI cannot be directly used in the **picker** callback to open a file. You need to define a global variable to save the URI and use a button to trigger file opening.
```ts ```ts
let uri = null; let uris: Array<string>;
const documentViewPicker = new picker.DocumentViewPicker(); // Create a documentViewPicker instance. const documentViewPicker = new picker.DocumentViewPicker(); // Create a documentViewPicker instance.
documentViewPicker.save(documentSaveOptions).then((documentSaveResult) => { documentViewPicker.save(documentSaveOptions).then((documentSaveResult: Array<string>) => {
uri = documentSaveResult[0]; uris = documentSaveResult;
console.info('documentViewPicker.save to file succeed and uri is:' + uri); console.info('documentViewPicker.save to file succeed and uris are:' + uris);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`Invoke documentViewPicker.save failed, code is ${err.code}, message is ${err.message}`); console.error(`Invoke documentViewPicker.save failed, code is ${err.code}, message is ${err.message}`);
}) })
``` ```
...@@ -151,6 +159,7 @@ For example, select an image from **Gallery** and save it to the file manager. ...@@ -151,6 +159,7 @@ For example, select an image from **Gallery** and save it to the file manager.
```ts ```ts
import picker from '@ohos.file.picker'; import picker from '@ohos.file.picker';
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
import { BusinessError } from '@ohos.base';
``` ```
2. Create an **audioSaveOptions** instance. 2. Create an **audioSaveOptions** instance.
...@@ -160,17 +169,17 @@ For example, select an image from **Gallery** and save it to the file manager. ...@@ -160,17 +169,17 @@ For example, select an image from **Gallery** and save it to the file manager.
audioSaveOptions.newFileNames = ['AudioViewPicker01.mp3']; // (Optional) Set the name of the audio file to save. audioSaveOptions.newFileNames = ['AudioViewPicker01.mp3']; // (Optional) Set the name of the audio file to save.
``` ```
3. Create an **audioViewPicker** instance, and call [save()](../reference/apis/js-apis-file-picker.md#save-6) to open the **FilePicker** page to save the file. After the user selects the destination folder, the audio file is saved and the URI of the file saved is returned. 3. Create an **audioViewPicker** instance, and call [save()](../reference/apis/js-apis-file-picker.md#save-6) to open the **FilePicker** page to save the file. After the user selects the destination folder, the audio file is saved and the URI of the document saved is returned.
The permission on the URI returned by **save()** is read/write. Further operations on the file can be performed based on the URI in the result set. Note that the URI cannot be directly used in the **picker** callback to open a file. You need to define a global variable to save the URI and use a button to trigger file opening. The permission on the URI returned by **save()** is read/write. Further operations on the file can be performed based on the URI in the result set. Note that the URI cannot be directly used in the **picker** callback to open a file. You need to define a global variable to save the URI and use a button to trigger file opening.
```ts ```ts
let uri = null; let uri: string;
const audioViewPicker = new picker.AudioViewPicker(); const audioViewPicker = new picker.AudioViewPicker();
audioViewPicker.save(audioSaveOptions).then((audioSelectResult) => { audioViewPicker.save(audioSaveOptions).then((audioSelectResult: Array<string>) => {
uri = audioSelectResult[0]; uri = audioSelectResult[0];
console.info('audioViewPicker.save to file succeed and uri is:' + uri); console.info('audioViewPicker.save to file succeed and uri is:' + uri);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`Invoke audioViewPicker.save failed, code is ${err.code}, message is ${err.message}`); console.error(`Invoke audioViewPicker.save failed, code is ${err.code}, message is ${err.message}`);
}) })
``` ```
...@@ -182,7 +191,7 @@ For example, select an image from **Gallery** and save it to the file manager. ...@@ -182,7 +191,7 @@ For example, select an image from **Gallery** and save it to the file manager.
console.info('file fd: ' + file.fd); console.info('file fd: ' + file.fd);
``` ```
5. Use [fs.writeSync()](../reference/apis/js-apis-file-fs.md#writesync) to edit the file based on the FD, and then close the FD. 5. Use [fs.writeSync()](../reference/apis/js-apis-file-fs.md#writesync) to edit the document based on the FD, and then close the FD.
```ts ```ts
let writeLen = fs.writeSync(file.fd, 'hello, world'); let writeLen = fs.writeSync(file.fd, 'hello, world');
......
en/application-dev/file-management/select-user-file.md
浏览文件 @ 60468cde
...@@ -17,6 +17,7 @@ The **FilePicker** provides the following interfaces by file type: ...@@ -17,6 +17,7 @@ The **FilePicker** provides the following interfaces by file type:
```ts ```ts
import picker from '@ohos.file.picker'; import picker from '@ohos.file.picker';
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
import { BusinessError } from '@ohos.base';
``` ```
2. Create a **photoSelectOptions** instance. 2. Create a **photoSelectOptions** instance.
...@@ -38,12 +39,12 @@ The **FilePicker** provides the following interfaces by file type: ...@@ -38,12 +39,12 @@ The **FilePicker** provides the following interfaces by file type:
The permission on the URIs returned by **select()** is read-only. Further file operations can be performed based on the URIs in the **PhotoSelectResult**. Note that the URI cannot be directly used in the **picker** callback to open a file. You need to define a global variable to save the URI and use a button to trigger file opening. The permission on the URIs returned by **select()** is read-only. Further file operations can be performed based on the URIs in the **PhotoSelectResult**. Note that the URI cannot be directly used in the **picker** callback to open a file. You need to define a global variable to save the URI and use a button to trigger file opening.
```ts ```ts
let uri = null; let uris: Array<string>;
const photoViewPicker = new picker.PhotoViewPicker(); const photoViewPicker = new picker.PhotoViewPicker();
photoViewPicker.select(photoSelectOptions).then((photoSelectResult) => { photoViewPicker.select(photoSelectOptions).then((photoSelectResult: picker.PhotoSelectResult) => {
uri = photoSelectResult.photoUris[0]; uris = photoSelectResult.photoUris;
console.info('photoViewPicker.select to file succeed and uri is:' + uri); console.info('photoViewPicker.select to file succeed and uris are:' + uris);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`Invoke photoViewPicker.select failed, code is ${err.code}, message is ${err.message}`); console.error(`Invoke photoViewPicker.select failed, code is ${err.code}, message is ${err.message}`);
}) })
``` ```
...@@ -71,12 +72,17 @@ The **FilePicker** provides the following interfaces by file type: ...@@ -71,12 +72,17 @@ The **FilePicker** provides the following interfaces by file type:
```ts ```ts
import picker from '@ohos.file.picker'; import picker from '@ohos.file.picker';
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
``` ```
2. Create a **documentSelectOptions** instance. 2. Create a **documentSelectOptions** instance.
```ts ```ts
const documentSelectOptions = new picker.DocumentSelectOptions(); const documentSelectOptions = new picker.DocumentSelectOptions();
documentSelectOptions.maxSelectNumber = 5; // (Optional) Maximum number of documents to select.
documentSelectOptions.defaultFilePathUri = "file://docs/storage/Users/currentUser/test"; // (Optional) Path of the file or directory to select.
documentSelectOptions.fileSuffixFilters = ['.png', '.txt', '.mp4']; // (Optional) File name extensions of the documents to select.
``` ```
3. Create a **documentViewPicker** instance, and call [**select()**](../reference/apis/js-apis-file-picker.md#select-3) to open the **FilePicker** page for the user to select documents. After the documents are selected, a result set containing the file URIs is returned. 3. Create a **documentViewPicker** instance, and call [**select()**](../reference/apis/js-apis-file-picker.md#select-3) to open the **FilePicker** page for the user to select documents. After the documents are selected, a result set containing the file URIs is returned.
...@@ -85,17 +91,13 @@ The **FilePicker** provides the following interfaces by file type: ...@@ -85,17 +91,13 @@ The **FilePicker** provides the following interfaces by file type:
For example, you can use [file management APIs](../reference/apis/js-apis-file-fs.md) to obtain file attributes, such as the file size, access time, and last modification time, based on the URI. If you need to obtain the file name, use [startAbilityForResult](../../application-dev/application-models/uiability-intra-device-interaction.md). For example, you can use [file management APIs](../reference/apis/js-apis-file-fs.md) to obtain file attributes, such as the file size, access time, and last modification time, based on the URI. If you need to obtain the file name, use [startAbilityForResult](../../application-dev/application-models/uiability-intra-device-interaction.md).
> **NOTE**
>
> Currently, **DocumentSelectOptions** is not configurable. By default, all types of user files are selected.
```ts ```ts
let uri = null; let uris: Array<string>;
const documentViewPicker = new picker.DocumentViewPicker(); // Create a documentViewPicker instance. const documentViewPicker = new picker.DocumentViewPicker(); // Create a documentViewPicker instance.
documentViewPicker.select(documentSelectOptions).then((documentSelectResult) => { documentViewPicker.select(documentSelectOptions).then((documentSelectResult: Array<string>) => {
uri = documentSelectResult[0]; uris = documentSelectResult;
console.info('documentViewPicker.select to file succeed and uri is:' + uri); console.info('documentViewPicker.select to file succeed and uris are:' + uris);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`Invoke documentViewPicker.select failed, code is ${err.code}, message is ${err.message}`); console.error(`Invoke documentViewPicker.select failed, code is ${err.code}, message is ${err.message}`);
}) })
``` ```
...@@ -105,24 +107,27 @@ The **FilePicker** provides the following interfaces by file type: ...@@ -105,24 +107,27 @@ The **FilePicker** provides the following interfaces by file type:
> Currently, **DocumentSelectOptions** cannot be used to obtain the file name. To obtain the file name, use **startAbilityForResult()**. > Currently, **DocumentSelectOptions** cannot be used to obtain the file name. To obtain the file name, use **startAbilityForResult()**.
```ts ```ts
let config = { async function example() {
action: 'ohos.want.action.OPEN_FILE', let config: Want = {
parameters: { action: 'ohos.want.action.OPEN_FILE',
startMode: 'choose', parameters: {
startMode: 'choose',
}
} }
} try {
try { let result = await context.startAbilityForResult(config, {windowMode: 1});
let result = await context.startAbilityForResult(config, {windowMode: 1}); if (result.resultCode !== 0) {
if (result.resultCode !== 0) { console.error(`documentViewPicker.select failed, code is ${result.resultCode}, message is ${result.want.parameters.message}`);
console.error(`documentViewPicker.select failed, code is ${result.resultCode}, message is ${result.want.parameters.message}`); return;
return; }
// Obtain the URI of the document.
let select_item_list = result.want.parameters.select_item_list;
// Obtain the name of the document.
let file_name_list = result.want.parameters.file_name_list;
} catch (error) {
let err: BusinessError = error as BusinessError;
console.error(`Invoke documentViewPicker.select failed, code is ${err.code}, message is ${err.message}`);
} }
// Obtain the URI of the document.
let select_item_list = result.want.parameters.select_item_list;
// Obtain the name of the document.
let file_name_list = result.want.parameters.file_name_list;
} catch (err) {
console.error(`Invoke documentViewPicker.select failed, code is ${err.code}, message is ${err.message}`);
} }
``` ```
...@@ -150,6 +155,7 @@ The **FilePicker** provides the following interfaces by file type: ...@@ -150,6 +155,7 @@ The **FilePicker** provides the following interfaces by file type:
```ts ```ts
import picker from '@ohos.file.picker'; import picker from '@ohos.file.picker';
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
import { BusinessError } from '@ohos.base';
``` ```
2. Create an **audioSelectOptions** instance. 2. Create an **audioSelectOptions** instance.
...@@ -169,12 +175,12 @@ The **FilePicker** provides the following interfaces by file type: ...@@ -169,12 +175,12 @@ The **FilePicker** provides the following interfaces by file type:
> Currently, **AudioSelectOptions** is not configurable. By default, all types of user files are selected. > Currently, **AudioSelectOptions** is not configurable. By default, all types of user files are selected.
```ts ```ts
let uri = null; let uri: string;
const audioViewPicker = new picker.AudioViewPicker(); const audioViewPicker = new picker.AudioViewPicker();
audioViewPicker.select(audioSelectOptions).then(audioSelectResult => { audioViewPicker.select(audioSelectOptions).then((audioSelectResult: Array<string>) => {
uri = audioSelectOptions[0]; uri = audioSelectResult[0];
console.info('audioViewPicker.select to file succeed and uri is:' + uri); console.info('audioViewPicker.select to file succeed and uri is:' + uri);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`Invoke audioViewPicker.select failed, code is ${err.code}, message is ${err.message}`); console.error(`Invoke audioViewPicker.select failed, code is ${err.code}, message is ${err.message}`);
}) })
``` ```
......
en/application-dev/file-management/set-security-label.md
浏览文件 @ 60468cde
...@@ -13,7 +13,7 @@ For details about the APIs, see [ohos.file.securityLabel](../reference/apis/js-a ...@@ -13,7 +13,7 @@ For details about the APIs, see [ohos.file.securityLabel](../reference/apis/js-a
| setSecurityLabel | Sets a security label for a file.| Method| √ | √ | | setSecurityLabel | Sets a security label for a file.| Method| √ | √ |
| getSecurityLabel | Obtains the security label of a file.| Method| √ | √ | | getSecurityLabel | Obtains the security label of a file.| Method| √ | √ |
> **NOTE** > **NOTICE**
> >
> - In distributed networking, a device can view the files that do not match its security level but cannot access them. > - In distributed networking, a device can view the files that do not match its security level but cannot access them.
> >
...@@ -26,16 +26,18 @@ Obtain the sandbox path of a file and set the data security label. For details a ...@@ -26,16 +26,18 @@ Obtain the sandbox path of a file and set the data security label. For details a
```ts ```ts
import securityLabel from '@ohos.file.securityLabel'; import securityLabel from '@ohos.file.securityLabel';
import { BusinessError } from '@ohos.base';
import common from '@ohos.app.ability.common';
// Obtain the sandbox path of the file. // Obtain the sandbox path of the file.
let context =...; // Obtain UIAbilityContext information. let context = getContext(this) as common.UIAbilityContext; // Obtain UIAbilityContext.
let pathDir = context.filesDir; let pathDir = context.filesDir;
let filePath = pathDir + '/test.txt'; let filePath = pathDir + '/test.txt';
// Set the data level of the file to S0. // Set the data level of the file to S0.
securityLabel.setSecurityLabel(filePath, 's0').then(() => { securityLabel.setSecurityLabel(filePath, 's0').then(() => {
console.info('Succeeded in setSecurityLabeling.'); console.info('Succeeded in setSecurityLabeling.');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`Failed to setSecurityLabel. Code: ${err.code}, message: ${err.message}`); console.error(`Failed to setSecurityLabel. Code: ${err.code}, message: ${err.message}`);
}); });
``` ```
en/application-dev/file-management/share-app-file.md
浏览文件 @ 60468cde
...@@ -12,7 +12,7 @@ You can use the related APIs to [share a file with another application](#sharing ...@@ -12,7 +12,7 @@ You can use the related APIs to [share a file with another application](#sharing
The file URIs are in the following format: The file URIs are in the following format:
**file**://&lt;*bundleName*&gt;/&lt;*path*&gt; **file://**&lt;bundleName&gt;/&lt;path&gt;
- **file**: indicates a file URI. - **file**: indicates a file URI.
...@@ -30,7 +30,7 @@ Before sharing application files, you need to [obtain the application file path] ...@@ -30,7 +30,7 @@ Before sharing application files, you need to [obtain the application file path]
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import fileuri from '@ohos.file.fileuri'; import fileuri from '@ohos.file.fileuri';
import window from '@ohos.window'; import window from '@ohos.window';
export default class EntryAbility extends UIAbility { export default class EntryAbility extends UIAbility {
onWindowStageCreate(windowStage: window.WindowStage) { onWindowStageCreate(windowStage: window.WindowStage) {
// Obtain the application sandbox path of the file. // Obtain the application sandbox path of the file.
...@@ -43,6 +43,7 @@ Before sharing application files, you need to [obtain the application file path] ...@@ -43,6 +43,7 @@ Before sharing application files, you need to [obtain the application file path]
``` ```
2. Set the target application, with which you want to share the file, and grant permissions on the file. 2. Set the target application, with which you want to share the file, and grant permissions on the file.
Use [startAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstartability) to share the file with the target application. You need to pass in the obtained URI in **uri** of the **want** parameter, set the type of the file to share, set **action** to **ohos.want.action.sendData**, and set the granted permission on the file in **flags**. For details, see [Want](../reference/apis/js-apis-app-ability-want.md#attributes). Use [startAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstartability) to share the file with the target application. You need to pass in the obtained URI in **uri** of the **want** parameter, set the type of the file to share, set **action** to **ohos.want.action.sendData**, and set the granted permission on the file in **flags**. For details, see [Want](../reference/apis/js-apis-app-ability-want.md#attributes).
> **NOTE** > **NOTE**
...@@ -51,37 +52,39 @@ Before sharing application files, you need to [obtain the application file path] ...@@ -51,37 +52,39 @@ Before sharing application files, you need to [obtain the application file path]
```ts ```ts
import fileuri from '@ohos.file.fileuri'; import fileuri from '@ohos.file.fileuri';
import window from '@ohos.window'; import window from '@ohos.window';
import wantConstant from '@ohos.app.ability.wantConstant'; import wantConstant from '@ohos.app.ability.wantConstant';
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import Want from '@ohos.app.ability.Want';
export default class EntryAbility extends UIAbility { import { BusinessError } from '@ohos.base';
onWindowStageCreate(windowStage: window.WindowStage) {
// Obtain the application sandbox path of the file. export default class EntryAbility extends UIAbility {
let filePath = this.context.filesDir + '/test.txt'; onWindowStageCreate(windowStage: window.WindowStage) {
// Convert the application sandbox path into a URI. // Obtain the application sandbox path of the file.
let uri = fileuri.getUriFromPath(filePath); let filePath = this.context.filesDir + '/test.txt';
let want = { // Convert the application sandbox path into a URI.
// Grant the read and write permissions on the shared file to the target application. let uri = fileuri.getUriFromPath(filePath);
flags: wantConstant.Flags.FLAG_AUTH_WRITE_URI_PERMISSION | wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION, let want: Want = {
// Set the implicit startup rule for the application that shares the file. // Grant the read and write permissions on the shared file to the target application.
action: 'ohos.want.action.sendData', flags: wantConstant.Flags.FLAG_AUTH_WRITE_URI_PERMISSION | wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION,
uri: uri, // Set the implicit startup rule for the application that shares the file.
type: 'text/plain' action: 'ohos.want.action.sendData',
} uri: uri,
this.context.startAbility(want) type: 'text/plain'
.then(() => { }
console.info('Invoke getCurrentBundleStats succeeded.'); this.context.startAbility(want)
}) .then(() => {
.catch((err) => { console.info('Invoke getCurrentBundleStats succeeded.');
console.error(`Invoke startAbility failed, code is ${err.code}, message is ${err.message}`); })
}); .catch((err: BusinessError) => {
} console.error(`Invoke startAbility failed, code is ${err.code}, message is ${err.message}`);
});
... }
} // ...
}
``` ```
## Using Shared Files ## Using Shared Files
In the [**module.json5** file](../quick-start/module-configuration-file.md) of the application, which wants to use the shared file, set **actions** to **ohos.want.action.sendData** to allow the application to receive files shared by another application and set **uris** to the type of the URI to receive. In the following example, the application receives only .txt files with **scheme** of **file**. In the [**module.json5** file](../quick-start/module-configuration-file.md) of the application, which wants to use the shared file, set **actions** to **ohos.want.action.sendData** to allow the application to receive files shared by another application and set **uris** to the type of the URI to receive. In the following example, the application receives only .txt files with **scheme** of **file**.
...@@ -120,10 +123,12 @@ After obtaining the URI of the shared file from **want**, the application can ca ...@@ -120,10 +123,12 @@ After obtaining the URI of the shared file from **want**, the application can ca
```ts ```ts
// xxx.ets // xxx.ets
import fs from '@ohos.file.fs'; import fs from '@ohos.file.fs';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
function getShareFile() { function getShareFile() {
try { try {
let want =...; // Obtain the want information sent from the application that shares the file. let want: Want = ...; // Obtain the want sent from the application that shares the file.
// Obtain the uri field from the want information. // Obtain the uri field from the want information.
let uri = want.uri; let uri = want.uri;
...@@ -135,11 +140,13 @@ function getShareFile() { ...@@ -135,11 +140,13 @@ function getShareFile() {
// Perform operations on the URI of the shared file as required. For example, open the URI to obtain the file object in read/write mode. // Perform operations on the URI of the shared file as required. For example, open the URI to obtain the file object in read/write mode.
let file = fs.openSync(uri, fs.OpenMode.READ_WRITE); let file = fs.openSync(uri, fs.OpenMode.READ_WRITE);
console.info('open file successfully!'); console.info('open file successfully!');
} catch (error) { } catch (err) {
let error: BusinessError = err as BusinessError;
console.error(`Invoke openSync failed, code is ${error.code}, message is ${error.message}`); console.error(`Invoke openSync failed, code is ${error.code}, message is ${error.message}`);
} }
} catch (error) { } catch (error) {
console.error(`Invoke openSync failed, code is ${error.code}, message is ${error.message}`); let err: BusinessError = error as BusinessError;
console.error(`Invoke openSync failed, code is ${err.code}, message is ${err.message}`);
} }
} }
``` ```
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或