SuperAPI AI 工具集

deepin-dde-expert

编程与开发

查看项目

更新于 10-16 07:26

技能介绍

用途:开发符合 DDE 规范的 Deepin/UOS 桌面应用,覆盖 DTK 控件、GVfs 网络协议文件操作、DBus 系统服务集成、Polkit 权限控制与主题适配。

主要能力与核心规则:DTK 控件优先于 Qt 原生(DMainWindow、DDialog、DMessageBox、DWidget 替代 QMainWindow、QDialog、QMessageBox、QWidget);网络协议(smb://、mtp://、dav://)使用 GIO GFile 而非 QFile,大文件 I/O 用 QtConcurrent 后台线程;系统状态通过 DBus 信号监听而非轮询;修改 /etc 配置用 Polkit + Helper 而非 sudo;主题适配用 DGuiApplicationHelper::instance()->applicationPalette(),不硬编码颜色。

构建与打包:CMake 通过 find_package(QT NAMES Qt6 Qt5 ...) 判断版本并设置 DTK_VERSION_MAJOR,链接 Dtk::Widget;debian/control 对应 V25/Qt6,debian/control.1 对应 V20/Qt5,依赖含 qt6-base-dev | qtbase5-dev、libdtk6widget-dev | libdtkwidget-dev、libpolkit-qt6-1-dev | libpolkit-qt5-1-dev。

适用场景:DTK 控件开发、GVfs 网络路径访问、DDE DBus 服务集成、Polkit 权限控制、DDE 主题适配。不适用于通用 Qt 应用、命令行工具与服务端开发。

限制与注意:GVfs 挂载点路径随会话变化,应使用 GIO URI API;注意 System 与 Session 总线区分;Polkit helper 需严格验证输入以防命令注入;非主线程更新 UI 应使用信号槽(QueuedConnection);需检查 GError。代码审查可用 grep 检查 QMainWindow/QDialog/QMessageBox、硬编码颜色与 g_file_new_for_uri 使用。