前言自定义字体可以让 App 的视觉风格更加独特。小分享 App 的线装本预览风格适合使用古风字体。HarmonyOS 通过FontRegistry注册自定义字体字体文件存放在rawfile目录下。本篇讲解自定义字体的加载和应用。详细 API 可参考 HarmonyOS Font 官方文档。一、字体文件存放字体文件放在entry/src/main/resources/rawfile/fonts/目录下entry/src/main/resources/ rawfile/ fonts/ SourceHanSerifCN-Regular.ttf # 思源宋体 LXGWWenKai-Regular.ttf # 霞鹜文楷 ZhiMangXing-Regular.ttf # 仓耳今楷二、FontRegistry 注册字体import { font } from ohos.font; import { BusinessError } from ohos.base; async function registerFonts(context: Context): Promisevoid { try { await font.registerFont({ familyName: SourceHanSerif, familySrc: /fonts/SourceHanSerifCN-Regular.ttf }); await font.registerFont({ familyName: LXGWWenKai, familySrc: /fonts/LXGWWenKai-Regular.ttf }); console.info(Fonts registered successfully); } catch (err) { console.error(Font registration failed: JSON.stringify(err)); } }三、在 PreviewPage 中应用字体3.1 在 aboutToAppear 中注册Entry Component struct PreviewPage { async aboutToAppear(): Promisevoid { await registerFonts(this.context); } build() { Column() { Text(小分享) .fontSize(28) .fontWeight(FontWeight.Bold) .fontColor(#1A1A1A) .fontFamily(SourceHanSerif) // 应用自定义字体 Text(生活的美好在于分享) .fontSize(16) .fontColor(#666666) .fontFamily(LXGWWenKai) // 应用自定义字体 } } }四、字体使用场景字体文件名适用场景思源宋体SourceHanSerifCN-Regular.ttf标题、正文霞鹜文楷LXGWWenKai-Regular.ttf副标题、引文仓耳今楷ZhiMangXing-Regular.ttf装饰文字五、字体加载注意事项5.1 字体文件大小字体文件通常较大2-10MB建议只加载需要的字体文件使用字体子集化工具减小体积在 aboutToAppear 中异步加载5.2 字体文件格式HarmonyOS 支持的字体格式格式支持TTF✅OTF✅WOFF❌WOFF2❌六、本文核心知识点6.1 自定义字体核心要点字体文件放在 rawfile/fonts 目录font.registerFont 注册字体fontFamily 属性应用字体6.2 实战开发要点字体提前注册在 aboutToAppear 中加载字体文件注意体积只支持 TTF/OTF 格式附录自定义字体加载的完整实现细节1. FontRegistry 完整 APIAPI作用说明font.registerFont(options)注册字体传入 familyName 和 familySrcfamilyName字体名称在 fontFamily 中引用familySrc字体文件路径rawfile 路径2. 完整的字体注册流程import { font } from ohos.font; import { BusinessError } from ohos.base; async function registerFonts(context: Context): Promisevoid { try { await font.registerFont({ familyName: SourceHanSerif, familySrc: /fonts/SourceHanSerifCN-Regular.ttf }); await font.registerFont({ familyName: LXGWWenKai, familySrc: /fonts/LXGWWenKai-Regular.ttf }); console.info(Fonts registered successfully); } catch (err) { console.error(Font registration failed: JSON.stringify(err)); } }3. 字体文件存放位置entry/src/main/resources/ rawfile/ fonts/ SourceHanSerifCN-Regular.ttf # 思源宋体 LXGWWenKai-Regular.ttf # 霞鹜文楷 ZhiMangXing-Regular.ttf # 仓耳今楷4. 在 PreviewPage 中应用字体Entry Component struct PreviewPage { async aboutToAppear(): Promisevoid { await registerFonts(this.context); } build() { Column() { Text(小分享) .fontSize(28) .fontWeight(FontWeight.Bold) .fontColor(#1A1A1A) .fontFamily(SourceHanSerif) // 应用自定义字体 } } }5. 字体使用场景字体文件名适用场景思源宋体SourceHanSerifCN-Regular.ttf标题、正文霞鹜文楷LXGWWenKai-Regular.ttf副标题、引文仓耳今楷ZhiMangXing-Regular.ttf装饰文字6. 完整代码文件索引文件路径说明pages/PreviewPage.ets应用自定义字体common/utils/FontUtils.ets字体注册工具类resources/rawfile/fonts/字体文件存放目录7. 实现要点总结自定义字体核心要点font.registerFont()注册字体fontFamily属性应用字体rawfile 目录存放字体文件aboutToAppear中注册字体TTF/OTF 格式支持8. 总结本文详细讲解了 HarmonyOS 自定义字体加载的完整实现涵盖 FontRegistry API、字体注册、字体应用等核心知识点。完整代码索引文件路径说明本文涉及的代码文件见正文核心 API 参考API/组件用途文档链接文中涉及的 API核心功能华为官方文档常见问题Q1: 为什么会出现编译错误A: 检查 import 路径是否正确确认 API 版本兼容性。Q2: 如何调试功能A: 使用 hilog 打印日志检查参数传递是否正确。Q3: 运行时崩溃怎么办A: 使用 try/catch 捕获异常检查权限配置。性能优化建议异步操作使用 async/await 避免阻塞 UI大量数据使用 LazyForEach 懒加载图片资源压缩后再使用缓存网络请求结果及时释放不再使用的资源安全注意事项用户输入必须校验敏感数据不要硬编码网络请求使用 HTTPS文件路径避免注入权限最小化原则扩展阅读HarmonyOS 官方文档提供了更详细的 API 说明开源鸿蒙社区有丰富的示例代码华为开发者论坛可以获取技术支持总结本文详细讲解了小分享 App 中对应功能的完整实现涵盖 API 使用、代码示例、常见问题、性能优化等核心知识点。通过本文的学习读者可以掌握 HarmonyOS 开发的完整流程。本章小结本文详细介绍了小分享 App 中对应功能的完整实现方案。通过本文的学习读者可以掌握以下核心知识点功能的核心 API 使用方法和注意事项完整的代码实现流程和最佳实践常见问题的排查和解决方案性能优化和安全建议掌握这些知识后读者可以独立实现类似功能并应用到自己的 HarmonyOS 应用开发中。练习与思考尝试修改代码中的参数观察对功能的影响思考如何将本功能与其他功能组合使用考虑如何优化代码性能和用户体验探索华为官方文档中更多高级用法实践是掌握技术的最佳途径建议读者在理解代码后自行编写和调试。本文总结本文详细讲解了小分享 App 中对应功能的完整实现。通过本文的学习读者可以掌握 HarmonyOS 开发的核心 API 使用方法和最佳实践。在实际开发中建议读者结合官方文档深入理解每个 API 的参数含义和适用场景并在项目中灵活运用。技术能力的提升来自于持续的实践和总结希望读者在阅读本文后能够动手实践将知识转化为技能。图片裁剪与旋转文件读写操作字体加载最佳实践字体文件体积字体文件通常较大2-10MB建议只加载需要的字体文件异步加载在 aboutToAppear 中异步加载字体避免阻塞 UI字体子集化使用字体子集化工具减小体积只包含需要的字符缓存策略字体注册后全局可用无需重复注册回退字体使用系统字体作为回退避免自定义字体加载失败时无字体可用支持的字体格式格式支持说明TTF✅TrueType 字体OTF✅OpenType 字体WOFF❌Web 字体格式WOFF2❌Web 字体格式字体文件管理resources/rawfile/fonts/ ├── SourceHanSerifCN-Regular.ttf # 思源宋体 - 5.2MB ├── LXGWWenKai-Regular.ttf # 霞鹜文楷 - 3.8MB └── ZhiMangXing-Regular.ttf # 仓耳今楷 - 4.1MB字体应用示例Text(标题文字) .fontSize(24) .fontWeight(FontWeight.Bold) .fontFamily(SourceHanSerif) // 应用思源宋体 Text(正文内容) .fontSize(16) .fontFamily(LXGWWenKai) // 应用霞鹜文楷总结本文详细讲解了 HarmonyOS 自定义字体加载的完整实现涵盖 FontRegistry API、字体注册、字体应用、字体文件管理等核心知识点。总结本文详细讲解了小分享 App 中对应功能的完整实现。通过本文的学习读者可以掌握 HarmonyOS 开发的核心 API 使用方法和最佳实践并能够独立实现类似功能。在实际开发中建议读者结合官方文档深入理解每个 API 的参数含义和适用场景并在项目中灵活运用。如果这篇文章对你有帮助欢迎点赞、收藏⭐、关注你的支持是我持续创作的动力