HarmonyOS适老化适配指南

发布日期
2026-03-09
作者
华为
格式
PDF

内容摘要

本指南为华为 HarmonyOS 官方开发者文档，指导应用如何跟随系统字体大小进行适老化适配。

文档首先阐明核心适配原则：在系统使用 1.75 倍及以上大字体时，页面布局不得错乱、组件不得叠加、文字不得截断；图标及图片不随字体放大而变化；不重要的内容字体可采用不跟随系统字体变化或限制最大尺寸的方式布局；若内容挤压或截断，可将横向布局调整为纵向布局（X轴扩展至Y轴）；建议尽量使用已针对适老化大字体单独适配的系统组件。文档详列了系统"关怀模式→放大显示"下的各档位参数：标准（1倍/1倍粗细）、大1档（1.15倍）、大2档（1.3倍）、大3档（1.45倍）、大4档（1.75倍/1.25倍粗细）、大5档（2.0倍）、大6档（3.2倍）。

核心观点

  • 系统支持 7 档字体放大倍率（1× 至 3.2×），应用需确保 1.75× 及以上页面布局不出现错乱或组件重叠。
  • 通过 app.json5→configuration.json 配置 fontSizeScale: followSystem 和 fontSizeMaxScale 实现可控字体跟随。
  • 系统组件已预适配大字体，建议优先使用；自定义组件应充分考虑布局从横向扩展至纵向的兼容方案。
  • 支持多窗口差异化字体跟随和独立配置开关，兼顾适老化需求与界面完整性。

完整目录

  • 概述与适配核心原则
  • 应用适配适老化大字体（路径/各档位参数）
  • 适配方法（app.json5 配置/configutation.json）
  • 进阶适配场景（自定义弹窗/多窗口/独立配置）
下载完整 PDF