# 兼容性表格导读

兼容性表格用于说明 API、组件、属性及其他功能在不同平台、渲染模式和 UTS 插件中的支持情况。

# 单元格含义

内容 含义
支持
x 不支持
版本号 从该 HBuilderX 或系统版本开始支持
空白 未配置,或不需要单独说明

版本号末尾的 + 在表格中会被省略。例如 4.25+ 显示为 4.25

# 平台列

兼容性表格根据构建目标显示以下平台:

  • Web
  • 微信小程序
  • Android
  • iOS
  • HarmonyOS

App 平台还可能根据实际差异显示:

  • VDOM
  • Vapor
  • VDOM UTS 插件
  • Vapor UTS 插件

# VDOM 与 Vapor

当 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 同时存在支持、不支持或未配置的平台

因此,即使空版本列最终没有显示,页面仍能正确判断该功能是完全支持、不支持还是部分支持。