嵌入式平台移植注意事项

一、配置的宏

  1. /**
  2.  * 嵌入式系统有自己的main函数时，请定义本宏。
  3.  *
  4.  * #define USE_GUI_MAIN 1
  5.  */
  7. /**
  8.  * 如果需要支持预先解码的图片，请定义本宏。一般只在RAM极小时，才启用本宏。
  9.  * #define WITH_BITMAP_FONT 1
  10.  */
  12. /**
  13.  * 如果支持png/jpeg图片，请定义本宏
  14.  *
  15.  * #define WITH_STB_IMAGE 1
  16.  */
  18. /**
  19.  * 如果支持Truetype字体，请定义本宏
  20.  *
  21.  * #define WITH_STB_FONT 1
  22.  */
  24. /**
  25.  * 如果支持从文件系统加载资源，请定义本宏
  26.  *
  27.  * #define WITH_FS_RES 1
  28.  */
  30. /**
  31.  * 如果定义本宏，使用标准的UNICODE换行算法，除非资源极为有限，请定义本宏。
  32.  *
  33.  * #define WITH_UNICODE_BREAK 1
  34.  */
  36.  /**
  37.  * 如果定义本宏，将图片解码成BGRA8888格式，否则解码成RGBA8888的格式。
  38.  *
  39.  * #define WITH_BITMAP_BGRA 1
  40.  */
  42. /**
  43.  * 如果定义本宏，将不透明的PNG图片解码成BGR565格式，建议定义。
  44.  *
  45.  * #define WITH_BITMAP_BGR565 1
  46.  */
  48. /**
  49.  * 如果不需输入法，请定义本宏
  50.  *
  51.  * #define WITH_NULL_IM 1
  52.  */
  54. /**
  55.  * 如果支持极速模式，请定义本宏。极速模式不支持控件透明半透明效果，只有在CPU配置极低时启用。
  56.  *
  57.  * #define USE_FAST_MODE 1
  58.  */
  60. /**
  61.  * 如果有标准的malloc/free/calloc等函数，请定义本宏
  62.  *
  63.  * #define HAS_STD_MALLOC 1
  64.  */
  66. /**
  67.  * 如果有优化版本的memcpy函数，请定义本宏
  68.  *
  69.  * #define HAS_FAST_MEMCPY 1
  70.  */
  72.  /**
  73.  * 如果出现wcsxxx之类的函数没有定义时，请定义该宏
  74.  *
  75.  * #define WITH_WCSXXX 1
  76.  */
  78. /**
  79.  * 如果启用STM32 G2D硬件加速，请定义本宏
  80.  *
  81.  * #define WITH_STM32_G2D 1
  82.  */
  84. /**
  85.  * 如果启用NXP PXP硬件加速，请定义本宏
  86.  *
  87.  * #define WITH_PXP_G2D 1
  88.  */
  90. /**
  91.  * 如果启用VGCANVAS，而且没有OpenGL硬件加速，请定义本宏
  92.  *
  93.  * #define WITH_NANOVG_AGGE 1
  94.  */
  96. /**
  97.  * 如果启用VGCANVAS，请定义本宏
  98.  *
  99.  * #define WITH_VGCANVAS 1
  100.  */

请参考：src/base/awtk_config_sample.h

二、include路径

  1. awtk/src
  2. awtk/src/ext_widgets
  3. awtk/3rd
  4. awtk/3rd/agge
  5. awtk/3rd/nanovg/
  6. awtk/3rd/nanovg/base
  7. awtk/3rd/gpinyin/include
  8. awtk/3rd/libunibreak
  9. awtk-port

三、要加入到工程的文件

文件 说明
src/awtk_global.c 加入
src/tkc 全部加入
src/base 全部加入
src/widgets 全部加入
src/xml 全部加入
src/ui_loader 全部加入
src/svg 支持vgcanvas时全部加入
src/blend 使用framebuffer时全部加入
src/ext_widgets 使用扩展控件时全部加入
src/font_loader 推荐全部加入(可只加需要的)
src/image_loader 推荐全部加入(可只加需要的)
src/input_engines 不需要输入法时加入input_engine_null.c，否则加入input_engine_pinyin.cpp
src/input_methods 加入input_method_creator.c，根据宏决定启用何种输入法
src/lcd 根据LCD类型(OpenGL/FrameBuffer/Register）选择相应的文件
src/main_loop 嵌入式系统一般使用main_loop_simple.c
src/misc 如果没有标准的内存管理函数请加入
src/platforms/raw/fs_os.c 如果没有文件系统请加入，否则请自行实现fs接口
src/platforms/raw/mutex_null.c 如果没有mutex请加入，否则请自行实现mutex接口
src/platforms/raw/sys_tick.c 如果需要自己实现sys tick中断，可以加入
src/vgcanvas 如果需要矢量图或图片旋转(不支持lcd_reg)请加入vgcanvas_nanovg_soft.c，否则加入vgcanvas_null.c
src/widget_animators 除了使用LCD_REG的平台外推荐全部加入
src/window_animators 启用OpenGL(PC/Android/iOS)时加入window_animator_gpu.c，使用Framebuffer(一般嵌入式)时加入window_animator_fb.c，低端嵌入式平台请加入window_animator_null.c
awtk/3rd/agge 在framebuffer模式启用vgcanvas时加入
awtk/3rd/gpinyin/src 启用拼音输入法时加入
awtk/3rd/nanovg/base 在启用vgcanvas时加入
awtk/3rd/nanovg/agge 在启用vgcanvas时加入
awtk/3rd/libunibreak 建议加入
awtk-port 加入各个平台自己的移植代码。
awtk/demos 在使用ui demos可以加入：assets.c demo_main.c demo_ui_app.c。

四、其它

  • 1.如果要加载png/jpg图片格式StackSize不小于32K。
  • 2.使用keil编译时，请在C/C++ -> Misc Controls中加上—gnu标志。
  • 3.如果系统有FPU，初始化时一定要开启FPU。