鸿蒙 Next 实战：打造全能文件管理器应用
本文旨在深入探讨华为鸿蒙HarmonyOS Next系统（截止目前 API12）在开发多语言电商平台方面的技术细节，基于实际开发实践进行总结。主要作为技术分享与交流载体，难免错漏，欢迎各位同仁提出宝贵意见和问题，以便共同进步。本文为原创内容，任何形式的转载必须注明出处及原作者。
在当今数字化时代，文件管理器成为了人们管理本地文件和媒体文件的重要工具。今天，我们将基于鸿蒙 Next 系统，深入探讨如何开发一个功能强大的文件管理器应用，涵盖从基础架构设计到核心功能实现的全过程，让你全面掌握鸿蒙 Next 在文件管理领域的应用开发技巧。
一、应用架构设计：MVC 架构的应用
（一）MVC 架构概述
MVC（Model-View-Controller）架构是一种经典的软件设计模式，它将应用程序分为三个主要部分：模型（Model）、视图（View）和控制器（Controller）。在我们的文件管理器应用中，这种架构的应用将使代码结构更加清晰，易于维护和扩展。
（二）模型（Model）层
模型层负责处理数据的存储、检索和更新。在文件管理器应用中，它主要涉及文件和目录的操作，如文件读取、写入、删除、复制、移动等。我们将使用鸿蒙 Next 的系统 API 来实现这些操作。例如，使用fileIo模块来进行文件的读写操作，directoryIo模块来处理目录相关操作。
（三）视图（View）层
视图层负责呈现用户界面，展示文件和目录列表，以及提供操作按钮等交互元素。我们将使用 ArkUI 框架来构建用户界面，通过组件化的方式，如List组件展示文件列表，Button组件实现操作按钮，确保界面简洁、美观且易于操作。
（四）控制器（Controller）层
控制器层充当模型和视图之间的桥梁，负责处理用户输入事件，并根据业务逻辑调用模型层的相应方法。例如，当用户点击文件上传按钮时，控制器将获取用户选择的文件路径，调用模型层的上传方法将文件上传到指定位置。
（五）使用系统 Picker 实现文件选择和保存
为了遵循鸿蒙 Next 的安全原则，避免直接访问用户文件系统，我们将广泛使用系统 Picker 来实现文件选择和保存功能。当用户需要打开文件时，通过文件选择器（FilePicker）让用户选择文件，应用获取用户选择的文件路径后进行后续操作。同样，在保存文件时，使用系统提供的保存路径选择器，确保文件保存到正确的位置。
二、权限申请与管理
（一）权限机制回顾
在鸿蒙 Next 系统中，权限分为 system_grant（系统授权）和 user_grant（用户授权）两种类型。系统授权权限在应用安装时自动授予，而用户授权权限则需要在应用运行时向用户请求授权。
（二）应用所需权限及申请方式
- 读取文件权限（user_grant）
应用需要读取用户本地文件时，需申请ohos.permission.READ_EXTERNAL_STORAGE权限（假设为读取外部存储文件权限，实际根据系统定义）。在应用启动时，通过requestPermissionsFromUser()接口向用户请求授权。例如：
import { abilityAccessCtrl, common, Permissions } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
const readPermission: Permissions = 'ohos.permission.READ_EXTERNAL_STORAGE';
async function checkReadPermissionGrant(): Promise<abilityAccessCtrl.GrantStatus> {
let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
let grantStatus: abilityAccessCtrl.GrantStatus = abilityAccessCtrl.GrantStatus.PERMISSION_DENIED;
// 获取应用程序的 accessTokenID
let tokenId: number = 0;
try {
let bundleInfo: bundleManager.BundleInfo = await bundleManager.getBundleInfoForSelf(bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION);
let appInfo: bundleManager.ApplicationInfo = bundleInfo.appInfo;
tokenId = appInfo.accessTokenId;
} catch (error) {
const err: BusinessError = error as BusinessError;
console.error(`Failed to get bundle info for self. Code is ${err.code}, message is ${err.message}`);
}
// 校验应用是否被授予权限
try {
grantStatus = await atManager.checkAccessToken(tokenId, readPermission);
} catch (error) {
const err: BusinessError = error as BusinessError;
console.error(`Failed to check access token. Code is ${err.code}, message is ${err.message}`);
}
return grantStatus;
}
async function requestReadPermission(): Promise<void> {
let grantStatus: abilityAccessCtrl.GrantStatus = await checkReadPermissionGrant();
if (grantStatus === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED) {
// 已获得读取权限，可以进行文件读取操作
console.log('已获得读取文件权限，可以继续操作。');
} else {
// 申请读取文件权限
const permissions: Array<Permissions> = [readPermission];
let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
atManager.requestPermissionsFromUser(globalThis.context as common.UIAbilityContext, permissions).then((data) => {
let grantStatus: Array<number> = data.authResults;
let length: number = grantStatus.length;
for (let i = 0; i < length; i++) {
if (grantStatus[i] === 0) {
// 用户授权，可以继续访问目标操作
console.log('用户已授权读取文件权限，可以继续操作。');
} else {
// 用户拒绝授权，提示用户必须授权才能访问相关功能，并引导用户到系统设置中打开相应权限
console.log('用户拒绝授权读取文件权限，请前往系统设置中手动授予权限。');
return;
}
}
// 授权成功
}).catch((err: BusinessError) => {
console.error(`Failed to request read permission from user. Code is ${err.code}, message is ${err.message}`);
});
}
}
// 在应用启动或需要读取文件时调用 requestReadPermission() 函数
requestReadPermission();
-
写入文件权限（user_grant）
当应用需要保存文件或修改文件内容时，需申请ohos.permission.WRITE_EXTERNAL_STORAGE权限。申请方式与读取文件权限类似，同样需要先检查权限状态，未授权时向用户请求授权。 -
访问网络权限（system_grant）
文件上传和下载功能需要访问网络，应用需申请ohos.permission.INTERNET权限。此权限为系统授权类型，在应用的配置文件（如module.json5）中声明即可，系统会在安装时自动授予。
（三）受限开放权限与 ACL 申请（以读取媒体文件为例）
如果应用需要读取用户媒体文件，如图片、音频、视频等，可能涉及受限开放权限。假设读取媒体文件权限为ohos.permission.READ_MEDIA_FILES（实际根据系统定义），且该权限属于受限开放权限。
-
AGC 申请 Profile 文件
首先，开发者需要在应用市场（AppGallery Connect，AGC）申请 Profile 文件，并在申请过程中明确申请使用读取媒体文件权限。提供详细的应用使用场景说明，如文件管理器需要读取媒体文件以实现预览、分类管理等功能。 -
代码工程中声明权限
在 AGC 侧申请成功后，在代码工程的配置文件（module.json5）中声明该权限：
{
"module": {
"requestPermissions":[
{
"name": "ohos.permission.READ_MEDIA_FILES",
"reason": "$string:reason_for_read_media_files",
"usedScene": {
"abilities": [
"MainAbility"
],
"when":"inuse"
}
}
]
}
}
同时，在应用运行时，按照用户授权的流程，通过requestPermissionsFromUser()接口向用户请求授权（如果该权限属于 user_grant 类型），并处理用户的授权结果。
三、核心功能实现
（一）文件操作功能
- 文件读取
使用fileIo模块的open()方法打开文件，获取文件描述符，然后通过read()方法读取文件内容。例如：
import { fileIo } from '@kit.CoreFileKit';
async function readFile(filePath: string): Promise<string> {
let file = await fileIo.open(filePath, fileIo.OpenMode.READ_ONLY);
let buffer = new ArrayBuffer(fileIo.statSync(filePath).size);
await fileIo.read(file.fd, buffer);
await fileIo.close(file.fd);
return new TextDecoder().decode(buffer);
}
- 文件写入
通过fileIo模块的open()方法以写入模式打开文件，使用write()方法将数据写入文件。例如：
async function writeFile(filePath: string, content: string): Promise<void> {
let file = await fileIo.open(filePath, fileIo.OpenMode.WRITE_ONLY | fileIo.OpenMode.CREATE);
await fileIo.write(file.fd, new TextEncoder().encode(content));
await fileIo.close(file.fd);
}
- 文件删除、复制和移动
利用fileIo和directoryIo模块的相关方法实现文件的删除、复制和移动操作。例如，文件删除可以使用unlink()方法，文件复制可以先读取源文件内容，再写入到目标文件，文件移动可以通过先复制再删除源文件的方式实现（需考虑原子性操作以确保数据完整性）。
（二）网络操作功能
- 文件上传
使用http或https模块（假设鸿蒙 Next 提供类似网络请求模块）实现文件上传功能。首先创建一个HttpRequest对象，设置请求方法为POST，上传地址等参数，然后将文件内容作为请求体发送。例如：
import { http } from '@kit.NetworkKit';
async function uploadFile(filePath: string, uploadUrl: string): Promise<void> {
let fileContent = await readFile(filePath);
let request = http.createHttpRequest();
request.method = 'POST';
request.url = uploadUrl;
request.headers = { 'Content-Type': 'application/octet-stream' };
request.requestBody = new Uint8Array(new TextEncoder().encode(fileContent));
try {
await request.send();
if (request.responseCode === 200) {
console.log('文件上传成功。');
} else {
console.error('文件上传失败，错误码：', request.responseCode);
}
} catch (error) {
console.error('文件上传过程中出错：', error);
}
}
- 文件下载
类似地，使用网络请求模块实现文件下载功能。创建HttpRequest对象，设置请求方法为GET，下载地址等参数，然后接收服务器返回的文件内容并保存到本地。例如：
async function downloadFile(downloadUrl: string, savePath: string): Promise<void> {
let request = http.createHttpRequest();
request.method = 'GET';
request.url = downloadUrl;
try {
await request.send();
if (request.responseCode === 200) {
await writeFile(savePath, request.responseData.toString());
console.log('文件下载成功，保存路径：', savePath);
} else {
console.error('文件下载失败，错误码：', request.responseCode);
}
} catch (error) {
console.error('文件下载过程中出错：', error);
}
}
（三）分享功能
-
分享方式选择
提供多种分享方式，如通过邮件、短信、社交媒体等分享文件。在用户选择分享文件后，弹出分享方式选择界面，让用户选择合适的分享渠道。 -
分享实现
根据用户选择的分享方式，使用相应的系统 API 实现分享操作。例如，通过邮件分享文件时，使用邮件客户端的分享接口，将文件作为附件添加到邮件中。假设鸿蒙 Next 提供了share模块来实现分享功能，以下是一个简单的邮件分享示例（实际接口可能不同）：
import { share } from '@kit.ShareKit';
async function shareFileByEmail(filePath: string, recipient: string): Promise<void> {
let fileContent = await readFile(filePath);
let shareData = {
type:'message/email',
subject: '文件分享',
body: '这是一个通过文件管理器分享的文件。',
attachments: [
{
name: filePath.split('/').pop(),
data: fileContent
}
]
};
try {
await share.share(shareData, { recipients: [recipient] });
console.log('文件通过邮件分享成功。');
} catch (error) {
console.error('文件分享失败：', error);
}
}
四、总结与展望
通过本次实战，我们成功构建了一个基于鸿蒙 Next 系统的文件管理器应用，涵盖了文件浏览、管理、上传、下载和分享等核心功能。在开发过程中，我们深入应用了鸿蒙 Next 的应用沙箱与权限机制、系统授权与用户授权、受限开放权限与 ACL 申请、系统 Picker 等关键技术，确保了应用的安全性、稳定性和功能性。
展望未来，随着鸿蒙 Next 系统的不断发展和完善，我们可以进一步优化文件管理器的性能，如提升大文件操作的效率、增强文件搜索功能等。同时，结合分布式技术，实现跨设备的文件管理和共享，为用户提供更加便捷、高效的文件管理体验。希望本文能够为鸿蒙 Next 同行者提供有益的参考和借鉴，激发更多创新应用的开发。
