介绍
本示例是一个安全类App,使用@ohos.dlpPermission 接口展示了在eTS中普通文件加密受限的过程。
效果预览
使用说明:
- 启动应用后点击“+”按钮可以添加一个普通文件;
- 长按点击加密按钮,出现加密权限弹窗,选择需要设置的权限并点击确定;
- 点击加密文件,跳转到文本编辑应用,如果设置的权限是只读权限,页面置灰,不可编辑。
- 长按点击删除按钮,删除文件;
工程目录
entry/src/main/ets/
|---component
| |---CustomDialog.ets // 权限弹窗
|---feature
| |---DlpManager.ets // Dlp管理
| |---FileManager.ets // 文件管理
| |---PreferencesManager.ets // 持久化存储
|---pages
| |---Index.ets // 首页
|---util
| |---Logger.ts // 日志
| |---ResourceUtils.ets // 资源转换
具体实现
- 文件的添加和文件列表的获取分别在Index和MediaFileUri中
- 文件的添加:首先通过@ohos.file.picker接口的DocumentSaveOptions()方法自定一个参数,然后通过new picker.DocumentViewPicker()方法拉起文件管理应用去新建一个普通文件。
- 文件列表的获取:首先使用@ohos.file.fileAccess 接口的createFileAccessHelper()方法来创建连接指定wants的helper对象,然后通过getRoots()方法来获取helper对象连接的文件管理服务类的设备根节点信息,并获取到目录url,最后通过getFileInfoFromUri()方法得到文件的信息。
- 文件的加密操作在DlpManager中
- 加密操作:使用dlpPermission接口的generateDLPFile方法获得一个相关的操作型关系数据库RdbStore,将明文文件加密生成权限受控文件。
相关权限
允许应用读取用户外部存储中的媒体文件信息:ohos.permission.READ_MEDIA
允许应用读写用户外部存储中的媒体文件信息:ohos.permission.WRITE_MEDIA
允许文件管理类应用通过FAF框架访问公共数据文件:ohos.permission.FILE_ACCESS_MANAGER
允许应用读取用户外部存储中的媒体文件信息:ohos.permission.STORAGE_MANAGER
允许应用读取用户外部存储中的媒体文件信息:ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
允许应用读取用户外部存储中的媒体文件信息:ohos.permission.ACCESS_DLP_FILE
允许应用读取用户外部存储中的媒体文件信息:ohos.permission.MANAGE_DISTRIBUTED_ACCOUNTS
允许应用读取用户外部存储中的媒体文件信息:ohos.permission.MANAGE_LOCAL_ACCOUNTS
允许应用读取用户外部存储中的媒体文件信息:ohos.permission.GET_LOCAL_ACCOUNTS
允许应用读取用户外部存储中的媒体文件信息:ohos.permission.MANAGE_DISTRIBUTED_ACCOUNTS
依赖
需要依赖三方应用文本编辑FileEdit的hap。
约束与限制
- 本示例仅支持标准系统上运行;
- 本示例仅支持API10版本SDK,SDK版本号(4.0.10.10), 镜像版本号(4.0 Release)。
- 本示例需要使用DevEco Studio 4.0 Beta2 (Build Version: 4.0.0.400, built on August 2, 2023)才可编译运行;
- 本示例需要使用@@ohos.dlpPermission系统权限的系统接口。使用Full SDK时需要手动从镜像站点获取,并在DevEco Studio中替换。
下载
如需单独下载本工程,执行如下命令:
git init
git config core.sparsecheckout true
echo code/ SystemFeature/Security/DLP/ > .git/info/sparse-checkout
git remote add origin https://gitee.com/openharmony/applications_app_samples.git
git pull origin master
学习鸿蒙正当时!以下是一些学习资料,可以作为参考:
《HarmonyOS教学视频》: HarmonyOS教学视频 (qq.com)
《鸿蒙 (Harmony OS)开发学习手册》: 鸿蒙 (Harmony OS)开发学习手册 (qq.com)
《鸿蒙生态应用开发白皮书V2.0PDF》: 鸿蒙生态应用开发白皮书V2.0PDF (qq.com)
《做鸿蒙应用开发到底学习些啥?》:做鸿蒙应用开发到底学习些啥? (qq.com)