鸿蒙 NEXT 开发 - 用户通知服务的封装和文件下载通知
作者：东林知识库
- 2025-03-31 江苏
本文字数：4487 字
阅读完需：约 15 分钟
1. 用户通知服务基本介绍
Notification Kit（用户通知服务）为开发者提供本地通知发布通道，开发者可借助 Notification Kit 将应用产生的通知直接在客户端本地推送给用户，本地通知根据通知类型及发布场景会产生对应的铃声、震动、横幅、锁屏、息屏、通知栏提醒和显示。
2. 能力范围
Notification Kit 支持的能力主要包括:
发布文本、进度条等类型通知。
携带或更新应用通知数字角标。
取消曾经发布的某条或全部通知。
查询已发布的通知列表。
查询应用自身通知开关状态。
应用通知用户的能力默认关闭，开发者可拉起授权框，请求用户授权发布通知。
编辑
3. 业务流程
编辑
使用 Notification Kit 的主要业务流程如下：
1.请求通知授权。
2.应用发布通知到通知服务。
3.将通知展示到通知中心。
Notification Kit 中常用的通知样式如下：
编辑
注意：
单个应用已发布的通知在通知中心等系统入口的留存数量有限（当前规格最多 24 条）。
通知的长度不能超过 200KB（跨进程序列化大小限制）。
系统所有应用发布新通知的频次累计不能超过每秒 10 条，更新通知的频次累计不能超过每秒 20 条。
官方文档地址：文档中心
4. 用户通知服务-工具类封装小案例
4.1 基本介绍
通过案例我们能学习到：用户通知服务还有部分文件服务基础能力工具类的封装，教大家如何进行工具类封装。
主体功能：用户点击下载文件按钮，触发通知，也可以取消通知
4.2 操作环境
记得在 module.json 文件中配置网络权限
"requestPermissions":[ { "name" : "ohos.permission.INTERNET", "reason": "$string:internet", "usedScene": { "abilities": [ "FormAbility" ], "when":"inuse" } } ],
复制代码
4.3 代码实现
界面如下：
编辑
4.3.1 文本通知工具类
NotificationUtil.ets
import { notificationManager } from '@kit.NotificationKit';import { common } from '@kit.AbilityKit';import { BusinessError } from '@kit.BasicServicesKit';
export class NotificationUtil { /** * 查询通知是否授权 */ static async isNotificationEnabled(): Promise<boolean> { return await notificationManager.isNotificationEnabled(); //查询通知是否授权。 }
/** * 请求通知授权，第一次调用会弹窗让用户选择。 * @returns */ static async authorizeNotification(): Promise<boolean> { let isEnabled = await NotificationUtil.isNotificationEnabled(); //查询通知是否授权 if (!isEnabled) { //未授权，拉起授权 try { let context = getContext() as common.UIAbilityContext; await notificationManager.requestEnableNotification(context); return true; } catch (e) { return false; } } else { return true; } }
/** * 发起普通文本通知 */ static publishText(notificationOptions: NotificationOptions): Promise<boolean> { return new Promise<boolean>((resolve, reject) => { let notificationRequest: notificationManager.NotificationRequest = { // 通知的唯一id id: notificationOptions.id, content: { notificationContentType: notificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT, // 普通文本类型通知 normal: { // 通知的标题 title: notificationOptions.title, // 通知的内容 text: notificationOptions.text, // 附加消息 additionalText: notificationOptions.additionalText, } } }; notificationManager.publish(notificationRequest, (err: BusinessError) => { if (err) { console.log(`Failed to publish notification. Code is ${err.code}, message is ${err.message}`) reject(err) } console.log('Succeeded in publishing notification.') resolve(true) }); }) }
/** * 取消通知 */ static cancel(id: number): Promise<boolean> { return new Promise<boolean>((resolve, reject) => { notificationManager.cancel(id, (err: BusinessError) => { if (err) { console.log(`Failed to cancel notification. Code is ${err.code}, message is ${err.message}`) reject(err) } console.log('Succeeded in cancel notification.') resolve(true) }); }) }
/** * 取消所有通知 */ static cancelAll(): Promise<boolean> { return new Promise<boolean>((resolve, reject) => { notificationManager.cancelAll((err: BusinessError) => { if (err) { console.log(`Failed to cancel notification. Code is ${err.code}, message is ${err.message}`) reject(err) } console.log('Succeeded in cancel notification.') resolve(true) }); }) }}
interface NotificationOptions { id: number title: string text: string additionalText: string
}
复制代码
4.3.2 文件通知工具类
FileUtil.ets
import { common } from '@kit.AbilityKit';import fs from '@ohos.file.fs';import request from '@ohos.request';import { BusinessError } from '@ohos.base';
let context = getContext(this) as common.UIAbilityContext;
export class FileUtil { /** * 判断文件是否存在 */ static isExist(fileName: string, fileSuffix: string) { // 判断文件是否存在，存在就删除 let path = context.filesDir + '/' + fileName + '.' + fileSuffix; if (fs.accessSync(path)) { fs.unlinkSync(path); } }
/** * 下载文件 */ static downloadFile(fileName: string, fileSuffix: string, fileUrl: string): Promise<boolean> { return new Promise<boolean>((resolve, reject) => { // 判断文件是否已存在 FileUtil.isExist(fileName, fileSuffix) request.downloadFile(context, { url: fileUrl, filePath: context.filesDir + '/' + fileName + '.' + fileSuffix }).then((downloadTask: request.DownloadTask) => { downloadTask.on('complete', () => { resolve(true) }) }).catch((err: BusinessError) => { console.error(`Invoke downloadTask failed, code is ${err.code}, message is ${err.message}`); reject(err) }); }) }}
复制代码
4.3.3 页面的编写
Index.ets
import { NotificationUtil } from '../utils/NotificationUtil'import { promptAction } from '@kit.ArkUI'import { BusinessError } from '@kit.BasicServicesKit'import { FileUtil } from '../utils/FileUtil'
@Entry @Component struct Index { build() { Column({ space: 20 }) {
Button('发起通知') .onClick(async () => { // 发起通知授权 let isSuccess = await NotificationUtil.authorizeNotification() if (isSuccess) { // 发起通知 NotificationUtil.publishText({ id: 1, title: '百得知识库', text: '百得知识库提醒你该学习了', additionalText: '百得' }) .then(() => { promptAction.showToast({ message: '发起通知成功' }) }).catch((error: BusinessError) => { promptAction.showToast({ message: '发起通知失败' + error.message }) }) } else { promptAction.showToast({ message: '通知授权失败' }) } }).margin(100)
Button('取消通知') .onClick(async () => { let flag = await NotificationUtil.cancel(1) if (flag) { promptAction.showToast({ message: '取消通知成功' }) return } promptAction.showToast({ message: '取消通知失败' }) })
Button('取消所有通知') .onClick(async () => { let flag = await NotificationUtil.cancelAll() if (flag) { promptAction.showToast({ message: '取消所有通知成功' }) return } promptAction.showToast({ message: '取消所有通知失败' }) }).margin(100)
Button('下载文件完成通知') .onClick(() => { FileUtil.downloadFile('hello', 'txt', 'http://121.41.123.231:8888/f/e01ace4294264594b632/?dl=1') .then(async (data) => { promptAction.showToast({ message: '文件下载成功' }) // 发起通知授权 let isSuccess = await NotificationUtil.authorizeNotification() if (isSuccess) { // 发起通知 NotificationUtil.publishText({ id: 2, title: '百得知识库', text: '文件下载成功', additionalText: '百得' }) .then((data) => { if (data) { promptAction.showToast({ message: '发起通知成功' }) return } promptAction.showToast({ message: '发起通知失败' }) }).catch((error: BusinessError) => { promptAction.showToast({ message: '发起通知失败' + error.message }) }) } else { promptAction.showToast({ message: '通知授权失败' }) } }) .catch((error: BusinessError) => { promptAction.showToast({ message: '文件下载失败' + error.message }) }) }) } .height('100%') .width('100%') .justifyContent(FlexAlign.Center) } }
复制代码
划线
评论
复制
发布于: 2 小时前阅读数: 10
版权声明: 本文为 InfoQ 作者【东林知识库】的原创文章。
原文链接:【http://xie.infoq.cn/article/e40ae8e5703cd76993bcefd9d】。文章转载请联系作者。
东林知识库
关注
享受当下，享受生活，享受成长乐趣！ 2025-02-26 加入
鸿蒙、Java、大数据
评论