harmony 鸿蒙SDK子系统Changelog

2025-06-16
浏览 (4)

SDK子系统Changelog

cl.sdk.1 FA/Stage模型应用使用仅Stage/FA模型可用接口告警级别提升

变更原因

FA/Stage模型中不允许使用仅Stage/FA模型可用接口，应对异常场景进行编译拦截。

变更影响

影响应用编译行为。

变更前：

FA模型中使用仅Stage模型可用接口做应用编译时，给出warn类型告警，提示内容如下：

“This API is used only in Stage Mode, but the current Mode is FA.”

Stage模型中使用仅FA模型可用接口做应用编译时，给出warn类型告警，提示内容如下：

“This API is used only in FA Mode, but the current Mode is Stage.”

变更后：

FA模型中使用仅Stage模型可用接口做应用编译时，给出error类型告警，提示内容如下：

“This API is used only in Stage Mode, but the current Mode is FA.”

Stage模型中使用仅FA模型可用接口做应用编译时，给出error类型告警，提示内容如下：

“This API is used only in FA Mode, but the current Mode is Stage.”

起始 API Level

变更发生版本

从OpenHarmony SDK 5.0.0.24开始。

变更的接口/组件

此变更仅影响编译行为，涉及到的接口及其替换用接口参考《API模型转换清单》

适配指导

若由于FA/Stage模型应用使用仅Stage/FA模型可用接口，导致应用编译报错，可参考如下修改方式：

根据当前报错接口信息，在《API模型转换清单》中查找报错接口，查看该接口在Stage模型下是否存在可替换接口

场景一：仅FA/Stage模型可用接口在Stage/FA模型中存在可替换接口

错误示例：

// 当前工程为Stage模型
import featureAbility from '@ohos.ability.featureAbility';

let context: featureAbility.Context = featureAbility.getContext().getApplicationContext();

正确示例：

// 当前工程为Stage模型
import UIAbility from '@ohos.app.ability.UIAbility';
import common from '@ohos.app.ability.common';

export default class EntryAbility extends UIAbility {
  onCreate() {
    console.log('MyAbility onCreate');
    let applicationContext: common.Context;
    try {
      applicationContext = this.context.getApplicationContext();
    } catch (error) {
      console.error(`getApplicationContext failed, error.code: ${error.code}, error.message: ${error.message}`);
    }
  }
}

场景二：仅FA/Stage模型可用接口在Stage/FA模型中无意义（即无可替代接口），删除相关错误接口调用代码即可。