Duilib 开源项目安装与使用指南

Duilib 开源项目安装与使用指南

duilib项目地址:https://gitcode.com/gh_mirrors/du/duilib

项目介绍

Duilib(Dream UI Library) 是一款基于 Windows API 的免费开源 DirectUI 图形界面库. 该项目由杭州月牙儿网络技术有限公司主导开发，旨在简化图形界面设计过程，提升开发效率。Duilib 主要特点在于其支持 XML 描述的界面布局，允许开发者将用户界面 (UI) 和业务逻辑解耦，从而轻松地调整和维护界面。

项目特性

• DirectUI 技术：采用 DirectUI 技术，无需依赖系统默认的窗口类，可以直接在设备上下文 (DC) 上绘制。
• XML 控制布局：使用 XML 文件控制界面布局和样式，便于管理和维护界面，提高灵活性。
• 高效性能表现：设计注重性能优化，即使复杂的界面也能保证流畅响应。
• 广泛的兼容性：适用于 Windows 系统下多种类型的客户端应用程序，如 IM 软件、音视频播放器、浏览器插件等。
• 活跃的社区支持：拥有一个充满活力的开发者社区，提供各种功能增强和 bug 修复。

项目快速启动

1. 获取源码

首先，确保你的系统已经安装了 Git 或类似版本控制系统。然后，在命令行执行以下操作克隆 Duilib 仓库:

git clone https://github.com/duilib/duilib.git
cd duilib

2. 编译源码

Duilib 提供了 Visual Studio 解决方案文件 (Duilib.sln)，这使得在 Microsoft Visual Studio 中编译变得容易。

• 打开 Duilib.sln
• 更改配置和平台为所需的设置，例如 Release 和 x64
• 如果遇到任何错误，检查是否正确安装了所有必要的组件，比如最新的 Visual Studio SDK
• 最后，点击“Build Solution”进行编译

示例配置

// 示例代码，展示如何继承 WindowImplBase 类创建杜依库 UI
#include <UICore.h>

class MyMainWnd : public DuiLib::CWinUIWindowImpl<MyMainWnd>
{
public:
    DECLARE_WND_CLASS(NULL)
    BEGIN_MSG_MAP(MyMainWnd)
        MESSAGE_HANDLER(WM_DESTROY, OnDestroy)
    END_MSG_MAP()

protected:
    // 窗口销毁事件处理器
    LRESULT OnDestroy(UINT /*uMsg*/, WPARAM /*wParam*/, LPARAM /*lParam*/, BOOL& /*bHandled*/)
    {
        PostQuitMessage(0);
        return 0;
    }
};

LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
{
    return CallWindowProc(g_pMainWnd->m_hWndProc, hWnd, message, wParam, lParam);
}

int WINAPI _tWinMain(HINSTANCE hInstance, HINSTANCE /*hPrevInstance*/, LPTSTR /*lpCmdLine*/, int nShowCmd)
{
    CoInitialize(NULL);  // COM 初始话
    
    // 创建主窗口
    MyMainWnd wnd;
    if (!wnd.CreateEx())
        return -1;

    wnd.ShowWindow(nShowCmd);

    MSG msg = {0};
    while (GetMessage(&msg, NULL, 0, 0))
    {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }

    CoUninitialize();
    
    return static_cast<int>(msg.wParam);
}

3. 配置环境

确保包含正确的头文件和库连接。对于静态链接，需加入 -UILIB_STATIC 宏；对于动态链接，则需将编译好的 DLL 放入适当的目录。

应用案例和最佳实践

Duilib 已被多个知名产品采纳，诸如百度杀毒、微信 PC 客户端、爱奇艺、网易云音乐等。这些都是在不同行业领域内充分运用杜依库的例子，证明了其强大的适应能力和实用性。

• 百度杀毒: 实现了高度定制化的安全软件界面。
• 微信 PC 客户端: 设计了简洁而友好的即时通讯界面。
• 爱奇艺: 提供了丰富多媒体元素的娱乐软件界面体验。
• 网易云音乐: 结合了美观与实用性的音乐播放器界面。

最佳实践建议

• 详细阅读官方文档，理解 XML 配置文件的语法和标签含义。
• 使用版本控制管理你的项目，便于跟踪变更。
• 在测试阶段关注界面性能，避免不必要的重绘操作。
• 积极参与社区讨论，及时跟进最新的功能更新和bug修复。

典型生态项目

除了核心 Duilib 库之外，还有几个围绕它的衍生项目值得关注:

1. Duilib_Ultimate: 一个增强版的 Duilib 库，提供了更多的功能、更高的稳定性和更完善的文档。

   • GitHub 地址: https://github.com/qdtroy/DuiLib_Ultimate

2. TIMSDK: 腾讯云即时通讯 Demo 中集成的杜依库修改版。

   • GitHub 地址: https://github.com/TencentCloud/TIMSDK/tree/master/Windows/Demo/Basic/duilib

3. NIM_Duilib_Framework: 网易云信基于 Duilib 的框架。

   • GitHub 地址: https://github.com/netease-im/NIM_Duilib_Framework/tree/master/duilib

以上项目通常比原生 Duilib 库包含更多特性和优化，适合那些寻求高级特性和完善解决方案的开发者。

---

以上就是关于 Duilib 的全面介绍和快速启动指南，希望帮助你在开发过程中取得更大的成就！

如果你有任何疑问或发现上述信息不准确之处，欢迎随时提问！

duilib项目地址:https://gitcode.com/gh_mirrors/du/duilib