AWTK项目移植指南：从STM32到HarmonyOS的完整流程

AWTK（Toolkit AnyWhere）是一款跨平台嵌入式GUI框架，支持从资源受限的嵌入式设备到主流操作系统的全场景部署。本文将带您快速掌握从STM32裸机系统到HarmonyOS平台的移植全过程，让您的嵌入式GUI应用实现一次开发多端部署！## 📋 移植前准备：环境与工具清单在开始移植前，请确保您已准备好以下工具和环境：- **硬件环境**：STM32开发板（如STM32F1

gitblog_00040

491人浏览 · 2026-03-26 16:17:25

gitblog_00040 · 2026-03-26 16:17:25 发布

AWTK项目移植指南：从STM32到HarmonyOS的完整流程

【免费下载链接】awtk AWTK = Toolkit AnyWhere(a cross-platform embedded GUI) 项目地址: https://gitcode.com/gh_mirrors/aw/awtk

AWTK（Toolkit AnyWhere）是一款跨平台嵌入式GUI框架，支持从资源受限的嵌入式设备到主流操作系统的全场景部署。本文将带您快速掌握从STM32裸机系统到HarmonyOS平台的移植全过程，让您的嵌入式GUI应用实现一次开发多端部署！

📋 移植前准备：环境与工具清单

在开始移植前，请确保您已准备好以下工具和环境：

硬件环境：STM32开发板（如STM32F103ZET6）、HarmonyOS开发板（如Hi3516DV300）
开发工具：Keil MDK（STM32开发）、DevEco Studio（HarmonyOS开发）

源码获取：

git clone https://gitcode.com/gh_mirrors/aw/awtk

文档参考：
- 嵌入式平台移植注意事项
- STM32F103ZE移植实例

核心移植模块概览

AWTK的移植主要涉及三大核心模块，无论目标平台是STM32还是HarmonyOS，都需要完成这些基础适配：

AWTK移植核心模块关系图，展示了平台初始化、LCD驱动和主循环三大核心组件

🔧 STM32裸机系统移植实战

1. 平台初始化配置

STM32裸机环境需要实现基础的系统函数和内存管理：

// 内存初始化示例（awtk-port/platform.c）
ret_t platform_prepare(void) {
  static bool_t inited = FALSE;
  static uint32_t s_heam_mem[4000];  // 分配4000*4=16KB内存

  if (!inited) {
    inited = TRUE;
    tk_mem_init(s_heam_mem, sizeof(s_heam_mem));  // 初始化AWTK内存池
  }
  return RET_OK;
}

关键配置宏定义（awtk_config.h）：

#define HAS_STD_MALLOC 0              // 禁用标准malloc
#define FRAGMENT_FRAME_BUFFER_SIZE 32*1024  // 片段帧缓冲大小
#define WITH_STB_FONT 1               // 使用STB字体引擎
#define WITH_BITMAP_RGB565 1          // 配置LCD颜色格式

2. LCD驱动实现

STM32通常采用片段帧缓冲模式，只需实现窗口设置和数据写入函数：

// LCD驱动实现（awtk-port/lcd_stm32_raw.c）
#define set_window_func LCD_Set_Window  // 设置显示窗口
#define write_data_func LCD_WriteData_Color  // 写入像素数据
#include "lcd/lcd_mem_fragment.inc"  // 包含片段帧缓冲实现

3. 主循环与输入处理

使用简单主循环实现事件分发：

// 主循环实现（awtk-port/main_loop_stm32_raw.c）
void dispatch_input_events(void) {
  // 按键事件处理
  int key = KEY_Scan(0);
  if (key) {
    main_loop_post_key_event(main_loop(), TRUE, key);
  }
  
  // 触摸事件处理
  if (TOUCH_Scan() == 0) {
    main_loop_post_pointer_event(main_loop(), TRUE, TouchData.lcdx, TouchData.lcdy);
  }
}

🔄 迁移到HarmonyOS平台的关键步骤

1. 平台适配层改造

HarmonyOS作为实时操作系统，需要适配其任务调度和系统接口：

// HarmonyOS平台初始化（awtk-port/ohos/platform.c）
ret_t platform_prepare(void) {
  // 使用HarmonyOS的内存分配接口
  tk_mem_init_with_allocator(ohos_mem_alloc, ohos_mem_realloc, ohos_mem_free);
  return RET_OK;
}

关键配置差异：

启用操作系统特性：#define HAS_PTHREAD 1
使用系统文件系统：#define WITH_FS_RES 1
设置资源路径：#define APP_RES_ROOT "/data/awtk/res/"

2. 图形接口适配

HarmonyOS提供了图形驱动接口，需要实现对应的LCD适配：

// HarmonyOS LCD实现（awtk-port/ohos/lcd_ohos.c）
static lcd_t* lcd_ohos_create(wh_t w, wh_t h) {
  lcd_t* lcd = lcd_mem_create(w, h, BITMAP_FMT_RGBA8888);
  // 关联HarmonyOS图形缓冲区
  lcd->fb = OhosGetFrameBuffer();
  return lcd;
}

3. 构建系统配置

HarmonyOS使用GN/Ninja构建系统，需创建对应的BUILD.gn文件：

# BUILD.gn示例
import("//build/ohos.gni")

ohos_executable("awtk_demo") {
  sources = [
    "src/awtk_global.c",
    "src/tkc/*.c",
    "src/base/*.c",
    # 其他源文件...
  ]
  include_dirs = [
    "src",
    "3rd",
    "awtk-port/ohos",
  ]
  deps = [
    "//base/startup:bootstrap",
    "//utils/native/lite:utils",
  ]
}

📊 跨平台移植对比与优化

STM32与HarmonyOS移植差异

移植项	STM32裸机	HarmonyOS
内存管理	静态内存池	系统malloc
事件循环	简单轮询	系统事件驱动
图形加速	软件渲染	硬件加速支持
资源加载	内置资源	文件系统加载

性能优化建议

内存优化：
- 低端平台启用LCD_BGR565_LITE宏（配置说明）
- 使用片段帧缓冲减少内存占用（FRAGMENT_FRAME_BUFFER_SIZE）
渲染优化：
- HarmonyOS平台启用硬件加速：#define WITH_HW_ACCEL 1
- 关闭不需要的动画：#define WITHOUT_WINDOW_ANIMATORS 1
资源优化：
- 使用资源压缩：#define WITH_ASSET_LOADER_ZIP 1
- 裁剪字体：仅保留必要字符集