兼容性表格用于说明 API、组件、属性及其他功能在不同平台、渲染模式和 UTS 插件中的支持情况。
| 内容 | 含义 |
|---|---|
√ | 支持 |
x | 不支持 |
| 版本号 | 从该 HBuilderX 或系统版本开始支持 |
| 空白 | 未配置,或不需要单独说明 |
版本号末尾的 + 在表格中会被省略。例如 4.25+ 显示为 4.25。
兼容性表格根据构建目标显示以下平台:
App 平台还可能根据实际差异显示:
当 VDOM 和 Vapor 的兼容性存在差异时,表格会拆分显示两个列:
Android(VDOM) 和 Android(Vapor)iOS(VDOM) 和 iOS(Vapor)HarmonyOS(VDOM) 和 HarmonyOS(Vapor)没有必要区分时,VDOM 与 Vapor 会合并为平台名称,例如 Android。
以下 Vapor 默认版本不会单独显示:
| 平台 | 默认 Vapor 版本 |
|---|---|
| Android | 5.21 |
| iOS | 5.11 |
| HarmonyOS | 5.0、5.01 |
只有表格中的每一行都满足合并条件时,才会隐藏 Vapor 列。
当 VDOM 与 Vapor 均为 x 时,也会合并显示,只保留平台列。
如果至少一行存在实际差异,则保留 Vapor 列,并将原平台列重命名为对应的 VDOM 列。
系统版本列只在需要特别说明时显示。
默认系统版本为:
| 平台 | 默认系统版本 |
|---|---|
| Android | 6.0 |
| iOS | 14.0 |
| HarmonyOS | 6.0 |
如果整列均为空或等于默认系统版本,则隐藏该列。低于默认系统版本的值不单独展示。
如果某一列的所有单元格均为空,则该列会被删除。
VDOM、Vapor 和 UTS 插件列都会应用空列过滤,避免生成没有有效信息的表格。
兼容性表格的总体支持状态在删除空列之前计算:
| 状态 | 含义 |
|---|---|
SUPPORTED | 所有平台均支持 |
NOT_SUPPORTED | 所有平台均为 x |
PARTIALLY_SUPPORTED | 同时存在支持、不支持或未配置的平台 |
因此,即使空版本列最终没有显示,页面仍能正确判断该功能是完全支持、不支持还是部分支持。