鸿蒙5开发宝藏案例分享---应用架构实战技巧

​​大家好！​​ 今天咱们聊聊鸿蒙开发中那些“官方文档提了但实际开发难找”的架构设计技巧。结合官方文档，我会用​​真实代码案例+通俗讲解​​，帮你把分层架构和线程通信落地到项目里，告别“理论会了，代码不会”的尴尬！

一、分层架构：三层设计到底怎么用？

鸿蒙的分层架构（产品定制层、基础特性层、公共能力层）不是空谈，核心是​​降低耦合​​和​​多端复用​​。直接看代码结构：

MyApp/  
│  
├── entry/          # 产品定制层：设备专属入口  
│   ├── phone/      # 手机端UI和逻辑  
│   └── tablet/     # 平板端定制  
│  
├── features/       # 基础特性层：可插拔业务模块  
│   ├── news/       # 新闻模块（独立HAP）  
│   └── settings/   # 设置模块  
│  
└── common/         # 公共能力层  
    ├── components/ # 公共UI组件  
    ├── utils/      # 工具库  
    └── network/    # 网络请求封装  

关键代码示例：

​​1. 公共能力层抽离网络请求​​

// common/network/Request.ts  
export class Request {  
  static async fetch(url: string): Promise<any> {  
    try {  
      const response = await http.createHttp().request(url);  
      return response.data;  
    } catch (err) {  
      // 统一错误处理  
      console.error("Network error:", err);  
    }  
  }  
}  

​​2. 基础特性层调用公共能力​​

// features/news/NewsViewModel.ts  
import { Request } from '../../common/network/Request';  

class NewsViewModel {  
  async loadNews() {  
    const data = await Request.fetch('https://api.news.com/list');  
    // 业务逻辑处理...  
  }  
}  

​​3. 产品定制层按设备加载模块​​

// entry/phone/resources/base/profile/main_pages.json  
{  
  "src": [  
    "pages/PhoneHome",       // 手机首页  
    "pages/NewsPage?module=news" // 动态加载新闻模块  
  ]  
}  

​​为什么这样设计？​​

• 改网络请求？只需动 common/network，不影响业务代码。
• 加新设备（如手表）？复制 entry/phone 改为 entry/watch 定制UI。
• 下架新闻模块？直接移除 features/news 的HAP包。

二、线程通信：子线程如何安全更新UI？

鸿蒙的UI更新必须在主线程（也叫UI线程），但耗时操作（网络请求/数据库读写）需放在子线程。官方推荐用 TaskDispatcher 和 Emitter 通信。

实战场景：子线程获取数据 → 主线程刷新UI

// 在ViewModel中  
import { emitter, TaskDispatcher } from '@ohos.base';  
import { Request } from '../common/network/Request';  

const UI_TASK_DISPATCHER = TaskDispatcher.getGlobalTaskDispatcher(TaskDispatcher.Priority.HIGH);  

class UserViewModel {  
  private userId: string = '';  

  // 1. 子线程获取数据  
  async fetchUserData() {  
    const backgroundTask: TaskDispatcher = TaskDispatcher.createBackgroundTaskDispatcher();  
    backgroundTask.asyncDispatch(() => {  
      const data = Request.fetch(`https://api.user.com/${this.userId}`);  
      // 2. 通过Emitter发送数据到主线程  
      emitter.emit('USER_DATA_LOADED', data);  
    });  
  }  

  // 3. 主线程监听事件  
  setupEventListener() {  
    emitter.on('USER_DATA_LOADED', (data) => {  
      UI_TASK_DISPATCHER.asyncDispatch(() => {  
        // 安全更新UI  
        this.userInfo = data;  
        AppStorage.setOrCreate('userName', data.name); // 绑定到UI组件  
      });  
    });  
  }  
}  

​​避坑指南：​​

• 错误示例：在子线程直接调 AppStorage.set() → 导致UI崩溃。
• 正确姿势：子线程发事件 → 主线程用 asyncDispatch 更新数据。
• 性能优化：高频更新？用 @State + @Watch 局部刷新组件。

三、模块化设计：HAP、HAR、HSP怎么选？

官方文档总提这些概念，实际开发这样用：

​​动态加载HAP模块（常见于插件化）​​

// 在entry中动态加载新闻模块  
import featureAbility from '@ohos.ability.featureAbility';  

const moduleName = 'news';  
featureAbility.dynamicImport(  
  `bundlename:${moduleName}`,   
  (err, data) => {  
    if (err) return;  
    // 加载成功后跳转到新闻页  
    router.pushUrl({ url: 'pages/NewsPage' });  
  }  
);  

四、官方文档没明说的实战技巧

1. ​​公共能力层防“污染”​​：

   • 禁止上层反向依赖：common 不能导入 entry 或 features 的代码。

   • 检查方法：在 build-profile.json 配置依赖关系：

     "dependencies": {  
       "features/news": ">=1.0.0",  
       "common": ">=1.0.0"  
     }  
     

2. ​​多设备适配杀手锏​​：
   用 资源限定词 区分设备，如：

   • news_page.phone.ets → 手机版新闻页
   • news_page.tablet.ets → 平板版（大屏布局）
     编译时自动匹配设备类型打包！

结尾

鸿蒙的分层和模块化设计，初期搭建费点劲，但后期维护真香！建议大家：

1. 公共代码坚决下沉到 common 层；
2. 子线程操作后，​​必须用Emitter回主线程更新UI​​；
3. 新功能尽量拆成HAP，方便热更新。

遇到坑？欢迎留言讨论。

​​保持封装，拒绝耦合，咱们下期见！​​ 🚀