目录

API兼容性保护判断常见问题

Q：例如，应用某个特性使用了6.0.0(20)版本的API，那么在低版本设备（如5.0.0(17)版本）上如何做兼容性保护？

A：解决措施如下：

基于ArkTS语言进行API接口兼容性保护

使用@ohos.deviceInfo (设备信息)模块的distributionOSApiVersion属性来获取当前设备SDK版本，然后和目标版本进行比对。

例如，下面的示例代码使用了6.0.0(20)版本开始支持的HdsActionBar组件。在6.0.0(20)及以上版本时，使用HdsActionBar组件来实现操作栏组件；在6.0.0(20)以下版本时，采用Row和Button组件的组合方式来实现。

NavDestination() {
  Column() {
    // Regarding the proprietary interfaces of HarmonyOS, specifically the interfaces marked as since M.F.S(N).
    // Compatibility judgment, the value corresponding to version 6.0.0(20) is 60000,
    // which is derived from the new interface's since field 6*10000 + 0*100 + 0.
    if (deviceInfo.distributionOSApiVersion >= 60000) {
      // Component that calls the API of version 6.0.0(20)
      HdsActionBar({
        startButtons: [new ActionBarButton({
          baseIcon: $r('sys.symbol.stopwatch_fill')
        })],
        endButtons: [new ActionBarButton({
          baseIcon: $r('sys.symbol.mic_fill')
        })],
        // ...
      })
    } else {
      // Downgrading plan
      Row({ space: 25 }) {
        // ...
      }
      // ...
    }
  }
  // ...
}
.title($r('app.string.action_bar_scene'))
.backgroundColor($r('app.color.common_backgroundColor'))

基于C++语言进行API接口兼容性保护

使用OH_GetDistributionOSApiVersion()方法获取当前设备SDK版本，然后和目标版本进行比对。

以Native侧的Button组件使用为例。在5.1.1（19）及以上版本时，使用ArkUI_ButtonType枚举的ARKUI_BUTTON_ROUNDED_RECTANGLE设置Button圆角效果；在5.1.1（19）以下版本时，使用ARKUI_BUTTON_TYPE_CAPSULE设置Button圆角效果。

std::shared_ptr<ArkUIBaseNode> CreateButtonExample()
{
    auto textNode = std::make_shared<ArkUIButtonNode>();
    textNode->SetTextContent(std::string("Hello World"));
    // ...
    // Regarding the proprietary interfaces of HarmonyOS, specifically the interfaces marked as since M.F.S(N).
    // Compatibility judgment, the value corresponding to version 5.1.1(19) is 50101,
    // which is derived from the new interface's since field 5*10000 + 1*100 + 1.
    if (OH_GetDistributionOSApiVersion() >= MIN_API_VERSION_5_1_1) {
        textNode->SetButtonType(ARKUI_BUTTON_ROUNDED_RECTANGLE);
    } else {
        textNode->SetButtonType(ARKUI_BUTTON_TYPE_CAPSULE);
    }
    return textNode;
}

void ArkUIButtonNode::SetButtonType(int32_t buttonType)
{
    assert(handle_);
    ArkUI_NumberValue value[] = {{.i32 = buttonType}};
    ArkUI_AttributeItem item = {value, 1};
    nativeModule_->setAttribute(handle_, NODE_BUTTON_TYPE, &item);
}

参考链接：实现多API版本兼容。