代码拉取完成，页面将自动刷新
功能
return_value_if_fail 这个宏并非是 AWTK 原创，而是从 GTK+（或者说 glib) 里拿来的。
优点
以简洁的方式对函数的参数或函数的返回值进行检查。
Release 模式和 Debug 模式可以做不同的处理。
在参数出现错误时，悄无声息的返回一个错误码，其实是对调用者的纵容，很容易把错误隐藏起来。所以在 Debug 模式我们可以打出一条警告信息，甚至直接 assert 掉，这对于定位 BUG 非常有效。
注意事项
优点
缓存有助于多个控件共享同一张图片。
外面不保存对 bitmap 的引用，缓存管理更加灵活。比如，可以清除最近没有被渲染的图片（即使某个隐藏的窗口还在使用该图片）。
可以用 imagemagic 转换：
convert bg.png -ordered-dither o8x8,32,64,32 bg.jpg
获取控件的值有以下几种方式：
用 widget_get_value 函数获取（仅支持整数类型）。
用 wiget_get_prop 函数获取。
直接访问控件的属性。控件的属性如果标记为 readable，均可直接访问。如：
widget_t* slider = widget_lookup(win, "slider", TRUE);
double value = SLIDER(slider)->value;
直接访问控件属性时，需要用对应的宏（如上面的 SLIDER) 进行类型转换。
Ubuntu 14 上的 OpenGL 有问题，请使用 AGGE 软件渲染。修改 awtk_config.py：
NANOVG_BACKEND='AGGE'
<normal bg_color="rgba(200,200,200,0.1)" />
图片半透明。在制作图片时，使用 PNG 格式，保留 alpha 通道。
整个控件（包括子控件）半透明。可以使用函数 widget_set_opacity 设置不透明度。
/**
* @method widget_set_opacity
* 设置控件的不透明度。
*
*>在嵌入式平台，半透明效果会使性能大幅下降，请谨慎使用。
*
* @param {widget_t*} widget 控件对象。
* @param {uint8_t} opacity 不透明度（取值 0-255，0 表示完全透明，255 表示完全不透明）。
*
* @return {ret_t} 返回 RET_OK 表示成功，否则表示失败。
*/
ret_t widget_set_opacity(widget_t* widget, uint8_t opacity);
opacity 会影响包括字体在内的全部元素，通常只适用于实现淡入淡出的动态效果。
软键盘可以根据自己的情况进行调整，可以修改 design/default/ui/kb_default.xml。
<pages x="0" y="bottom" w="100%" h="-28" active="4">
children_layout="default(r=4,c=1,s=2,m=2)"
<keyboard theme="keyboard" x="0" y="bottom" w="100%" h="40%">
修改之后，需要更新资源的脚本：
python scripts/update_res.py ui
tk_mem_stat 函数可以获取内存的使用情况，也可以直接调用 tk_mem_dump 显示内存使用情况。
tk_mem_dump 函数的实现如下：
void tk_mem_dump(void) {
mem_stat_t s = tk_mem_stat();
log_debug("used: %d bytes %d blocks\n", s.used_bytes, s.used_block_nr);
}
内存不够时系统确实有可能变慢，内存不够时会清除部分或全部解码的图片缓存，下次使用这些图片时会重新解码。
可以在 mem.c 中的函数 tk_mem_on_out_of_memory 里设置断点，内存耗尽时会调用这个函数释放缓存。如果这个函数被调用，说明内存不够。
减少同时打开窗口的个数。
根据实际情况 (lcd 的格式） 定义 WITH_BITMAP_BGR565/WITH_BITMAP_RGB565 把不透明的图片解码成 16 位。
log_set_log_level 函数可设置 log 的级别，用它可以关闭低级别的 log 信息。
/**
* @method log_set_log_level
*
* 设置 log 的级别。
*
* @param {log_level_t} log_level log 的级别。
*
* @return {ret_t} 返回 RET_OK 表示成功，否则表示失败。
*/
ret_t log_set_log_level(log_level_t log_level);
在 awtk_main.inc 中有如下代码：
#ifdef NDEBUG
log_set_log_level(LOG_LEVEL_INFO);
#else
log_set_log_level(LOG_LEVEL_DEBUG);
#endif /*NDEBUG*/
如果使用 awtk_main.inc 作为应用程序的入口，定义 NDEBUG 也关闭 debug 级别的调试信息。
在 awtk_config.py 中定义宏 NATIVE_WINDOW_BORDERLESS，重新编译即可：
COMMON_CCFLAGS=COMMON_CCFLAGS+' -DNATIVE_WINDOW_BORDERLESS=1 '
让事件处理函数返回 RET_STOP，AWTK 不再调用后续事件处理函数。
因为控件注册了，即使没有使用，编译器也会把相关代码编译进去。所以只有去掉控件的注册代码，才能优化掉不必要的代码。
比如去掉 overlay 窗口，可以注释掉下面的这行代码：
widget_factory_register(f, WIDGET_TYPE_OVERLAY, overlay_create);
去掉不必要的扩展控件，可以编辑 src/ext_widgets/ext_widgets.c
从 assets/default/raw/styles/default.xml 中去掉不必要的。
去掉不必要的图片。一些控件去掉了，相应的图片也没有必要了。
请参考：自定义字体加载器：加载部分字体
使用下面的函数即可：
/**
* @method window_open_and_close
* @annotation ["constructor", "scriptable"]
* 从资源文件中加载并创建 window 对象。本函数在 ui_loader/ui_builder_default 里实现。
* @param {const char*} name window 的名称。
* @param {widget_t*} to_close 关闭该窗口。
*
* @return {widget_t*} 对象。
*/
widget_t* window_open_and_close(const char* name, widget_t* to_close);
使用下面的函数即可：
/**
* @method locale_info_change
* 设置当前的国家和语言。
* @annotation ["scriptable"]
* @param {locale_info_t*} locale_info locale_info 对象。
* @param {char*} language 语言。
* @param {char*} country 国家或地区。
*
* @return {ret_t} 返回 RET_OK 表示成功，否则表示失败。
*/
ret_t locale_info_change(locale_info_t* locale_info, const char* language, const char* country)
请参考：
请修改下面的文件，并重新生成资源：
design/default/styles/keyboard.xml
一般来说，执行下面的命令即可：
npm install -g glob
在 Linux/MacOS 上，有时仍然出现错误，可以通过下面的命令，设置 NODE_PATH 环境变量：
export NODE_PATH="$(npm root -g)"
这个需要安装 Pillow 模块 (python)，运行下面的命令可以安装：
pip3 install Pillow
如果系统同时安装了 python2，可以加个 alias。
alias python=python3
在 awtk_config.py 中定义宏 NATIVE_WINDOW_NOT_RESIZABLE，重新编译即可：
COMMON_CCFLAGS=COMMON_CCFLAGS+' -DNATIVE_WINDOW_NOT_RESIZABLE=1 '
AWTK_LITE 主要是用来在低端平台裁剪代码的，内存占用主要于图片缓存有关。可以通过图片管理器的接口设置缓存大小：
/**
* @method image_manager_set_max_mem_size_of_cached_images
* 设置图片缓存占用的最大内存。
* @param {image_manager_t*} imm 图片管理器对象。
* @param {uint32_t} max_mem_size 最大缓存内存。
*
* @return {ret_t} 返回 RET_OK 表示成功，否则表示失败。
*/
ret_t image_manager_set_max_mem_size_of_cached_images(image_manager_t* imm, uint32_t max_mem_size);
使用下列命令：
python scripts/update_res.py all
通常是消息队列满了。解决方法如下：
优化：比如同一类的消息，可以用一个 idle，而不是每个消息都弄一个 idle，在 idle 函数里再去读取消息。
如果内存允许，可以直接增加队列大小。
#define MAIN_LOOP_QUEUE_SIZE 200
可以放到 awtk_config.h 中。
出现错误：
In file included from /usr/include/glib-2.0/glib/galloca.h:32,
from /usr/include/glib-2.0/glib.h:30,
from /usr/include/gtk-3.0/gdk/gdkconfig.h:13,
from /usr/include/gtk-3.0/gdk/gdk.h:30,
from /usr/include/gtk-3.0/gtk/gtk.h:30,
from 3rd/SDL/src/video/x11/SDL_x11window.c:36:
/usr/include/glib-2.0/glib/gtypes.h:32:10: fatal error: glibconfig.h: No such file or directory
32 | #include <glibconfig.h>
解决方法如下：
sudo ln -s /usr/lib/arm-linux-gnueabihf/glib-2.0/include/glibconfig.h /usr/include/glib-2.0/glibconfig.h
支持。如：原来的 style 文件为 button.bin，删除 button.bin，放一个 button.xml 文件即可。
可以。使用 emitter_disable/emitter_enable 可以关闭和开启控件的事件。
示例：
static ret_t widget_set_value_without_notify(widget_t* widget, uint32_t value) {
if (widget->emitter != NULL) {
emitter_disable(widget->emitter);
widget_set_value(widget, value);
emitter_enable(widget->emitter);
} else {
widget_set_value(widget, value);
}
return RET_OK;
}
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。