XGE 是一个 C 语言图形与应用界面库。它提供窗口与渲染循环、2D 图形和文本、资源与输入，以及建立在 XGE 上的保留式 XUI 控件库。
当前公开版本为 2.0.0。xge.h 和 xui.h 是唯一的公开 API 权威；本文档和范例说明如何使用这些 API，不承诺未在头文件中声明的内部实现细节。
- 构建与验证：Windows 构建、测试与输出位置。
- XGE 使用指南：运行时、绘制、资源、输入与生命周期。
- 2D 粒子系统：独立 CPU 模拟、配置、批渲染与七个经典场景范例。
- XUI 使用指南：控件、布局、事件和范例选择。
- 范例索引：按功能选择可运行范例。
- 平台说明：Windows、Android、iOS 和 Web 的当前入口。
- Emoji 支持：内置 Emoji 的运行时行为与自定义包。
英文概览见 README.en.md。
| 路径 | 用途 |
|---|---|
xge.h |
XGE 公开 C API。 |
xui.h |
XUI 公开 C API。 |
xge.c、src/ |
XGE 与 XUI 的实现。应用不应依赖其中的私有类型或函数。 |
examples/ |
可运行的 XGE/XUI 使用示例。 |
test/、test_xui/ |
自动化测试。 |
platform/ |
Android、iOS、Web 的构建入口和平台适配。 |
res/ |
运行时内置资源。 |
tools/ |
资源打包、静态检查和维护工具。 |
build/ 与 artifacts/ 是本地生成目录，不属于源代码发布内容。
- 应用只包含和链接公开头文件、实现源码或由本仓库构建得到的库文件。
- 通过
xge*、xui*公开函数创建和释放对象；不要访问src/中的结构体定义，也不要保存私有指针。 xge.h中以不完整类型暴露的资源句柄按其 API 约定使用。资源对象的内部布局不构成 ABI。- 平台目录中的内容是各平台的接入起点；是否可用于交付取决于在目标设备或浏览器上完成构建与测试。
在 Windows / MinGW-w64 环境中：
build_dll.bat
build_test.bat
build_dbg_test.bat
test_xui\build_context_test.bat
test_xui\build_widget_test.bat更多命令和前置条件见 构建与验证。