Qt 5.15 Android开发如何解决多设备界面可扩展性适配问题

我这边做Qt for Android商业项目快5年，适配过从4.7寸老安卓机到折叠屏、工业平板在内的近200款设备，你提到的两种网传方案我都踩过坑，下面是实际生产环境验证过的通用解法：

核心基准配置（全局通用） #

先明确两个常见方案的本质问题：

• 那种拿Screen.height / 固定小数写尺寸的方式，本质是开发者拿自己手头测试机的分辨率倒推的硬编码系数，换个屏幕比例（比如现在常见的20:9长屏、折叠屏展开的4:3方屏）直接变形，完全不具备通用性，不建议用。
• 直接拿Screen.pixelDensity *25.4算DPI的方案失效，是因为这个值取的是屏幕物理像素密度，而安卓系统实际渲染用的是厂商校准过的逻辑DPI——很多定制ROM会默认调整系统DPI、支持用户自定义字体/显示大小，物理DPI和实际渲染密度偏差能到30%以上，算出来的尺寸自然不对。

全局统一在ApplicationWindow下定义这几个只读属性，全项目复用即可：

readonly property real designBaseDp: 360 // 采用安卓通用的360dp宽度设计基准，和安卓原生开发基准对齐
readonly property real logicalDpi: Screen.logicalDensity * 160 // 取系统校准后的逻辑DPI，不用物理DPI
readonly property real dpScale: Screen.width / (designBaseDp * Screen.logicalDensity) // 宽度等比缩放系数
readonly property real spScale: dpScale * Screen.fontScale // 字体专用缩放系数，自动适配系统字体大小设置

分场景适配规则 #

• 布局优先用Qt Quick Layouts（RowLayout/ColumnLayout/GridLayout）+ anchors做相对定位，哪怕是只有logo、2-3个输入框的登录页也适用：logo设置水平居中、顶部相对安全区做偏移，输入框和按钮做水平居中、宽度限制在设计稿比例范围内，比硬编码坐标适配效率高很多。遇到平板、折叠屏这类宽屏设备，加个简单断点：当计算后屏幕宽度大于600dp时，给内容区设置最大宽度720dp居中显示，不要把控件拉满整屏，避免操作体验变差。
• 所有margin、padding、控件静态尺寸，统一用设计稿标注值 * dpScale计算，比如设计稿标注输入框高度48dp、左右边距24dp，直接写：

TextField {
    height: 48 * dpScale
    anchors.leftMargin: 24 * dpScale
    anchors.rightMargin: 24 * dpScale
    font.pixelSize: 16 * spScale
}

• 异形屏（挖孔屏、曲面屏、带虚拟导航键的设备）不要自己算安全区，直接取Qt暴露的系统安全区insets值，所有可交互控件都放在安全区内，避免被状态栏、导航键遮挡。
• 图标资源完全不用自己处理缩放，按照Qt的资源命名规则放对应倍率的@2x/@3x资源即可，底层自动匹配加载的清晰度比手动缩放好很多。

常见踩坑点 #

• 不要用全局整页scale的方案：很多人为了省事直接把整个根Item按屏幕宽高比缩放，会导致长屏上控件拉伸变形、字体发虚，只对尺寸、边距做等比计算，布局保持相对关系即可。
• 自绘控件（Canvas、继承QQuickPaintedItem的自定义控件）要手动给绘制尺寸乘dpScale，否则会出现原生控件尺寸正常、自绘内容忽大忽小的问题。
• 不要混用px和dp单位，项目里统一用上面的dpScale做换算，避免不同人写的控件尺寸逻辑不一致。

内容的提问来源于stack exchange，提问作者Deymos s