awtk/docs/porting_common.md

嵌入式平台移植注意事项

一、几个常用的宏

• 1.WITH_BITMAP_FONT 如果需要使用位图字体请定义该宏。

• 2.WITH_STB_FONT 如果需要使用truetype字体请定义该宏。

• 3.WITH_STB_IMAGE 如果需要使用png/jpg图片请定义该宏。由于解码图片需要较大内存，所以在内存较 少的情况下，我们直接把png/jpg转换成位图数据，当作常量编译到代码中，此时不需要定义该宏。

• 4.WITH_FS_RES 如果支持从文件系统中加载资源请定义该宏。需要有兼容POSIX标准的FS接口，如果没有则需要自己实现src/base/fs.c中的函数。

• 5.USE_GUI_MAIN 嵌入式系统有自己的main函数时请定义该宏。

• 6.WITH_WCSXXX 如果出现wcsxxx之类的函数没有定义时请定义该宏。

二、include路径

• 1.基本路径

awtk
awtk\src
awtk\3rd

• 2.picasso的路径(如果启用)

awtk\3rd\picasso\src
awtk\3rd\picasso\src\gfx
awtk\3rd\picasso\include
awtk\3rd\picasso\src\include
awtk\3rd\picasso\build

• 3.agg的路径(如果启用)

3rd/agg/include

三、要加入到工程的文件

• src/base 全部加入。
• src/font 全部加入。
• src/main_loop/main_loop_simple.*
• src/window_animators/ 如果需要窗口动画而且支持framebuffer加入window_animator_fb.c，否则加入window_animator_null.c。
• src/image_loader 全部加入。
• src/platforms/raw/mutex.c 加入本文件或者自己实现mutex。
• src/ui_loader 全部加入。
• src/window_animators 全部加入。
• src/blend 使用framebuffer时全部加入。
• src/lcd 根据LCD类型选择相应的文件。
• src/tk.c
• src/tk.h
• src/vgcanvas/vgcanvas_null.c 如果不使用vgcanvas请加入本文件。
• src/xml 可选。
• 3rd/picasso 可选。
• 3rd/agg 可选。

四、其它

使用keil编译时，请在C/C++ -> Misc Controls中加上**--gnu**标志。