鸿蒙 Next 实战:打造全能文件管理器应用 原创 精华

SameX
发布于 2024-11-6 09:13
浏览
0收藏

本文旨在深入探讨华为鸿蒙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(用户授权)两种类型。系统授权权限在应用安装时自动授予,而用户授权权限则需要在应用运行时向用户请求授权。

(二)应用所需权限及申请方式

  1. 读取文件权限(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();
  1. 写入文件权限(user_grant)
    当应用需要保存文件或修改文件内容时,需申请ohos.permission.WRITE_EXTERNAL_STORAGE权限。申请方式与读取文件权限类似,同样需要先检查权限状态,未授权时向用户请求授权。

  2. 访问网络权限(system_grant)
    文件上传和下载功能需要访问网络,应用需申请ohos.permission.INTERNET权限。此权限为系统授权类型,在应用的配置文件(如module.json5)中声明即可,系统会在安装时自动授予。

(三)受限开放权限与 ACL 申请(以读取媒体文件为例)

如果应用需要读取用户媒体文件,如图片、音频、视频等,可能涉及受限开放权限。假设读取媒体文件权限为ohos.permission.READ_MEDIA_FILES(实际根据系统定义),且该权限属于受限开放权限。

  1. AGC 申请 Profile 文件
    首先,开发者需要在应用市场(AppGallery Connect,AGC)申请 Profile 文件,并在申请过程中明确申请使用读取媒体文件权限。提供详细的应用使用场景说明,如文件管理器需要读取媒体文件以实现预览、分类管理等功能。

  2. 代码工程中声明权限
    在 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 类型),并处理用户的授权结果。

三、核心功能实现

(一)文件操作功能

  1. 文件读取
    使用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);
}
  1. 文件写入
    通过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);
}
  1. 文件删除、复制和移动
    利用fileIodirectoryIo模块的相关方法实现文件的删除、复制和移动操作。例如,文件删除可以使用unlink()方法,文件复制可以先读取源文件内容,再写入到目标文件,文件移动可以通过先复制再删除源文件的方式实现(需考虑原子性操作以确保数据完整性)。

(二)网络操作功能

  1. 文件上传
    使用httphttps模块(假设鸿蒙 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);
  }
}
  1. 文件下载
    类似地,使用网络请求模块实现文件下载功能。创建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);
  }
}

(三)分享功能

  1. 分享方式选择
    提供多种分享方式,如通过邮件、短信、社交媒体等分享文件。在用户选择分享文件后,弹出分享方式选择界面,让用户选择合适的分享渠道。

  2. 分享实现
    根据用户选择的分享方式,使用相应的系统 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 同行者提供有益的参考和借鉴,激发更多创新应用的开发。

©著作权归作者所有,如需转载,请注明出处,否则将追究法律责任
分类
标签
收藏
回复
举报
回复
    相关推荐