nim_duilib 是一款基于C++开发的跨平台界面库，源于经典的 duilib 界面库并进行了深度优化与功能扩展，支持Windows/Linux/macOS/FreeBSD平台，专注于简化桌面应用的高效开发。其设计融合了DirectUI理念，通过XML描述界面布局，实现视觉与逻辑的分离，显著提升开发灵活性与维护性。

• XML布局驱动：采用 XML 文件定义界面结构，将界面布局与业务逻辑完全分离。开发者可通过修改 XML 快速调整控件位置、尺寸和样式，无需改动 C++ 核心代码，极大提升开发与迭代效率。
• 丰富的控件体系：内置按钮、文本框、列表视图、虚表控件、树形控件、滑块、进度条、菜单、颜色选择、属性页、标签页等基础控件，同时支持自定义控件开发，满足多样化界面设计需求。
• 高效的渲染机制：使用Skia作为渲染引擎，实现控件的无窗口绘制，减少系统资源占用，提升界面刷新速度。支持硬件加速渲染（后端绘制支持使用CPU绘制或者GPU绘制），确保复杂界面流畅运行。
• 事件驱动：基于消息机制的事件处理，使得UI交互逻辑清晰，支持在XML文件中配置事件响应代码。
• 多种图片格式：支持SVG/PNG/GIF/JPG/BMP/APNG/WEBP/ICO图片格式。
• 支持动画格式：支持GIF、APNG、WEBP、Lottie JSON、PAG动画文件格式。
• 多语言与国际化：支持动态多种语言切换，便于开发全球化的应用程序。
• 支持动态换肤：通过XML文件定义皮肤结构，可以轻松改变界面风格，支持动态换肤。
• 支持窗口阴影：支持窗口的圆角阴影、直角阴影，并可选择阴影大小，可实时更新。
• 支持DPI感知：有Unaware、SystemAware、PerMonitorAware、PerMonitorAware_V2四种模式，支持独立设置DPI，支持高清DPI的适配（仅限Windows平台）。
• 支持CEF控件：支持libcef 109 版本，以兼容Windows 7系统；支持libcef 142 版本，支持Windows 10及以上操作系统，支持Linux和MacOS平台。
• 支持WebView2控件：支持使用WebView2控件用于显示网页，其接口封装简单，更易于使用（仅支持Windows平台）。
• 支持SDL3：可使用SDL3作为窗口管理和输入输出等基本功能提供者，从而支持跨平台（目前已经适配了Windows/Linux/MacOS/FreeBSD平台）。

使用该界面库编写的示例程序，该文档可以见到各个控件的展示效果：docs/Examples.md

• 目前PAG动画文件格式仅在Window平台支持，其他平台暂未支持
• 支持PAG动画文件格式功能默认关闭（因为需要自己编译libpag.lib和libpag.dll，放进项目才能正常编译运行）
• 支持PAG动画格式的开启方法：
  （1）使用文本编译器打开msvc/PropertySheets/LibPagSettings.props文件，将LibPagEnabled变量的支持修改为1
  （2）参照以下文档编译libpag库：duilib/third_party/libpag/windows/libpag-build.md
• 编译nim_duilib的时候，需要使用build/duilib.sln或者build/examples.sln编译，其他方式编译不支持。
• libpag库的主体授权协议为Apache License Version 2.0，其依赖的第三方组件的授权协议很多，
  详见目录:duilib/third_party/libpag/licenses中的文件。
  如果介意libpag的授权协议（包括主体协议/第三方组件协议），可以不启用libpag。

• C/C++: 编译器需要支持C++20

• Windows：Windows 7.0 版本及以上
• Linux：OpenEuler、OpenKylin（开放麒麟）、UbuntuKylin（优麒麟）、中科方德、统信UOS、Ubuntu、Debian、Fedora、OpenSuse等
• macOS：12+
• FreeBSD

• Visual Studio 2022（Windows）
• LLVM（Windows）
• MinGW-W64：gcc/g++、clang/clang++（Windows）
• gcc/g++（Linux）
• clang/clang++（Linux）
• clang/clang++（macOS）
• clang/clang++（FreeBSD）

1. 安装python3（python的主版本需要是3，需要添加到Path环境变量）
   （1）首先安装python3
   （2）在Windows的设置里面，关闭python.exe和python3.exe的"应用执行别名"，否则编译skia的脚本执行有问题。Windows设置入口：设置 -> 应用 -> 高级应用设置 -> 应用执行别名
   （3）到python.exe所在目录中，复制一份python.exe，改名为python3.exe: 确保命令行参数中可以访问到python3.exe
   （4）在命令行验证：> python3.exe --version 可以查看python的版本号
2. 安装Git For Windows: 2.44版本，git需要添加到Path环境变量，确保命令行参数中可以访问到git.exe
3. 安装Visual Studio 2022社区版
4. 安装LLVM：21.1.4 Win64 版本（其他版本也可以）
   （1）安装目录：C:\LLVM
   （2）注意事项：如果安装在其他目录，安装目录中不能有空格，否则编译会遇到问题。

该脚本自动完成相关源码下载和编译工作。
选定一个工作目录（注意事项：路径中不能包含空格，否则编译脚本会出错），创建一个脚本build.bat，将下面已经整理好脚本复制进去，保存文件。
脚本文件内容如下：

echo OFF
set retry_delay=10

:retry_clone_duilib
if not exist ".\nim_duilib" (
    git clone https://github.com/rhett-lee/nim_duilib
) else (  
    git -C ./nim_duilib pull
)
if %errorlevel% neq 0 (
    timeout /t %retry_delay% >nul
    goto retry_clone_duilib
)
.\nim_duilib\build\build_duilib_all_in_one.bat

进入命令行控制台，运行该脚本：

.\build.bat

编译完成的示例程序位于bin目录中。

1. 设置工作目录：D:\develop
2. 获取相关代码
   （1）git clone https://github.com/rhett-lee/nim_duilib
   （2）git clone https://github.com/rhett-lee/skia_compile
   （3）git clone https://github.com/google/skia.git
3. 编译Skia源码
   （1）nim_duilib内部使用Skia作为界面绘制引擎，所以先要编译skia，优先用LLVM编译，运行流畅
   （2）按照skia_compile目录中的Windows下编译skia.md文档中的方法，编译出skia相关的.lib文件
4. 编译nim_duilib：进入 build 目录，打开 examples.sln，可执行编译，编译完成的示例程序位于bin目录中。

不同的操作系统平台，可以按照以下列表安装必备的软件。

该脚本自动完成相关源码下载和编译工作。
选定一个工作目录（注意事项：路径中不能包含空格，否则编译脚本会出错），创建一个脚本build.sh，将下面已经整理好脚本复制进去，保存文件。
然后在控制台，为脚本文件添加可执行权限，最后运行该脚本：

chmod +x build.sh
./build.sh

脚本文件内容如下：

#!/bin/bash

# Retry clone nim_duilib
while true; do
    if [ ! -d "./nim_duilib/.git" ]; then
        git clone https://github.com/rhett-lee/nim_duilib
    else
        git -C ./nim_duilib pull
    fi
    if [ $? -ne 0 ]; then
        sleep 10
        continue
    fi
    break
done

chmod +x ./nim_duilib/build/build_duilib_all_in_one.sh
./nim_duilib/build/build_duilib_all_in_one.sh

编译完成的示例程序位于bin目录中。
备注：UOS系统，需要先安装所需的开发环境，然后再安装，可参考文档：统信UOS下编译skia.md。

1. 设置工作目录：~/develop
2. 获取相关代码
   （1）git clone https://github.com/rhett-lee/nim_duilib
   （2）git clone https://github.com/rhett-lee/skia_compile
   （3）git clone https://github.com/google/skia.git
   （4）git clone https://github.com/libsdl-org/SDL.git
3. 编译Skia库

注意事项：skia源码编译的时候，应使用LLVM编译，程序运行比较流畅。

4. 编译SDL库

#!/bin/bash
cd ~/develop
cmake -S "./SDL/" -B "./SDL.build" -DCMAKE_INSTALL_PREFIX="./SDL3/" -DSDL_SHARED=ON -DSDL_STATIC=OFF -DSDL_TEST_LIBRARY=OFF -DSDL_X11_XSCRNSAVER=OFF -DSDL_X11_XTEST=OFF -DCMAKE_BUILD_TYPE=Release
cmake --build ./SDL.build
cmake --install ./SDL.build

5. 编译nim_duilib

#!/bin/bash
cd ~/develop/nim_duilib/
chmod +x linux_build.sh
./linux_build.sh

编译完成后，在bin目录中生成了可执行文件。
如果希望支持CEF，可以参考相关文档docs/CEF.md。

安装完成系统后，需要做的工作：

xcode-select --install

验证安装：

clang++ --version

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

如果失败，可以查找其他源来安装。
更新Homebrew：

brew update

git make unzip python3

brew install cmake

brew install ninja

mkdir ~/develop
cd ~/develop
git clone https://github.com/timniederhausen/gn
cd gn
python3 build/gen.py
ninja -C out
sudo cp out/gn /usr/local/bin/
gn --version

该脚本自动完成相关源码下载和编译工作。
选定一个工作目录（注意事项：路径中不能包含空格，否则编译脚本会出错），创建一个脚本build.sh，将下面已经整理好脚本复制进去，保存文件。
然后在控制台，为脚本文件添加可执行权限，最后运行该脚本：

chmod +x build.sh
./build.sh

脚本文件内容如下：

#!/bin/bash

# Retry clone nim_duilib
while true; do
    if [ ! -d "./nim_duilib/.git" ]; then
        git clone https://github.com/rhett-lee/nim_duilib
    else
        git -C ./nim_duilib pull
    fi
    if [ $? -ne 0 ]; then
        sleep 10
        continue
    fi
    break
done

chmod +x ./nim_duilib/build/build_duilib_all_in_one.sh
./nim_duilib/build/build_duilib_all_in_one.sh

编译完成的示例程序位于bin目录中。

1. 设置工作目录：~/develop
2. 获取相关代码
   （1）git clone https://github.com/rhett-lee/nim_duilib
   （2）git clone https://github.com/rhett-lee/skia_compile
   （3）git clone https://github.com/google/skia.git
   （4）git clone https://github.com/libsdl-org/SDL.git
3. 编译Skia库

注意事项：skia源码编译的时候，应使用LLVM编译，程序运行比较流畅。

4. 编译SDL库

#!/bin/bash
cd ~/develop
cmake -S "./SDL/" -B "./SDL.build" -DCMAKE_INSTALL_PREFIX="./SDL3/" -DSDL_SHARED=ON -DSDL_STATIC=OFF -DSDL_TEST_LIBRARY=OFF -DSDL_X11_XSCRNSAVER=OFF -DSDL_X11_XTEST=OFF -DCMAKE_BUILD_TYPE=Release
cmake --build ./SDL.build
cmake --install ./SDL.build

5. 编译nim_duilib

#!/bin/bash
cd ~/develop/nim_duilib/
chmod +x macos_build.sh
./macos_build.sh

编译完成后，在bin目录中生成了可执行文件。
如果希望支持CEF，可以参考相关文档docs/CEF.md。

sudo pkg install git unzip python3 cmake ninja gn llvm fontconfig freetype2

该脚本自动完成相关源码下载和编译工作。
选定一个工作目录（注意事项：路径中不能包含空格，否则编译脚本会出错），创建一个脚本build.sh，将下面已经整理好脚本复制进去，保存文件。
然后在控制台，为脚本文件添加可执行权限，最后运行该脚本：

chmod +x build.sh
./build.sh

脚本文件内容如下：

#!/usr/bin/env bash

# Retry clone nim_duilib
while true; do
    if [ ! -d "./nim_duilib/.git" ]; then
        git clone https://github.com/rhett-lee/nim_duilib
    else
        git -C ./nim_duilib pull
    fi
    if [ $? -ne 0 ]; then
        sleep 10
        continue
    fi
    break
done

chmod +x ./nim_duilib/build/build_duilib_all_in_one.sh
./nim_duilib/build/build_duilib_all_in_one.sh

编译完成的示例程序位于bin目录中。

​​注意：FreeBSD 平台不支持 CEF（Chromium Embedded Framework）。

1. 设置工作目录：~/develop
2. 获取相关代码
   （1）git clone https://github.com/rhett-lee/nim_duilib
   （2）git clone https://github.com/rhett-lee/skia_compile
   （3）git clone https://github.com/google/skia.git
   （4）git clone https://github.com/libsdl-org/SDL.git
3. 编译Skia库

注意事项：skia源码编译的时候，只支持使用LLVM编译。

4. 编译SDL库

#!/usr/bin/env bash
cd ~/develop
cmake -S "./SDL/" -B "./SDL.build" -DCMAKE_INSTALL_PREFIX="./SDL3/" -DSDL_SHARED=ON -DSDL_STATIC=OFF -DSDL_TEST_LIBRARY=OFF -DSDL_X11_XSCRNSAVER=OFF -DSDL_X11_XTEST=OFF -DCMAKE_BUILD_TYPE=Release
cmake --build ./SDL.build
cmake --install ./SDL.build

5. 编译nim_duilib

#!/usr/bin/env bash
cd ~/develop/nim_duilib/
chmod +x ./build/freebsd_build.sh
./build/freebsd_build.sh

编译完成后，在bin目录中生成了可执行文件。

• 跨平台（Windows/Linux/macOS/FreeBSD）的窗口引擎（基于SDL3.0）不断测试与完善（X11和Wayland）
• 动画功能的加强
• 不断测试发现缺陷并修复，不断完善代码
• 其他待补充

• 快速上手
• 示例程序
• 全局样式：字体、颜色、图片等资源
• 窗口的样式
• 容器的样式
• 控件的样式
• 菜单的样式
• 控件的事件/消息
• XML文件中各控件的节点名称
• XML文件中直接响应控件的事件
• CEF控件
• 项目编译相关文档和脚本
• 参考文档

1. Skia的编译文档库，点击访问：skia compile ：
2. 本项目是直接在NIM_Duilib_Framework项目的基础上继续开发的，项目地址：NIM_Duilib_Framework
3. NIM_Duilib_Framework项目是基于duilib开发的，项目地址：duilib