官方定位

Stage模型是HarmonyOS主推的应用模型，采用面向对象的设计思想，支持多窗口、多设备、分布式能力，是未来HarmonyOS应用开发的标准范式。FA模型已进入维护阶段，新应用建议全部采用Stage模型开发。

import UIAbility from '@ohos.app.ability.UIAbility';
import window from '@ohos.window';
import type AbilityConstant from '@ohos.app.ability.AbilityConstant';
import type Want from '@ohos.app.ability.Want';

export default class EntryAbility extends UIAbility {
  /**
   * Ability创建时调用，全局只调用一次
   * @param want 启动参数
   * @param launchParam 启动参数
   */
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    console.log('Ability onCreate');
    // 全局初始化操作：初始化SDK、配置全局参数等
  }

  /**
   * Ability变为可见时调用
   */
  onWindowStageCreate(windowStage: window.WindowStage): void {
    console.log('Ability onWindowStageCreate');
    // 加载页面，设置UI
    windowStage.loadContent('pages/Index', (err, data) => {
      if (err.code) {
        console.error('加载页面失败', JSON.stringify(err));
        return;
      }
      // 获取窗口实例，设置窗口属性
      windowStage.getMainWindow((err, window) => {
        if (!err) {
          window.setLayoutFullScreen(true); // 全屏显示
        }
      });
    });
  }

  /**
   * Ability进入前台时调用
   */
  onForeground(): void {
    console.log('Ability onForeground');
    // 恢复暂停的操作：恢复动画、重新注册监听等
  }

  /**
   * Ability进入后台时调用
   */
  onBackground(): void {
    console.log('Ability onBackground');
    // 暂停不必要的操作：暂停动画、注销监听、释放资源等
  }

  /**
   * Ability窗口销毁时调用
   */
  onWindowStageDestroy(): void {
    console.log('Ability onWindowStageDestroy');
    // 释放窗口相关资源
  }

  /**
   * Ability销毁时调用
   */
  onDestroy(): void {
    console.log('Ability onDestroy');
    // 全局资源释放：关闭数据库、注销全局监听等
  }
}

@Entry
@Component
struct IndexPage {
  /**
   * 页面创建时调用，每次进入页面都会调用
   */
  aboutToAppear(): void {
    console.log('页面 aboutToAppear');
    // 页面初始化：加载数据、注册页面级监听
  }

  /**
   * 页面布局完成后调用
   */
  onPageShow(): void {
    console.log('页面 onPageShow');
    // 页面显示时的操作：恢复播放、更新数据等
  }

  /**
   * 页面即将隐藏时调用
   */
  onPageHide(): void {
    console.log('页面 onPageHide');
    // 页面隐藏时的操作：暂停播放、保存状态等
  }

  /**
   * 页面销毁时调用
   */
  aboutToDisappear(): void {
    console.log('页面 aboutToDisappear');
    // 页面资源释放：注销监听、取消请求等
  }

  build() {
    Column() {
      Text('首页')
        .fontSize(30)
    }
    .width('100%')
    .height('100%')
  }
}

entry/src/main/
├── ets/                     # 业务代码目录
│   ├── entryability/        # Ability入口
│   │   └── EntryAbility.ets
│   ├── pages/               # 页面文件
│   │   ├── Index.ets
│   │   ├── Login.ets
│   │   └── UserCenter.ets
│   ├── common/              # 公共资源
│   │   ├── components/      # 公共组件
│   │   ├── utils/           # 工具函数
│   │   ├── constants/       # 常量定义
│   │   └── api/             # 网络请求
│   ├── features/            # 业务特性模块
│   │   ├── home/            # 首页模块
│   │   ├── product/         # 商品模块
│   │   └── order/           # 订单模块
│   └── router/              # 路由配置
├── resources/               # 资源文件
│   ├── base/                # 基础资源
│   │   ├── element/         # 字符串、颜色、数值等
│   │   ├── media/           # 图片、音视频等
│   │   └── profile/         # 配置文件
│   ├── en_US/               # 英文资源
│   └── zh_CN/               # 中文资源
└── module.json5             # 模块配置文件

{
  "module": {
    "name": "entry",
    "type": "entry",
    "description": "$string:module_desc",
    "mainElement": "EntryAbility",
    "deviceTypes": [
      "phone",
      "tablet"
    ],
    "deliveryWithInstall": true,
    "installationFree": false,
    "pages": "$profile:main_pages", // 页面路由配置
    "abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ets",
        "description": "$string:EntryAbility_desc",
        "icon": "$media:icon",
        "label": "$string:EntryAbility_label",
        "startWindowIcon": "$media:startIcon",
        "startWindowBackground": "$color:start_window_background",
        "exported": true,
        "skills": [
          {
            "entities": [
              "entity.system.home"
            ],
            "actions": [
              "action.system.home"
            ]
          }
        ]
      }
    ]
  }
}

{
  "src": [
    "pages/Index",
    "pages/Login",
    "pages/UserCenter",
    "pages/product/ProductList",
    "pages/product/ProductDetail",
    "pages/order/OrderList",
    "pages/order/OrderDetail"
  ]
}

import router from '@ohos.router';

// 基础跳转
router.pushUrl({
  url: 'pages/Login'
});

// 带参数跳转
router.pushUrl({
  url: 'pages/product/ProductDetail',
  params: {
    productId: '123456',
    productName: '华为Mate 60 Pro'
  }
});

// 替换当前页面
router.replaceUrl({
  url: 'pages/Home'
});

// 返回上一页
router.back();

// 返回指定页面
router.back({
  url: 'pages/Home'
});

// 清空页面栈并跳转
router.clear();
router.pushUrl({ url: 'pages/Login' });

import router from '@ohos.router';

@Entry
@Component
struct ProductDetailPage {
  @State productId: string = '';
  @State productName: string = '';

  aboutToAppear() {
    // 获取路由参数
    const params = router.getParams() as Record; if (params) { this.productId = params.productId; this.productName = params.productName; } // 根据productId加载商品详情 this.loadProductDetail(this.productId); } loadProductDetail(productId: string) { // 加载商品详情逻辑 } build() { Column() { Text(`商品ID: ${this.productId}`) Text(`商品名称: ${this.productName}`) } .width('100%') .height('100%') } }

import common from '@ohos.app.ability.common';
import abilityAccessCtrl from '@ohos.abilityAccessCtrl';

// 获取全局Context
const context = getContext(this) as common.UIAbilityContext;

// 1. 启动其他Ability
context.startAbility({
  bundleName: 'com.example.myapp',
  abilityName: 'SecondAbility'
});

// 2. 获取资源
const appName = context.resourceManager.getStringSync($r('app.string.app_name').id);
const icon = context.resourceManager.getMediaContentSync($r('app.media.icon').id);

// 3. 权限申请
let atManager = abilityAccessCtrl.createAtManager();
atManager.requestPermissionsFromUser(context, [
  'ohos.permission.INTERNET',
  'ohos.permission.LOCATION'
]).then((result) => {
  console.log('权限申请结果', JSON.stringify(result));
});

// 4. 获取应用信息
const appInfo = context.applicationInfo;
console.log('应用包名', appInfo.bundleName);
console.log('应用版本', appInfo.versionName);

// 5. 获取目录路径
const cacheDir = context.cacheDir; // 缓存目录
const filesDir = context.filesDir; // 文件目录
const tempDir = context.tempDir; // 临时目录

// 在Ability的onCreate中初始化全局状态
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
  // 初始化用户信息
  AppStorage.setOrCreate('userInfo', null); // 初始化登录状态 AppStorage.setOrCreate('isLogin', false); // 初始化主题 AppStorage.setOrCreate('theme', 'light'); } // 在页面中使用全局状态 @Entry @Component struct UserCenterPage { @StorageLink('userInfo') userInfo: UserInfo = null; @StorageLink('isLogin') isLogin: boolean = false; build() { Column() { if (this.isLogin) { Text(`欢迎回来，${this.userInfo?.name}`) Button('退出登录') .onClick(() => { this.logout(); }) } else { Button('去登录') .onClick(() => { router.pushUrl({ url: 'pages/Login' }); }) } } } logout() { // 清除全局状态 AppStorage.set('userInfo', null); AppStorage.set('isLogin', false); // 跳转到登录页 router.clear(); router.pushUrl({ url: 'pages/Login' }); } }

// 在AbilityA中启动AbilityB并传递参数
const context = getContext(this) as common.UIAbilityContext;
context.startAbility({
  bundleName: 'com.example.myapp',
  abilityName: 'AbilityB',
  parameters: {
    userId: '123',
    userName: '张三'
  }
}, (err) => {
  if (err) {
    console.error('启动AbilityB失败', err);
  }
});

// 在AbilityB的onCreate中接收参数
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
  const userId = want.parameters?.userId as string;
  const userName = want.parameters?.userName as string;
  console.log('接收参数', userId, userName);
}

// AbilityB返回结果给AbilityA
// AbilityA中使用startAbilityForResult
context.startAbilityForResult({
  bundleName: 'com.example.myapp',
  abilityName: 'AbilityB'
}).then((result) => {
  console.log('AbilityB返回结果', JSON.stringify(result));
  const code = result.resultCode;
  const data = result.want?.parameters;
});

// AbilityB中设置返回结果
const context = getContext(this) as common.UIAbilityContext;
context.terminateSelfWithResult({
  resultCode: 0, // 0表示成功
  want: {
    parameters: {
      result: '操作成功'
    }
  }
});

// 创建新窗口
import window from '@ohos.window';

const context = getContext(this) as common.UIAbilityContext;
window.createWindow(context, 'second_window', window.WindowType.TYPE_APPLICATION).then((win) => {
  // 设置窗口大小和位置
  win.resize(600, 800);
  win.moveTo(100, 100);
  // 加载页面
  win.loadContent('pages/SecondWindow');
  // 显示窗口
  win.show();
});

// 获取所有窗口
window.getAllWindows().then((windows) => {
  console.log('窗口数量', windows.length);
});

// 关闭指定窗口
window.findWindow('second_window').then((win) => {
  win.destroy();
});

// 路由常量定义
export enum RouterPath {
  HOME = 'pages/Index',
  LOGIN = 'pages/Login',
  USER_CENTER = 'pages/UserCenter',
  PRODUCT_LIST = 'pages/product/ProductList',
  PRODUCT_DETAIL = 'pages/product/ProductDetail'
}

// 路由参数类型定义
export interface ProductDetailParams {
  productId: string;
  productName?: string;
}

// 封装路由工具类
export class RouterUtil {
  /**
   * 跳转到商品详情页
   * @param params 商品参数
   */
  static goToProductDetail(params: ProductDetailParams): void {
    // 登录校验
    if (!AppStorage.get('isLogin')) { router.pushUrl({ url: RouterPath.LOGIN }); return; } // 跳转页面 router.pushUrl({ url: RouterPath.PRODUCT_DETAIL, params: params }); } }

学习建议

Stage模型是HarmonyOS开发的核心，建议开发者深入理解生命周期和Context机制，这是开发稳定可靠应用的基础。多动手实践，结合官方示例理解各种场景的处理方式。