|
||
---|---|---|
.. | ||
3rd | ||
design/default | ||
design_dll | ||
res | ||
scripts | ||
src | ||
README.md | ||
SConstruct | ||
manifest.json | ||
project.json |
README.md
AWTK 应用程序
准备
获取 awtk 并编译,可以通过以下两种方法:
- 安装 AWStudio
安装完 AWStudio 后,打开 AWTK Designer 后新建或打开一个项目,在插件管理页面的已安装列表可以看到AWTK插件,选择编译或重新编译即可。
- 前往 GitHub 获取
打开 Git Bash,执行如下命令:
git clone https://github.com/zlgopen/awtk.git
cd awtk; scons; cd -
运行
- 编译
scons
- 生成项目的资源文件
python ./scripts/update_res.py all
- 运行
./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 平台):
- 用 VC 创建的 .res 文件代替 当前依赖的 awtk 的SDK 包中的
awtk/win32_res
里的 awtk.res 文件; - 用 ResEdit 直接编辑上述文件。
1. 生成兼容 mingw 的 res
- awtk.rc 转为 utf8(或者 utf8 with BOM) 的编码;
- 注释 rc 文件中的 #include "targetver.h" 代码;
- 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 文件夹。 |