HarmonyOS Next开发学习手册——文件授权访问(ArkTS)

最新推荐文章于 2024-09-30 15:28:53 发布
最新推荐文章于 2024-09-30 15:28:53 发布
阅读量1.1k 收藏 24
点赞数 22
分类专栏： 移动开发 OpenHarmony HarmonyOS 文章标签： harmonyos 学习 华为 移动开发 鸿蒙开发 ArkUI 文件授权访问
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/maniuT/article/details/140673024
版权
移动开发 同时被 3 个专栏收录
955 篇文章 13 订阅
订阅专栏
HarmonyOS
871 篇文章 15 订阅
订阅专栏
OpenHarmony
694 篇文章 18 订阅
订阅专栏

提供给应用的文件授权访问场景主要分为：

  1. 获取并使用公共目录。
  2. 通过FilePicker选择文件或目录授权并支持授权持久化。
  3. 通过接口获取文件或文件夹当前所在路径的URI。
  4. 通过接口获取外卡目录。

文件授权访问的场景仅支持部分设备。

下面介绍几种常用操作示例。

获取并使用公共目录

通过目录环境能力获取公共目录，通过弹窗授权方式向用户申请授予对应目录的权限后对相应目录进行访问，具体请参考( 获取并使用公共目录 )。

通过FilePicker设置永久授权

通过FilePicker选择文件或文件夹后设置永久授权，以及应用重启后的激活权限过程如下所示，通过文件分享接口（ ohos.fileshare ）实现文件授权能力。

  1. 应用调用picker的( selec )接口，通过FilePicker选择和保存路径URI，此时应用获得该路径的临时访问权限。

以下示例代码演示了获取文件夹URI的过程：

import { BusinessError } from '@kit.BasicServicesKit';
import { picker } from '@kit.CoreFileKit';

async function selectExample() {
  try {
    let DocumentSelectOptions = new picker.DocumentSelectOptions();
    DocumentSelectOptions.selectMode = picker.DocumentSelectMode.FOLDER;
    let documentPicker = new picker.DocumentViewPicker();
    let uris = await documentPicker.select(DocumentSelectOptions);
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('select failed with err: ' + JSON.stringify(err));
  }
}
  1. 应用按需对路径设置持久化授权，检查是否对URI有持久化权限，如果没有权限则进行第3步持久化权限，参数uri为第1步FilePicker应用获取的选择路径。

以下示例代码演示了检查持久化权限过程：

import { BusinessError } from '@kit.BasicServicesKit';
import { picker } from '@kit.CoreFileKit';
import { fileShare } from '@kit.CoreFileKit';

async function checkPersistentPermissionExample() {
 try {
   let documentSelectOptions = new picker.DocumentSelectOptions();
   let documentPicker = new picker.DocumentViewPicker();
   let uris = await documentPicker.select(documentSelectOptions);
   let policyInfo: fileShare.PolicyInfo = {
     uri: uris[0],
     operationMode: fileShare.OperationMode.READ_MODE,
   };
   let policies: Array<fileShare.PolicyInfo> = [policyInfo];
   fileShare.checkPersistentPermission(policies).then(async (data) => {
     let results: Array<boolean> = data;
     for (let i = 0; i < results.length; i++) {
       console.log("checkPersistentPermission result: " + JSON.stringify(results[i]));
       if (!results[i]) {
         let info: fileShare.PolicyInfo = {
           uri: policies[i].uri,
           operationMode: policies[i].operationMode,
         };
         let policy: Array<fileShare.PolicyInfo> = [info];
         await fileShare.persistPermission(policy);
       }
     }
   }).catch((err: BusinessError<Array<fileShare.PolicyErrorResult>>) => {
     console.info("checkPersistentPermission failed with error message: " + err.message + ", error code: " + err.code);
   });
 } catch (error) {
   let err: BusinessError = error as BusinessError;
   console.error('checkPersistentPermission failed with err: ' + JSON.stringify(err));
 }
}
  1. 应用按需对路径设置持久化授权，参数uri为第1步FilePicker应用获取的选择路径。

以下示例代码演示了持久化授权过程：

import { BusinessError } from '@kit.BasicServicesKit';
import { fileShare } from '@kit.CoreFileKit';
import { fileIo as fs } from '@kit.CoreFileKit';

async function persistPermissionExample() {
  try {
    let uri = "file://docs/storage/Users/username/1.txt";
    let policyInfo: fileShare.PolicyInfo = {
      uri: uri,
      operationMode: fileShare.OperationMode.READ_MODE,
    };
    let policies: Array<fileShare.PolicyInfo> = [policyInfo];
    fileShare.persistPermission(policies).then(() => {
      console.info("persistPermission successfully");
    }).catch((err: BusinessError<Array<fileShare.PolicyErrorResult>>) => {
      console.info("persistPermission failed with error message: " + err.message + ", error code: " + err.code);
      if (err.code == 13900001 && err.data) {
        console.log("error data : " + JSON.stringify(err.data));
      }
    });
    let fd = await fs.open(uri);
    await fs.close(fd);
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('persistPermission failed with err: ' + JSON.stringify(err));
  }
}
  1. 应用按需对持久化授权后的路径取消授权，参数URI为第1步通过FilePicker选择的路径。

以下示例代码演示了去除持久化授权URI的过程：

import { BusinessError } from '@kit.BasicServicesKit';
import { fileShare } from '@kit.CoreFileKit';
import { fileIo as fs } from '@kit.CoreFileKit';

async function revokePermissionExample() {
  try {
    let uri = "file://docs/storage/Users/username/1.txt";
    let policyInfo: fileShare.PolicyInfo = {
      uri: uri,
      operationMode: fileShare.OperationMode.READ_MODE,
    };
    let policies: Array<fileShare.PolicyInfo> = [policyInfo];
    await fileShare.persistPermission(policies);
    fileShare.revokePermission(policies).then(() => {
      console.info("revokePermission successfully");
    }).catch((err: BusinessError<Array<fileShare.PolicyErrorResult>>) => {
      console.info("revokePermission failed with error message: " + err.message + ", error code: " + err.code);
      if (err.code == 13900001 && err.data) {
        console.log("error data : " + JSON.stringify(err.data));
      }
    });
    let fd = await fs.open(uri);
    await fs.close(fd);
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('revokePermission failed with err: ' + JSON.stringify(err));
  }
}
  1. 应用获得的持久化权限需要在重启后进行激活，应用重启后及访问URI之前首先检查对URI是否有持久化权限，有权限则激活已经持久化的授权URI，持久化授权的接口需要与激活持久化权限的接口配套使用。

以下示例代码演示了应用激活持久化授权的过程，其中参数URI为应用重启后需要激活权限的路径：

import { BusinessError } from '@kit.BasicServicesKit';
import { fileShare } from '@kit.CoreFileKit';
import { fileIo as fs } from '@kit.CoreFileKit';

async function activatePermissionExample01() {
  try {
    let uri = "file://docs/storage/Users/username/tmp.txt";
    let policyInfo: fileShare.PolicyInfo = {
      uri: uri,
      operationMode: fileShare.OperationMode.READ_MODE,
    };
    let policies: Array<fileShare.PolicyInfo> = [policyInfo];
    let results = await fileShare.checkPersistentPermission(policies);
    for (let i = 0; i < results.length; i++) {
      console.log("checkPersistentPermission result: " + JSON.stringify(results[i]));
      if (results[i]) {
        let info: fileShare.PolicyInfo = {
          uri: policies[i].uri,
          operationMode: policies[i].operationMode,
        };
        let policy: Array<fileShare.PolicyInfo> = [info];
        await fileShare.activatePermission(policy);
        console.info("activatePermission successfully");
      }
    }
    let fd = await fs.open(uri);
    await fs.close(fd);
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('activatePermission failed with err: ' + JSON.stringify(err));
  }
}
  1. 应用可以按需取消激活的持久化权限能力，参数URI为应用重启后需要激活权限的路径。

以下示例代码演示了取消激活持久化权限的过程：

import { BusinessError } from '@kit.BasicServicesKit';
import { fileShare } from '@kit.CoreFileKit';
import { fileIo as fs } from '@kit.CoreFileKit';

async function deactivatePermissionExample01() {
  try {
    let uri = "file://docs/storage/Users/username/tmp.txt";
    let policyInfo: fileShare.PolicyInfo = {
      uri: uri,
      operationMode: fileShare.OperationMode.READ_MODE,
    };
    let policies: Array<fileShare.PolicyInfo> = [policyInfo];
    await fileShare.activatePermission(policies);
    fileShare.deactivatePermission(policies).then(() => {
      console.info("deactivatePermission successfully");
    }).catch((err: BusinessError<Array<fileShare.PolicyErrorResult>>) => {
      console.info("deactivatePermission failed with error message: " + err.message + ", error code: " + err.code);
      if (err.code == 13900001 && err.data) {
        console.log("error data : " + JSON.stringify(err.data));
      }
    });
    let fd = await fs.open(uri);
    await fs.close(fd);
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('deactivatePermission failed with err: ' + JSON.stringify(err));
  }
}

通过接口获取文件或文件夹当前所在路径的URI

如果当前FileUri指向文件，将返回文件所在路径URI，如果当前FileUri指向目录，将返回当前路径URI。通过文件URI接口（ ohos.file.fileuri ）获取文件或文件夹当前所在路径的URI。

以下示例代码演示了获取文件父目录过程：

import { BusinessError } from '@kit.BasicServicesKit';
import { fileUri } from '@kit.CoreFileKit';

function getFullDirectoryUriExample01() {
  try {
    let uri = "file://docs/storage/Users/100/tmp/1.txt";
    let fileObject = new fileUri.FileUri(uri);
    let directoryUri = fileObject.getFullDirectoryUri();
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error('getFullDirectoryUri failed with err: ' + JSON.stringify(err));
  }
}

鸿蒙全栈开发全新学习指南

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以要有一份实用的鸿蒙（HarmonyOS NEXT）学习路线与学习文档用来跟着学习是非常有必要的。

针对一些列因素，整理了一套纯血版鸿蒙（HarmonyOS Next）全栈开发技术的学习路线，包含了鸿蒙开发必掌握的核心知识要点，内容有（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、WebGL、元服务、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony驱动开发、系统定制移植等等）鸿蒙（HarmonyOS NEXT）技术知识点。

本路线共分为四个阶段：

第一阶段：鸿蒙初中级开发必备技能

在这里插入图片描述

第二阶段：鸿蒙南北双向高工技能基础：gitee.com/MNxiaona/733GH

第三阶段：应用开发中高级就业技术

第四阶段：全网首发-工业级南向设备开发就业技术：gitee.com/MNxiaona/733GH

《鸿蒙 (Harmony OS)开发学习手册》（共计892页）

如何快速入门？

1.基本概念
2.构建第一个ArkTS应用
3.……

开发基础知识:gitee.com/MNxiaona/733GH

1.应用基础知识
2.配置文件
3.应用数据管理
4.应用安全管理
5.应用隐私保护
6.三方应用调用管控机制
7.资源分类与访问
8.学习ArkTS语言
9.……

基于ArkTS 开发

1.Ability开发
2.UI开发
3.公共事件与通知
4.窗口管理
5.媒体
6.安全
7.网络与链接
8.电话服务
9.数据管理
10.后台任务(Background Task)管理
11.设备管理
12.设备使用信息统计
13.DFX
14.国际化开发
15.折叠屏系列
16.……

鸿蒙开发面试真题（含参考答案）:gitee.com/MNxiaona/733GH

鸿蒙入门教学视频：

美团APP实战开发教学：gitee.com/MNxiaona/733GH

写在最后

  • 如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：
  • 点赞，转发，有你们的 『点赞和评论』，才是我创造的动力。
  • 关注小编，同时可以期待后续文章ing🚀，不定期分享原创知识。
  • 想要获取更多完整鸿蒙最新学习资源，请移步前往小编：gitee.com/MNxiaona/733GH

OpenHarmony_小贾
关注
专栏目录
HarmonyOS NEXT应用开发性能指导
09-04
HarmonyOS NEXT应用开发性能指导。应用开发案例集
OpenHarmony开发实战：为应用添加运行时权限（ArkTS）
shudaoshanQAQ的博客
04-10 1898
通过AbilityAccessCtrl动态向用户申请“允许不同设备间的数据交换”的权限
鸿蒙-arkTs：访问控制授权申请
Erek的前端博客；
12-19 1271
鸿蒙-arkTs：访问控制授权申请
import { request } from ‘@kit.BasicServicesKit‘； 关于 request 的task 找不到 .on() 的问题
最新发布
hqy1989的博客
09-30 1047
这个imgName返回的类型有两个，所以他无法判断是不是string类型，所以就没有 .on()方法。他要加上双引号才能是string类型，问题肯定出在了。这样就解决一半了，还有type没有解决。看他定义的都是string类型的。
基于AVCodecKit的音视频解码及二次处理播放
hongxiaomeng的博客
06-07 475
在应用合规的背景下，《ArkTS、Api9》鸿蒙开发中如何实现权限申请
qq_43238112的博客
01-22 1136
鸿蒙开发实现权限请求
52.HarmonyOS鸿蒙系统 App(ArkTS)配置文件添加多个权限方法
Txwtech笛克特科
05-01 667
52.HarmonyOS鸿蒙系统 App(ArkTS)配置文件添加多个权限方法。
全网首发鸿蒙 HarmonyOS NEXT星河版零基础入门到实战，零基础也能快速入门鸿蒙开发教程
02-11
本教程旨在帮助初学者从零开始学习鸿蒙 HarmonyOS NEXT 星河版的开发技术。首先，我们需要准备开发环境。鸿蒙系统是由华为公司主导开发的一款面向未来、基于微内核的分布式操作系统，它适用于多种智能设备，如手机、...
全网首发黑马程序员鸿蒙 HarmonyOS NEXT星河版零基础入门到实战，零基础也能快速入门鸿蒙开发教程2
05-16
《全网首发黑马程序员鸿蒙 HarmonyOS NEXT星河版零基础入门到实战》是一套针对初学者精心设计的鸿蒙操作系统开发教程。本教程旨在帮助没有编程基础的学员快速掌握HarmonyOS的开发技能，通过丰富的实例和清晰的讲解，...
HarmonyOS应用开发者基础认证考试题目及答案
12-17
HarmonyOS应用开发者基础认证考试题目及答案HarmonyOS应用开发者基础认证考试题目及答案HarmonyOS应用开发者基础认证考试题目及答案HarmonyOS应用开发者基础认证考试题目及答案HarmonyOS应用开发者基础认证考试题目...
黑马HarmonyOS-NEXT星河版实战-课程网盘链接提取码下载 .txt
06-03
"黑马HarmonyOS-NEXT星河版实战"课程旨在帮助学员深入了解HarmonyOS-NEXT星河版操作系统的开发和实际应用。学员将学习操作系统原理、应用开发技巧和界面设计，通过实战项目提升技能。课程注重实践与理论相结合，为...
鸿蒙开发5.0【Picker的受限权限适配方案】
2301_76813281的博客
09-07 1185
Picker由系统独立进程实现，应用可以通过拉起Picker组件，用户在Picker上选择对应的资源（如图片、文档等），应用可以获取Picker返回的结果。
ArkTS-HarmonyOS应用开发video体验分享
weixin_69135651的博客
11-22 1403
需要权限：使用网络视频时，需要申请权限ohos.permission.INTERNET。具体申请方式请参考权限申请声明。
鸿蒙开发api9及以上之相册权限、相机权限、文件读写权限申请的正确方法
qq_15509071的博客
01-17 2860
"ohos.permission.MEDIA_LOCATION" 文件位置权限： 允许应用访问用户媒体文件中的地理位置信息。"ohos.permission.READ_MEDIA" 文件读权限。"ohos.permission.WRITE_MEDIA"文件写权限。1.在module.json5中注册权限信息。和"abilities": []同级别。2.然后在需要调用的地方。获取当前context。4.最后才是代码调用。
【HarmonyOS】【ArkTS】如何使用HTTP网络请求获取动态数据刷新UI界面
热门推荐
Mayism123的博客
06-07 1万+
在使用ArkTS开发HarmonyOS应用时，需要调用HTTP网络请求 @ohos.net.http 动态获取数据，进行UI列表刷新，这想必是应用开发最常见的功能。但是根据官网网络请求的示例代码进行功能开发时，封装方法进行HTTP请求后，返回获取数据总是为空，无法返回调用接口获取的结果，经过一系列步骤检查，终于获取到数据，在此附上我的开发步骤、一些注意事项以及参考文档。步骤4：获取到dataList数组后，就可以通过ForEach循环显示组件和数据啦，到此就完成HTTP网络请求动态数据获取刷新UI界面啦。
HarmonyOS Next开发学习手册——通过startAbility拉起文件处理类应用
maniuT的博客
06-25 1413
开发者可以通过调用startAbility接口，由系统从已安装的应用中寻找符合要求的应用来实现打开特定文件的意图，例如：浏览器下应用下载PDF文件，可以调用此接口选择文件处理应用打开此PDF文件。开发者需要在请求中设置待打开文件的URI路径（uri）、文件格式（type）等字段，以便系统能够识别，直接拉起文件打开应用或弹出一个选择框，让用户选择合适的应用来打开文件，效果示意如下图所示。支持打开文件的应用需要在module.json5配置文件中声明文件打开能力。flags 相关参数说明。
鸿蒙开发Ability Kit（程序访问控制）：【使用保存控件】
鸿蒙的技术博客
07-03 797
保存控件是一种特殊的安全控件，它允许用户通过点击按钮临时获取存储权限，而无需通过权限弹框进行授权确认。集成保存控件后，当用户点击该控件时，应用会获得10秒内单次访问媒体库特权接口的授权。这适用于任何需要将文件保存到媒体库的应用场景，例如保存图片或视频等。与需要触发系统应用并由用户选择具体保存路径的Picker不同，保存控件可以直接保存到指定的媒体库路径，使得操作更为便捷。保存控件效果如图所示。
鸿蒙实战开发-如何实现选择并查看文档与媒体文件
m0_70749039的博客
04-10 1805
应用使用@ohos.file.picker、@ohos.multimedia.mediaLibrary、@ohos.file.fs 等接口，实现了picker拉起文档编辑保存、拉起系统相册图片查看、拉起视频并播放的功能。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值