wGac Tests 编译指南
March 11, 2026 · View on GitHub
本目录包含 GacUI 在 Wayland 环境下的测试和示例项目。
系统要求
- Linux 系统（支持 Wayland）
- CMake >= 3.24
- GCC/Clang（支持 C++20）
- pkg-config
依赖库
在编译之前，请确保安装以下依赖：
Debian/Ubuntu:
sudo apt install cmake build-essential pkg-config \
libwayland-dev libxkbcommon-dev \
libcairo2-dev libpango1.0-dev libfontconfig1-dev \
libgdk-pixbuf-2.0-dev libgio-2.0-dev
Fedora:
sudo dnf install cmake gcc-c++ pkg-config \
wayland-devel libxkbcommon-devel \
cairo-devel pango-devel fontconfig-devel \
gdk-pixbuf2-devel glib2-devel
Arch Linux:
sudo pacman -S cmake base-devel pkg-config \
wayland libxkbcommon \
cairo pango fontconfig \
gdk-pixbuf2 glib2
编译步骤
1. 初始化子模块
首先需要初始化 Release 子模块（包含 GacUI 源码和资源）：
cd /path/to/wGac
git submodule update --init --recursive
2. 创建构建目录
cd Tests
mkdir -p build
cd build
3. 运行 CMake 配置
cmake ..
如需调试版本：
cmake -DCMAKE_BUILD_TYPE=Debug ..
4. 编译
编译所有测试项目：
make -j$(nproc)
编译单个项目（例如 Cpp）：
make Cpp
项目列表
GacUI_HelloWorlds（入门示例）
| 项目 | 说明 |
|---|---|
| Cpp | 纯 C++ 入门示例 |
| CppXml | C++ + XML 资源示例 |
| MVVM | MVVM 架构示例 |
GacUI_Layout（布局示例）
| 项目 | 说明 |
|---|---|
| Alignment | 对齐布局 |
| Flow | 流式布局 |
| Responsive1/2 | 响应式布局 |
| RichTextEmbedding | 富文本嵌入 |
| SharedSize | 共享尺寸 |
| Stack | 堆栈布局 |
| Table | 表格布局 |
| TableSplitter | 表格分割器 |
GacUI_Xml（XML 绑定示例）
| 项目 | 说明 |
|---|---|
| Binding_Bind | 数据绑定 |
| Binding_Eval | 表达式求值 |
| Binding_Format | 格式化绑定 |
| Binding_Uri | URI 绑定 |
| Binding_ViewModel | ViewModel 绑定 |
| Event_Cpp/Script/ViewModel | 事件处理示例 |
| Instance_Control/Window/MultipleWindows | 实例化示例 |
| Member_Field/Parameter/Property | 成员示例 |
| Misc_ImportFolder | 导入文件夹 |
GacUI_Controls（控件示例）
| 项目 | 说明 |
|---|---|
| AddressBook | 地址簿 |
| Animation | 动画效果 |
| CalculatorAndStateMachine | 计算器与状态机 |
| ColorPicker | 颜色选择器 |
| ContainersAndButtons | 容器与按钮 |
| DataGrid | 数据表格 |
| DocumentEditorRibbon | 文档编辑器（Ribbon） |
| DocumentEditorToolstrip | 文档编辑器（工具栏） |
| GlobalHotKey | 全局热键 |
| ListControls | 列表控件 |
| Localization | 本地化 |
| MenuVisibility | 菜单可见性 |
| ProgressAndAsync | 进度条与异步 |
| QueryService | 查询服务 |
| TriplePhaseImageButton | 三态图片按钮 |
GacUI_ControlTemplate（控件模板）
| 项目 | 说明 |
|---|---|
| WindowSkin | 窗口皮肤 |
运行测试
编译完成后，可执行文件位于 build/<Category>/<ProjectName>/ 目录下：
# 运行 HelloWorld 示例
./GacUI_HelloWorlds/Cpp/Cpp
# 运行布局示例
./GacUI_Layout/Alignment/Alignment
注意: 运行需要 Wayland 桌面环境。如果使用 X11，可以通过 XWayland 运行，或设置：
export XDG_SESSION_TYPE=wayland
常见问题
Q: 编译报错找不到头文件
确保已正确初始化 git 子模块：
git submodule update --init --recursive
Q: 运行时报错 "cannot connect to display"
确保在 Wayland 会话中运行，或设置正确的 WAYLAND_DISPLAY 环境变量。
Q: pkg-config 找不到某个库
检查是否安装了对应的开发包（-dev 或 -devel 后缀）。