PageAbility切换


PageAbility切换

FA模型中PageAbility对应Stage模型中的UIAbility。切换步骤如下。

  1. 在Stage应用中创建UIAbility

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

    FA的PageAbility Stage的UIAbility 对应关系描述
    onCreate(): void onCreate(want: Want, param: 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, launchParams: 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 两者的意义和调用时机一致,参数也一致。

    pageability-switch

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

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

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

    "pages" : [
        "pages/Index"
    ]
    
    1
    2
    3

    在Stage模型中,则在MainAbility中实现如下接口:

    import Window from '@ohos.window'
    
    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;
            }
        });
    }
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11