btzy/nativefiledialog-extended

📁 Gọi native file dialog trên mọi nền tảng chỉ với một thư viện C nhỏ

Viết code dialog một lần, chạy native trên Windows, macOS, Linux — không cần Qt, không cần wxWidgets.

nativefiledialog-extended là thư viện C nhẹ, tĩnh, cho phép gọi các hộp thoại mở file, chọn thư mục và lưu file gốc của từng hệ điều hành. Dự án fork từ Michael Labbe's Native File Dialog nhưng phá vỡ tương thích API để bổ sung hàng loạt tính năng thực tế: tên bộ lọc dễ đọc, tự động thêm phần mở rộng, đặt đường dẫn mặc định, và hỗ trợ cửa sổ cha giữ dialog trên cùng.

Thư viện hoạt động trên Windows (MSVC, MinGW, Clang), macOS (Clang), và Linux (GTK, xdg-desktop-portal). License Zlib, không phụ thuộc bên thứ ba, build bằng CMake hiện đại. Dùng chung tốt với SDL, GLFW, và ImGui.

✨ Điểm nổi bật

• Lean C API, static library: Không cần runtime C++/ObjC, liên kết tĩnh gọn nhẹ
• Cross-platform thực sự: Windows (MSVC/MinGW/Clang), macOS, Linux (GTK + portal)
• Tên bộ lọc thân thiện: Hiển thị C/C++ Source files (*.c;*.cpp) thay vì (*.c;*.cpp)
• Tự động thêm phần mở rộng: Trên các nền tảng mà người dùng kỳ vọng hành vi này
• Hỗ trợ UTF-8 nhất quán: Ký tự Unicode đầy đủ trên mọi nền tảng, thêm UTF-16 wchar_t trên Windows
• Multiple selection: Chọn nhiều file trong hộp thoại mở và chọn thư mục
• xdg-desktop-portal trên Linux: Mở trình chọn file "native" của desktop environment
• C++ wrapper tuỳ chọn: Dùng unique_ptr auto-freeing, optional parameters cho project C++
• Init/Quit tách rời: Khởi tạo COM/GTK/D-Bus độc lập với gọi dialog, ứng dụng tự kiểm soát vòng đời

💡 Vì sao đáng chú ý

So với thư viện gốc, bản extended giải quyết đúng các pain point thực tế khi dùng native file dialog: tên filter hiển thị rõ ràng cho người dùng, tự động append extension tránh file không có đuôi, và support parent window handle giúp dialog không bị mất dưới cửa sổ chính. Việc tách rời việc khởi tạo nền tảng khỏi gọi dialog cho phép ứng dụng kiểm soát chính xác thời điểm init/de-init COM hay GTK — quan trọng khi tích hợp vào engine hoặc framework lớn.

Dự án phù hợp cho bất kỳ ứng dụng C/C++ nào cần hộp thoại mở/lưu file mà không muốn kéo theo cả Qt hay wxWidgets. Cộng đồng duy trì wiki liệt kê các binding ngôn ngữ và project nổi bật phụ thuộc thư viện này, cho thấy mức độ tin cậy trong thực tế.

#C #CPlusPlus #CrossPlatform #FileDialog #OpenSource #TiniX