amt630hv160-sdk-release/amt630hv160-freertos-beta/lib/awtk/awtk-examples/Dashboard-Demo

AWTK 应用程序

准备

获取 awtk 并编译，可以通过以下两种方法：

1. 安装 AWStudio

安装完 AWStudio 后，打开 AWTK Designer 后新建或打开一个项目，在插件管理页面的已安装列表可以看到AWTK插件，选择编译或重新编译即可。

1. 前往 GitHub 获取

打开 Git Bash，执行如下命令：

git clone https://github.com/zlgopen/awtk.git
cd awtk; scons; cd -

运行

1. 编译

   scons
   

2. 生成项目的资源文件

   python ./scripts/update_res.py all
   

3. 运行

   ./bin/demo
   

FAQ

设置 APP 运行时是否显示控制台窗口

如果 Windows 平台不想在运行程序时弹出控制台窗口，请在当前项目目录下的 src/main.c 文件中添加宏定义，如下所示：

#define APP_ENABLE_CONSOLE FALSE

该定义需要在#include "awtk_main.inc"前添加。

设置 APP 标题栏的标题

如果需要修改 APP 标题栏的标题（运行程序时窗口左上角显示的名称），请在当前项目目录下的 src/main.c 添加宏定义，例如：

#define APP_NAME "HelloWorld"

该定义需要在#include "awtk_main.inc"前添加。

设置 APP 可执行文件的名称

如果需要修改生成的可执行文件名称，请修改src/SConscript文件里的内容，如下所示

env.Program(os.path.join(BIN_DIR, 'HelloWorld'), sources, LIBS = env['LIBS'])

将上述代码中的"HelloWorld"修改成想要的名称再进行编译即可。

设置 APP 依赖的库

如果需要设置依赖的库，可以打开项目目录中的Sconstruct文件，修改 DEPENDS_LIBS。关于 DEPENDS_LIBS 的更多信息，请参阅 如何添加第三方库。

设置 APP 的图标

如果需要修改应用程序的图标，有两种方法（只适用于 Windows 平台）：

1. 用 VC 创建的 .res 文件代替 当前依赖的 awtk 的SDK 包中的 awtk/win32_res里的 awtk.res 文件；
2. 用 ResEdit 直接编辑上述文件。

1. 生成兼容 mingw 的 res

1. awtk.rc 转为 utf8（或者 utf8 with BOM） 的编码；
2. 注释 rc 文件中的 #include "targetver.h" 代码；
3. windres 工具重新导出 res 文件。（windres 是 mingw 提供的 exe）

windres awtk.rc -O coff awtk.res

2. 生成兼容 mingw 的 x86 格式 res

步骤与上一小节一致，但最后使用 windres 工具导出 res 文件时，需要加上 --target=pe-i386 参数，命令如下：

windres awtk.rc -O coff awtk_x86.res --target=pe-i386

scripts目录的文件介绍

在scripts目录下，存放着几个脚本，下面简单介绍一下几个脚本的作用。

文件	作用
update_res.py	用于打包资源，使用方法可以查看该目录下的 README.md 文档。
awtk_locator.py	帮助搜索依赖的 AWTK，更多信息请参阅 如何查找AWTK SDK。
app_helper.py	帮助加载 AWTK 应用的公共编译参数，完成编译设置，以及编译 APP 依赖的库。
release.py	用于生成发布包，执行程序后会在项目目录生成 release 文件夹。