应用使用API如何在不同系统版本设备上做兼容性保护判断（ArkTS/C++）
======================================

**问题描述**

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

**解决措施**

*   基于ArkTS语言进行API接口兼容性保护
    
    使用[@ohos.deviceInfo (设备信息)](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-device-info)模块的distributionOSApiVersion属性来获取当前设备SDK版本，然后和目标版本进行比对。
    
    例如，下面的示例代码使用了6.0.0(20)版本开始支持的[HdsActionBar](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ui-design-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()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-deviceinfo-h#oh_getdistributionosapiversion)方法获取当前设备SDK版本，然后和目标版本进行比对。
    
    以Native侧的Button组件使用为例。在5.1.1（19）及以上版本时，使用[ArkUI\_ButtonType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-native-type-h#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版本兼容](https://gitcode.com/harmonyos_samples/APILevelAdapt)