【 OpenHarmony 系统应用源码解析 】-- Launcher 初体验

前言

近来因为业务需要，需要做一款 UI 定制的鸿蒙 Launcher，于是就开始了「找到代码」、「研究代码」、「魔改代码」的套路流程，仅以此文章作为知识备份和技能探究所用，也希望能给其他小伙伴提供一些源码的解析思绪，方法大家各自魔改！

---

一、官方简介

Gitee codes：应用子系统/Launcher
Launcher 作为系统人机交互的主要入口，提供应用图标的表现、点击启动、卸载应用，并提供桌面布局设置以及近来使命管理等功能。
Launcher 接纳扩展的 TS 语言（ArkTS）开辟
1.1 主要结构

1.2 分层说明

Module层级说明product业务形态层区分差异产品、差异屏幕的各形态桌面，含有桌面窗口、个性化业务，组件的设置，以及个性化资源包。feature公共特性层抽象的公共特性组件集合，可以被各桌面形态引用。common公共本领层基础本领集，每个桌面形态都必须依靠的模块。 1.3 目录结构

1. /applications/standard/launcher/
2. ├── common                    # 公共能力层目录
3. ├── docs                      # 开发指南
4. ├── feature                   # 公共特性层目录
5. │   └── appcenter             # 应用中心
6. │   └── bigfolder             # 智能文件夹
7. │   ├── form                  # 桌面卡片管理功能
8. │   ├── gesturenavigation     # 手势导航
9. │   ├── pagedesktop           # 工作区
10. │   ├── recents               # 最近任务
11. │   ├── settings              # 桌面设置
12. │   ├── smartdock             # dock工具栏
13. ├── product                   # 业务形态层目录
14. ├── signature                 # 签名证书

复制代码

1.4 开辟调试

IDE 下载：建议大家直接下载 OpenHarmony 4.1 Release DevEco-Studio 吧，API 支持 8 ～ 11。

1.5 SDK

Launcher 应用的编译需使用相对应版本的 ohos-sdk-full \ mac-sdk-full 来举行开辟调试。
IDE 上是 Public SDK，故 full sdk 需要重新下载，下载地址：
新版本界面：http://ci.openharmony.cn/workbench/cicd/dailybuild/dailylist
老版本界面：http://ci.openharmony.cn/dailys/dailybuilds
具体下载及如何替换这边就不啰嗦了，大家直接看 Gitee 介绍自行替换。
1.6 签名设置

关于签名设置，也不啰嗦了，下载的代码自带的文件都已经设置好，无需自己手动签名。
1.7 替换 Launcher

使用以下下令来更新编译出来的 Launcher 部件 hap 包：

1. ren phone_launcher-default-signed.hap Launcher.hap
2. ren launcher_settings-phone_launcher-default-signed.hap Launcher_Settings.hap
4. hdc target mount
5. hdc shell rm -rf /data/misc_de/0/mdds/0/default/bundle_manager_service
6. hdc shell rm -rf /data/accounts
7. hdc shell mount -o remount,rw /
8. hdc file send .\Launcher.hap /system/app/com.ohos.launcher/Launcher.hap
9. hdc file send .\Launcher_Settings.hap /system/app/com.ohos.launcher/Launcher_Settings.hap
11. pause
13. hdc shell mount -o remount,rw /
14. hdc shell rm /data/ -rf
15. hdc shell sync /system/bin/udevadm trigger
16. hdc shell reboot

复制代码

---

二、编译运行

2.1 分支选择

拉完官方示例代码后，可以看到很多分支，我选了 OpenHarmony-4.1-Release 作为魔改的基础分支，当然你也可以根据需要选择别的分支（我是着实看不懂，搞这么多分支干什么，而且基本上彼此分支的 UI 结果大差不差，险些所有 Openharmony 自带的系统应用 Demo UI 及功能逻辑都很 low，所以凡事靠自己，自己魔改吧！）

2.2 打开工程 / 编译 hap

切到对应分支后，即可打开工程，等待同步完成，如下图即可。

接下来可以编译 hap 包：

接着找到需要的 hap 包，重命名，替换后重启：

默认 Launcher 结果：（我手里有一台平板，所以就以平板为示例，结果要比手机少一点）

---

三、Launcher 首页

3.1 MainAbility

1. export default class MainAbility extends ServiceExtension {
2.   onCreate(want: Want): void {
3.     Log.showInfo(TAG,'onCreate start');
4.     this.context.area = 0;
5.     this.initLauncher();
6.   }
8.   async initLauncher(): Promise<void> {
9.     /**
10.      * 1. init Launcher context
11.      *    初始化上下文
12.      */
13.     globalThis.desktopContext = this.context;
15.     /**
16.      * 2. init global const
17.      *    初始化全局变量
18.      */
19.     this.initGlobalConst();
21.     /**
22.      * 3. init Gesture navigation
23.      *    初始化手势导航
24.      */
25.     this.startGestureNavigation();
27.     /**
28.      * 4. init rdb
29.      *    初始化 rdb
30.      */
31.     let dbStore = RdbStoreManager.getInstance();
32.     await dbStore.initRdbConfig();
33.     await dbStore.createTable();
35.     let registerWinEvent = (win: window.Window) => {
36.       win.on('windowEvent', (stageEventType) => {
37.         // 桌面获焦或失焦时，通知桌面的卡片变为可见状态
38.         if (stageEventType === window.WindowEventType.WINDOW_ACTIVE) {
39.           localEventManager.sendLocalEventSticky(EventConstants.EVENT_REQUEST_FORM_ITEM_VISIBLE, null);
40.           Log.showInfo(TAG, `lifeCycleEvent change: ${stageEventType}`);
41.         }
42.       })
43.     };
44.    
45.         /**
46.          * 5. 注册窗口事件
47.          */
48.     windowManager.registerWindowEvent();
49.    
50.     /**
51.      * 6. 注册导航栏事件
52.      */
53.     navigationBarCommonEventManager.registerNavigationBarEvent();
55.     /**
56.      * 7. create Launcher entry view
57.      *    创建桌面窗口
58.      *    WindowManager.ts --> DESKTOP_WINDOW_NAME = 'EntryView';
59.      *    加载 pages/EntryView
60.      */
61.     windowManager.createWindow(globalThis.desktopContext, windowManager.DESKTOP_WINDOW_NAME,
62.       windowManager.DESKTOP_RANK, 'pages/' + windowManager.DESKTOP_WINDOW_NAME, true, registerWinEvent);
64.     /**
65.      * 8. load recent，加载 Recent 窗口
66.      */
67.     windowManager.createRecentWindow();
68.     this.registerInputConsumer();
69.   }
71.   ...
72. }

复制代码

MainAbility 创建了桌面窗口：pages/EntryView。
3.2 EntryView

[code]