介绍
本示例介绍利用上传下载
模块和注册自定义字体模块实现从网络上下载字体并注册应用字体的功能,该场景多用于由特殊字体要求的场景。
效果图预览
使用说明
- 进入本案例页面后,可点击下方按钮切换字体。
- 目前仅提供了思源宋体的注册,第一次进入页面点击思源宋体,后台会下载字体文件到沙箱内,然后动态注册并应用到页面对话框。
- 后续进入页面时,因沙箱中已经存在字体文件,点击按钮将会直接切换。
实现思路
本例的实现主要是调用下载接口下载字体文件并且注册到字体库,实现字体动态注册的功能。
本例中代码详情可参考FontDynamicRegistration.ets
1.在点击思源宋体按钮时,将会先检查沙箱中是否存在对应文件,若存在对应字体文件,则直接注册切换字体;若不存在对应字体文件,执行后续下载操作。
typescript
let res = fs.accessSync(filePath);
if (res) {
//字体注册
font.registerFont({
familyName: $r('app.string.font_SourceHanSerif'),
familySrc: DOWNLOADHEADER + filePath
})
this.targetFont = SOURCEHANSERIF;
return;
}
2.若沙箱内没有对应的字体,则会启动下载任务,将字体文件下载到沙箱内并注册应用。
- 下载时监听progress状态对下载进度条及状态变量赋值。
- 监听complete状态对状态变量赋值、提示下载完成及注册字体等操作。
- 监听fail状态对下载失败的情况进行处理(即使删除文件,防止影响后续下载)。
typescript
try {
// TODO :知识点:下载网络文件
request.downloadFile(getContext(), {
url: URL,
filePath: filePath
}, (err, downloadTask) => {
if (err) {
logger.error('Failed to request the download. Cause: ' + JSON.stringify(err));
return;
}
// 监听下载进度,赋值到状态变量
downloadTask.on('progress', (receivedSize, totalSize) => {
this.progressFlag = true;
this.downloadNow = receivedSize;
this.downloadTotal = totalSize;
logger.info("Download receivedSize:" + receivedSize + " totalSize:" + totalSize);
});
// 监听下载完成事件
downloadTask.on('complete', () => {
this.progressFlag = false;
this.downloadButtonText = SOURCE_HAN_SERIF;
this.downloadButtonEnabled = true;
try {
promptAction.showToast({
message: $r('app.string.toast_message'),
duration: TOAST_DURATION
});
} catch (error) {
const message = (error as BusinessError).message;
const code = (error as BusinessError).code;
logger.error(`showToast args error code is ${code}, message is ${message}`);
}
downloadTask.off('progress');
downloadTask.off('fail');
font.registerFont({
familyName: $r('app.string.font_SourceHanSerif'),
familySrc: DOWNLOAD_HEADER + filePath
})
this.targetFont = SOURCE_HAN_SERIF;
})
// 监听下载失败事件
downloadTask.on('fail', (err: number) => {
logger.info("DownloadTask failed");
let res = fs.accessSync(filePath);
if (res) {
fs.unlink(filePath);
downloadTask.off('fail');
}
})
});
} catch (err) {
logger.info("Download failed with error message: " + err.message + ", error code: " + err.code);
}
高性能知识点
不涉及
工程结构&模块类型
fontdynamicregistration // har类型
|---src/main/ets/components
| |---FontDynamicRegistration.ets // 动态切换字体页面及具体逻辑
模块依赖
参考资料
为了让大家都能学习到鸿蒙开发最新的技术,针对一些在职人员、0基础小白、应届生/计算机专业、鸿蒙爱好者等人群,整理了一套纯血版鸿蒙(HarmonyOS Next)全栈开发技术的学习路线【包含了大厂APP实战项目开发】。
本路线共分为四个阶段:
第一阶段:鸿蒙初中级开发必备技能
第二阶段:鸿蒙南北双向高工技能基础: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