# awtk-msvc

**Repository Path**: zlgopen/awtk-msvc

## Basic Information

- **Project Name**: awtk-msvc
- **Description**: from https://github.com/zlgopen/awtk-msvc
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 2
- **Created**: 2020-02-21
- **Last Updated**: 2025-09-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AWTK-MSVC

## 1 下载并安装 CMake 

### 1.1 下载 CMake

前往 [CMake 官网](https://cmake.org/download/) 下载最新版安装包。

### 1.2 安装 CMake

1. 双击运行安装包，一路点击 【next】；
2. 到如下图步骤时，选中【add CMake to the system PATH for all users】和【Create CMake Desktop Icon】；

![AddPath](./docs/images/AddPath.png)

3. 再一路点击【next】，并最后点击【install】，安装成功后，点击【Finish】。

## 2 环境配置

### 2.1 下载 awtk

直接使用 [AWStudio](https://awtk.zlg.cn/) 安装目录下的 `AWTK/SDK/awtk`，或则从 GitHub 仓库克隆 awtk，命令如下：

```bash
git clone https://github.com/zlgopen/awtk.git
```

### 2.2 下载 awtk-msvc

从 GitHub 仓库克隆 awtk-msvc，命令如下

```bash
git clone https://github.com/zlgopen/awtk-msvc.git
```

**​确保 awtk-msvc 与 awtk 在同一文件夹下。**

## 3 生成VS工程

### 3.1 修改 build_gen.bat 文件

#### 3.1.1 设置渲染模式

```bat
@rem 设置渲染模式
@set NANOVG_TYPE=AGGE
@rem set NANOVG_TYPE=GLES2
```

> “rem”为批处理的注释符号，如需修改渲染模式，删去对应语句的“rem“即可。

#### 3.1.2 设置启用谷歌拼音

```bat
@rem 设置启用谷歌拼音
@set PINYIN_ENABLE=ON
```

#### 3.1.3 禁用部分警告

```bat
@rem 禁用部分警告
@set DISABLE_WARNING=ON
```

工程默认禁用 C4244、C4267 及 C4018 警告，用户可自行开启警告。

#### 3.1.4 设置应用工程配置

```bat
@rem 应用工程配置
@set PRJ_ENABLE=ON
@set PRJ_NAME=Application
@set PRJ_LCDW=800
@set PRJ_LCDH=480
@set PRJ_TYPE=2
@set PRJ_PATH="C:\Users\UserName\Documents\AWStudioSolutions\AwtkApplication0"
```

设置 PRJ_ENABLE=ON 启用编译应用工程，通常只需要修改 PRJ_PATH 指向 AWTK 应用工程文件夹路径。 

注意工程需要由 AWStudio-V2.x 创建，并已经构建好 UI，确保工程 build 文件夹生成了 res 文件夹。

#### 3.1.5 设置VS平台

可根据用户安装的VS版本（vs2015或以上），自行修改VS平台：

```bat
@rem 设置VS生成器
@set VS_GENERATOR="Visual Studio 14 Win64"
```

参数中的"Win64"表示生成 64 位工程，如需生成 32 位工程，修改参数为"Visual Studio 14"即可。

VS_PLATFORM 参数取值可参考下图：

![generator](./docs/images/generator.png)

> 在终端上运行 `cmake --help`，可得到上图输出结果。

### 3.2 执行 build_gen.bat 文件

双击 build_gen.bat 文件，将生成VS工程到build文件夹下。

## 4 打开VS工程

打开 build 文件夹，双击 awtk-msvc.sln 文件即可打开 VS 工程。