OpenHarmony实战开发：FA模型切换Stage模型（组件切换）

往期鸿蒙全套实战精彩文章必看内容：

• 鸿蒙开发核心知识点，看这篇文章就够了

• 最新版！鸿蒙HarmonyOS Next应用开发实战学习路线

• 鸿蒙HarmonyOS NEXT开发技术最全学习路线指南

• 鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）

---

PageAbility切换

FA模型中PageAbility对应Stage模型中的UIAbility，PageAbility切换为UIAbility的方法如下。

1. 在Stage应用中创建UIAbility。

2. 将FA应用中PageAbility的代码迁移到新创建的UIAbility中。 FA应用中PageAbility和Stage应用中的UIAbility生命周期基本一致，两者的生命周期详细对比见下表。

   FA的PageAbility	Stage的UIAbility	对应关系描述
   onCreate(): void	onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void	两者的意义和调用时机一致，Stage模型在回调中新增了参数，方便开发者在创建的时候获取启动相关的数据。
   NA	onWindowStageCreate(windowStage: window.WindowStage): void	Stage模型新增，窗口创建时由系统回调。
   onActive(): void	on(eventType: ‘windowStageEvent’, callback: Callback<WindowStageEventType>): void; WindowStageEventType.ACTIVE	两者的意义和调用时机一致。Stage模型下移动到了窗口对象中。
   onShow(): void	onForeground(): void	两者的意义和调用时机一致，参数也一致。
   onNewWant(want: Want): void	onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void	两者的意义和调用时机一致，Stage模型多了LaunchParam参数来告知应用启动原因。
   onInactive(): void	on(eventType: ‘windowStageEvent’, callback: Callback<WindowStageEventType>): void; WindowStageEventType.INACTIVE	两者的意义和调用时机一致。Stage模型下移动到了窗口对象中。
   onHide(): void	onBackground(): void	两者的意义和调用时机一致，参数也一致。
   NA	onWindowStageDestroy(): void	Stage模型新增，窗口销毁时由系统回调。
   onDestroy(): void	onDestroy(): void	两者的意义和调用时机一致，参数也一致。

   

3. 对迁移过来的代码进行调整，主要有以下两部分。 1、指定加载页面的方式不同。

   • 在FA模型中，通过在config.json中设置页面信息来配置需要加载的页面。
   • 在Stage模型中，则是通过在onWindowStageCreate回调中调用windowStage.loadContent实现对页面的加载。

   例如，开发者希望Ability启动后加载"pages/Index"页面，在FA模型中，开发者需要在config.json中加入如下代码：

   "pages" : [
       "pages/Index"
   ]
   

   在Stage模型中，则在MainAbility中实现如下接口：

    import Window from '@ohos.window'；
    import UIAbility from '@ohos.app.ability.UIAbility';
   
    export default class EntryAbility extends UIAbility {
      onWindowStageCreate(windowStage: Window.WindowStage) {
        // Main window is created, set main page for this ability
        windowStage.loadContent('pages/Index', (err, data) => {
          if (err.code) {
            console.error("loadContent failed")
            return;
          }
        });
      }
    }
   

2、在resources/base/profile/main_pages.json中配置页面，以"pages/Index"为例:

{
  "src": [
    "pages/Index"
  ]
}

ServiceAbility切换

FA模型中的ServiceAbility对应Stage模型中的ServiceExtensionAbility。Stage模型下的ServiceExtensionAbility为系统API，只有系统应用才可以创建。因此，FA模型的ServiceAbility的切换，对于系统应用和三方应用策略有所不同。下面分别介绍这两种场景。

系统应用ServiceAbility切换

目前系统提供了ServiceExtensionAbility供系统应用使用。切换步骤和PageAbility基本一致。

1. 在Stage应用中创建ServiceExtensionAbility。

2. 将FA应用中ServiceAbility的业务代码迁移到新创建的ServiceExtensionAbility中。 ServiceAbility和ServiceExtensionAbility生命周期对比见下表。

   FA的ServiceAbility	Stage的ServiceExtensionAbility	对比描述
   onStart(): void	onCreate(want: Want): void	两者调用时机一致，Stage模型下增加了入参want以便开发者在创建时获取参数。
   onCommand(want: Want, startId: number): void	onRequest(want: Want, startId: number): void	两者意义和调用时机一致，参数也一致。
   onConnect(want: Want): rpc.RemoteObject	onConnect(want: Want): rpc.RemoteObject	两者意义和调用时机一致，参数也一致。
   onDisconnect(want: Want): void	onDisconnect(want: Want): void	两者意义和调用时机一致，参数也一致。
   onReconnect(want: Want): void	onReconnect(want: Want): void	两者意义和调用时机一致，参数也一致。
   onStop(): void	onDestroy(): void	两者意义和调用时机一致，参数也一致。

三方应用ServiceAbility切换

Stage模型下三方应用不能对其他三方提供服务，应用可以根据具体业务选择切换方案。

业务类型	切换策略
对其他三方应用提供服务	需根据业务场景匹配到系统对应的场景化ExtensionAbility。
应用内：前台运行时公共使用	可以将该组件代码抽取成公共模块供其他组件使用。
应用内：进入后台时继续运行	可以将此服务切换为后台任务。

DataAbility切换

FA模型中的DataAbility对应Stage模型中的DataShareExtensionAbility。

与ServiceExtensionAbility类似，Stage模型下的DataShareExtensionAbility为系统API，只有系统应用才可以创建。因此，FA模型的DataAbility的切换，对于系统应用和三方应用策略有所不同。下面分别介绍这两种场景。

系统应用DataAbility切换至DataShareExtensionAbility

迁移步骤和PageAbility基本一致。

1. 在Stage应用中创建DataShareExtensionAbility。

2. 将FA应用中DataAbility的业务代码迁移到新创建的DataShareExtensionAbility中。 DataAbility和DataShareExtensionAbility生命周期对比见下表。

   FA的DataAbility	Stage的DataShareExtensionAbility	对比描述
   onInitialized?(info: AbilityInfo): void	onCreate?(want: Want, callback: AsyncCallback<void>): void	两者调用时机一致，函数名即入参都不一样，Stage模型下增加了入参want以便开发者在创建时获取参数。
   update?(uri: string, valueBucket: rdb.ValuesBucket, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback<number>): void	update?(uri: string, predicates: dataSharePredicates.DataSharePredicates, value: ValuesBucket, callback: AsyncCallback<number>): void	两者意义和调用时机一致，参数顺序和参数类型略有不同，需要简单改造。
   query?(uri: string, columns: Array<string>, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback<ResultSet>): void	query?(uri: string, predicates: dataSharePredicates.DataSharePredicates, columns: Array<string>, callback: AsyncCallback<Object>): void;	两者意义和调用时机一致，参数顺序和参数类型略有不同，需要简单改造。
   delete?(uri: string, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback<number>): void	delete?(uri: string, predicates: dataSharePredicates.DataSharePredicates, callback: AsyncCallback<number>):	两者意义和调用时机一致，参数类型略有不同，需要简单改造。
   normalizeUri?(uri: string, callback: AsyncCallback<string>): void	normalizeUri?(uri: string, callback: AsyncCallback<string>): void	两者意义和调用时机一致，参数也一致。
   batchInsert?(uri: string, valueBuckets: Array<rdb.ValuesBucket>, callback: AsyncCallback<number>): void	batchInsert?(uri: string, values: Array<ValuesBucket>, callback: AsyncCallback<number>): void	两者意义和调用时机一致，参数类型略有不同，需要简单改造。
   denormalizeUri?(uri: string, callback: AsyncCallback<string>): void	denormalizeUri?(uri: string, callback: AsyncCallback<string>): void	两者意义和调用时机一致，参数也一致。
   insert?(uri: string, valueBucket: rdb.ValuesBucket, callback: AsyncCallback<number>): void	insert?(uri: string, value: ValuesBucket, callback: AsyncCallback<number>): void	两者意义和调用时机一致，参数类型略有不同，需要简单改造。
   openFile?(uri: string, mode: string, callback: AsyncCallback<number>): void	NA	Stage模型不支持uri跨进程访问，建议通过want携带FD和文件信息进行跨进程文件访问。
   getFileTypes?(uri: string, mimeTypeFilter: string, callback: AsyncCallback<Array<string>>): void	NA	Stage模型不支持uri跨进程访问，建议通过want携带FD和文件信息进行跨进程文件访问。
   getType?(uri: string, callback: AsyncCallback<string>): void	NA	Stage模型不支持uri跨进程访问，建议通过want携带FD和文件信息进行跨进程文件访问。
   executeBatch?(ops: Array<DataAbilityOperation>, callback: AsyncCallback<Array<DataAbilityResult>>): void	NA	DataShareExtensonAbility不提供该接口，开发者需根据业务功能重新实现。
   call?(method: string, arg: string, extras: PacMap, callback: AsyncCallback<PacMap>): void	NA	DataShareExtensonAbility不提供该接口，开发者需根据业务功能重新实现。

三方应用DataAbility改造为公共模块

Stage模型三方应用不能对其他三方提供数据，应用需要根据具体业务选择切换方案。

DataAbility业务类型	切换DataShareExtension策略
对三方提供数据	需根据业务场景匹配到系统对应的场景化ExtensionAbility。
应用内使用的数据	对应用内其他组件提供数据，建议提取公共模块。

看完三件事❤️

• 如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：
• 点赞，转发，有你们的 『点赞和评论』，才是我创造的动力。
• 关注作者 ，不定期分享原创知识。
• 同时可以期待后续文章ing🚀。   ​