awtk/docs/how_to_use_cmake_to_build_awtk_app.md

如何使用 CMake 构建 AWTK 应用

1. 安装 CMake

CMake 是一个开源的跨平台的构建工具，可以用来构建 AWTK 应用。

在 Windows 下，可以从 CMake 官网 下载安装包进行安装。

在 Linux 下，可以使用包管理工具安装：

sudo apt-get install cmake

2. 创建 CMakeLists.txt

• 指定 awtk 的路径

set(awtk_DIR "../awtk")

• 导入 awtk 的配置

find_package(awtk REQUIRED)

• 添加头文件路径(请根据自己的情况调整)

include_directories(
    ${CMAKE_SOURCE_DIR}/res
    ${CMAKE_SOURCE_DIR}/src
    ${CMAKE_SOURCE_DIR}/3rd
    )   

• 添加源文件(请根据自己的情况调整)

file(GLOB SOURCES src/*.c 3rd/sqlite3/sqlite3.c)
add_executable(hello ${SOURCES})

• 添加链接库(请根据自己的情况调整)

target_link_libraries(hello awtk)

• 设置 WIN32_EXECUTABLE 属性

set_target_properties(hello PROPERTIES WIN32_EXECUTABLE TRUE)

完整示例：

cmake_minimum_required (VERSION 3.10)

project(hello)

set(awtk_DIR "../awtk")
find_package(awtk REQUIRED)

include_directories(
    ${CMAKE_SOURCE_DIR}/res
    ${CMAKE_SOURCE_DIR}/src
    ${CMAKE_SOURCE_DIR}/3rd
    )   

file(GLOB SOURCES src/*.c 3rd/sqlite3/sqlite3.c)
add_executable(hello ${SOURCES})
target_link_libraries(hello awtk)
set_target_properties(hello PROPERTIES WIN32_EXECUTABLE TRUE)

3. 配置

cmake -S . cmake -B build

4. 编译

在 Windows 下可以用 visual studio 打开 build 目录下的工程，然后进行编译。

cmake --build build

5. 运行

./build/hello

6. 调试

在 Windows 下可以用 visual studio 打开 build 目录下的工程，然后进行调试。

参考：awtk-hello