nim duilib

nim_duilib 是一个界面库，包含了一整套桌面软件的开发部件，使用C++语言开发。nim_duilib是在NIM_Duilib_Framework库的基础上进行了代码功能完善和扩展，但由于代码结构和资源XML文件的格式均有调整，所以不能直接兼容基于NIM_Duilib_Framework开发的程序，但代码和资源XML迁移的难度不大。您可以直接使用nim_duilib界面库来开发常用的桌面应用，以简化应用程序的UI开发工作。

特色

• 通用样式：支持以XML格式描述应用程序的窗口属性、布局属性、控件属性等，方便调整界面元素的位置和大小，较为灵活
• 控件丰富：包含各种常见的窗口和控件，如图片控件、动画控件、按钮、文本框、列表控件、虚表控件、树控件、颜色选择控件、菜单等
• 事件驱动：基于消息机制的事件处理，使得UI交互逻辑清晰
• 皮肤支持：通过XML文件定义皮肤结构，可以轻松改变界面风格
• 性能优异：界面资源的内存占有率低，使用Skia引擎绘制，后台绘制配置使用CPU绘制或者GPU绘制
• 多种图片格式，支持的图片文件格式有：SVG/PNG/GIF/JPG/BMP/APNG/WEBP/ICO
• 动画图片，支持GIF动画文件、APNG动画文件、WebP动画文件
• 使用Skia作为界面渲染引擎，性能较好，功能丰富，控件的功能扩展较容易
• 支持DPI感知（Unaware、SystemAware、PerMonitorAware、PerMonitorAware_V2四种模式），支持独立设置DPI，支持高清DPI的适配
• 多国语言支持，支持动态多种语言切换，易于实现国际化
• CEF 控件支持（仅Windows平台）
• 支持SDL3：可使用SDL3作为窗口管理和输入输出等基本功能提供者，从而支持跨平台（目前已经适配了Linux平台）

目录

基于NIM_Duilib_Framework源码做的主要修改

使用的第三方库说明

备注：

1. 本项目最早是基于duilib开发的，项目地址：duilib
2. 本项目是直接在NIM_Duilib_Framework项目的基础上继续开发的，项目地址：NIM_Duilib_Framework

获取代码和编译（Windows平台）

1. 设置工作目录：D:\develop\skia\
2. 获取并编译Skia库（nim_duilib内部使用Skia作为界面绘制引擎，所以先要编译skia）：
   （1）注意事项：skia源码应该与nim_duilib源码位于相同的目录下，目录结构：D:\develop\skia\
   （2）获取skia代码的编译方法和修改的代码：git clone https://github.com/rhett-lee/skia_compile
   （3）编译skia源码：按照skia_compile目录中的Windows下编译skia.md文档中的方法，编译出skia相关的.lib文件
   　　　注意事项：skia源码编译的时候，应使用LLVM编译，程序运行比较流畅；如果使用VS编译，运行速度很慢，界面比较卡
   　　　检查方法：编译成功以后，在skia/out的子目录下，有生成skia.lib等lib文件
3. 获取项目代码：git clone https://github.com/rhett-lee/nim_duilib
4. 编译nim_duilib：进入 nim_duilib/examples 目录，使用 Visual Studio 2022版本的 IDE 打开 examples.sln，选择编译选项为Debug|x64或者Release|x64，按下 F7 即可编译所有示例程序（编译完成的示例程序位于bin目录中）
5. 编译附件说明：
   （1）项目中工程的编译环境为Visual Studio 2022版本，如果使用其他版本的Visual Studio编译器，需要手动更新编译工程的属性。
   （2）项目中的工程默认配置是x64的，如果需要编译Win32的程序，在编译skia的时候，也需要启动32位的命令行（x86 Native Tools Command Prompt for VS 2022）
   （3）nim_duilib的代码兼容性默认是支持Win7以上系统，未支持Windows XP；Windows SDK的兼容性配置可在duilib\duilib_config.h文件中修改。

获取代码和编译（Linux平台）

1. 设置工作目录：/home/develop/
2. 获取并编译Skia库（nim_duilib内部使用Skia作为界面绘制引擎，所以先要编译skia）：
   （1）注意事项：skia源码应该与nim_duilib源码位于相同的目录下，目录结构：/home/develop/skia/
   （2）获取skia代码的编译方法和修改的代码：git clone https://github.com/rhett-lee/skia_compile
   （3）编译skia源码：按照skia_compile目录中的说明文档中的方法，编译出skia相关的.a文件
   　　　注意事项：skia源码编译的时候，应使用LLVM编译，程序运行比较流畅
   　　　检查方法：编译成功以后，在skia/out的子目录下，有生成libskia.a等.a文件

3. 获取并编译SDL库（nim_duilib内部使用SDL作为Linux平台的界面绘制引擎，所以先要编译SDL）：
   （0）准备工作

　（1）进入工作目录：cd /home/develop/
　（2）获取源码：git clone https://github.com/libsdl-org/SDL.git
　（3）使用cmake设置：cmake -S "./SDL/" -B "./SDL.build" -DCMAKE_INSTALL_PREFIX="/home/develop/SDL3/" -DSDL_SHARED=OFF -DSDL_STATIC=ON -DSDL_TEST_LIBRARY=OFF
　（4）进入SDL编译目录：cd /home/develop/SDL.build
　（5）编译SDL：make
　（6）安装SDL：make install
　（7）SDL3的安装目录为：/home/develop/SDL3/，子目录里面包含了.a文件和.h文件等；
　（8）编译完成后，SDL目录和SDL.build可以删除，仅保留SDL3目录即可。

4. 获取项目代码并编译：
   　（1）回到工作目录：cd /home/develop/
   　（2）获取项目代码：git clone https://github.com/rhett-lee/nim_duilib
   　（3）进入代码目录：cd /home/develop/nim_duilib/
   　（4）设置编译脚本可执行：chmod +x linux_build.sh
   　（5）执行脚本编译：./linux_build.sh
   　（6）编译完成后，编译成功后，在libs目录生成了.a文件（libz.a、libpng.a、libwebp.a、libcximage.a、libduilib.a），在bin目录中生成了可执行文件。
5. 备注：如果希望编译debug版本的.a文件，可在cmake的参数中追加：-DCMAKE_BUILD_TYPE=Debug
6. 如果想自己编译最新版的gcc/g++（比如系统自带的gcc/g++版本较低时，由于不支持C++20，所以无法成功编译nim_duilib源码）
   　　可以参照如下流程编译（以gcc-14.2.0为例）：
   　（1）创建源码目录：cd /home/develop; mkdir src; cd src
   　（2）进入工作目录：/home/develop/src
   　（3）下载：wget https://ftp.gnu.org/gnu/gcc/gcc-14.2.0/gcc-14.2.0.tar.gz
   　（4）解压：tar -xzf gcc-14.2.0.tar.gz
   　（5）下载gcc依赖的第三方库：进入gcc-14.2.0目录，然后下载依赖的第三方库
   　　cd /home/develop/src/gcc-14.2.0
　　./contrib/download_prerequisites
   　（6）配置：
   　　mkdir -p /home/develop/src/gcc-14.2.0.build
　　cd /home/develop/src/gcc-14.2.0.build
　　../gcc-14.2.0/configure --prefix=/home/develop/install/gcc-14.2.0 --disable-multilib --enable-ld --enable-bootstrap
   　（7）编译：make -j 4 多进程编译，编译参数可参考电脑实际有几个核心。
   　（8）安装：make install
   　（9）设置环境变量，以使新版gcc/g++可用：
   　　export PATH=/home/develop/install/gcc-14.2.0/bin/:$PATH
　　export LD_LIBRARY_PATH=/home/develop/install/gcc-14.2.0/lib64/:$LD_LIBRARY_PATH
　　export C_INCLUDE_PATH=/home/develop/install/gcc-14.2.0/include/c++/14.2.0/:/home/develop/install/gcc-14.2.0/include/c++/14.2.0/x86_64-pc-linux-gnu/:$C_INCLUDE_PATH
　　export CPLUS_INCLUDE_PATH=/home/develop/install/gcc-14.2.0/include/c++/14.2.0/:/home/develop/install/gcc-14.2.0/include/c++/14.2.0/x86_64-pc-linux-gnu/:$CPLUS_INCLUDE_PATH
   　（10）进入项目目录并编译源码：
   　　cd /home/develop/nim_duilib
　　chmod +x linux_build.sh
　　./linux_build.sh

开发计划

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

参考文档

• 快速上手
• 参考文档
• 示例程序
• 跨平台（Windows/Linux系统）的窗口引擎（基于SDL3.0），相关的进展参见文档：跨平台开发相关事项.md