Jokul
eb90da12f3
- 创建插件元数据 package/metadata.json - 实现主插件类 GraphicsDriverApplet (D-Bus通信) - 实现GPU指示器类 GpuIndicator (设备信息解析) - 创建QML界面 driverview.qml (驱动管理UI) - 添加CMake构建配置 - 编写开发指南文档 docs/DEVELOPMENT.md
255 lines
5.2 KiB
Markdown
255 lines
5.2 KiB
Markdown
# 开发指南
|
||
|
||
## 环境准备
|
||
|
||
### 1. 克隆dde-shell仓库
|
||
|
||
```bash
|
||
# 克隆dde-shell到本地
|
||
git clone https://github.com/linuxdeepin/dde-shell.git ~/dde-shell
|
||
|
||
# 或者作为子模块引入
|
||
git submodule add https://github.com/linuxdeepin/dde-shell.git third_party/dde-shell
|
||
```
|
||
|
||
### 2. 安装构建依赖
|
||
|
||
```bash
|
||
# Debian/Deepin系统
|
||
sudo apt build-dep .
|
||
|
||
# 或手动安装依赖
|
||
sudo apt install -y \
|
||
cmake \
|
||
g++ \
|
||
qt6-base-dev \
|
||
qt6-tools-dev \
|
||
libdtk6-core-dev \
|
||
libdtk6-widget-dev
|
||
```
|
||
|
||
### 3. 配置CMake
|
||
|
||
```bash
|
||
# 创建构建目录
|
||
mkdir build && cd build
|
||
|
||
# 配置，指定dde-shell路径
|
||
cmake .. -Ddde-shell_DIR=~/dde-shell/build
|
||
```
|
||
|
||
## 开发步骤
|
||
|
||
### 步骤1: 获取D-Bus接口定义
|
||
|
||
查看deepin-graphics-driver-manager的D-Bus接口：
|
||
|
||
```bash
|
||
# 克隆仓库
|
||
git clone https://github.com/linuxdeepin/deepin-graphics-driver-manager.git
|
||
|
||
# 查看接口定义
|
||
cat deepin-graphics-driver-manager/com.deepin.daemon.GraphicsDriver.xml
|
||
```
|
||
|
||
接口方法：
|
||
- `GetDevice()` - 获取显卡设备信息（返回JSON字符串）
|
||
- `GetCurrDriverName()` - 获取当前驱动名称
|
||
- `GetNewDriverName()` - 获取推荐驱动名称
|
||
- `PrepareInstall(name, language)` - 准备安装驱动
|
||
- `TestInstall()` - 测试安装
|
||
- `RealInstall()` - 实际安装
|
||
- `CancelInstall()` - 取消安装
|
||
|
||
信号：
|
||
- `ReportProgress(ratio)` - 安装进度报告（ratio为百分比字符串）
|
||
- `Cancel()` - 安装取消通知
|
||
|
||
### 步骤2: 适配D-Bus接口
|
||
|
||
编辑`graphicsdriverapplet.cpp`，根据实际接口调整：
|
||
|
||
```cpp
|
||
// 检查D-Bus服务是否可用
|
||
QDBusConnection bus = QDBusConnection::sessionBus();
|
||
if (!bus.isConnected()) {
|
||
qWarning() << "Cannot connect to D-Bus session bus";
|
||
return false;
|
||
}
|
||
|
||
// 检查服务是否存在
|
||
QDBusInterface interface(
|
||
"com.deepin.daemon.GraphicsDriver",
|
||
"/com/deepin/daemon/GraphicsDriver",
|
||
"com.deepin.daemon.GraphicsDriver",
|
||
bus
|
||
);
|
||
|
||
if (!interface.isValid()) {
|
||
qWarning() << "GraphicsDriver service is not available";
|
||
return false;
|
||
}
|
||
```
|
||
|
||
### 步骤3: 完善GPU设备检测
|
||
|
||
根据`GetDevice()`返回的JSON格式，调整解析逻辑：
|
||
|
||
```json
|
||
{
|
||
"vendor": "NVIDIA",
|
||
"model": "GeForce GTX 1660 Ti",
|
||
"driverVersion": "470.103.01",
|
||
"driverStatus": "installed",
|
||
"drivers": [
|
||
{
|
||
"name": "nvidia-driver-470",
|
||
"version": "470.103.01",
|
||
"description": "NVIDIA Driver 470 (推荐)"
|
||
},
|
||
{
|
||
"name": "nvidia-driver-460",
|
||
"version": "460.103.01",
|
||
"description": "NVIDIA Driver 460"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
### 步骤4: 添加图标资源
|
||
|
||
创建`icons/`目录并添加图标：
|
||
|
||
```bash
|
||
mkdir icons
|
||
|
||
# 添加显卡图标（可以从deepin图标库获取）
|
||
wget https://github.com/linuxdeepin/deepin-icon-theme/raw/master/icons/deepin/scalable/apps/graphics-card.svg -P icons/
|
||
```
|
||
|
||
在QML中引用：
|
||
|
||
```qml
|
||
Image {
|
||
source: "qrc:/icons/graphics-card.svg"
|
||
}
|
||
```
|
||
|
||
### 步骤5: 测试插件
|
||
|
||
```bash
|
||
# 构建
|
||
cmake -Bbuild
|
||
cmake --build build
|
||
|
||
# 安装到本地测试
|
||
cmake --install build --prefix ~/.local
|
||
|
||
# 启动dde-shell测试模式
|
||
dde-shell -t
|
||
```
|
||
|
||
### 步骤6: 调试技巧
|
||
|
||
```bash
|
||
# 查看D-Bus服务
|
||
qdbus | grep GraphicsDriver
|
||
|
||
# 监听D-Bus信号
|
||
dbus-monitor "interface='com.deepin.daemon.GraphicsDriver'"
|
||
|
||
# 查看插件日志
|
||
QT_LOGGING_RULES="dde.shell*=true" dde-shell -t
|
||
```
|
||
|
||
## 常见问题
|
||
|
||
### 1. 插件未加载
|
||
|
||
检查`metadata.json`格式是否正确：
|
||
|
||
```json
|
||
{
|
||
"Plugin": {
|
||
"Version": "1.0",
|
||
"Id": "org.deepin.ds.graphics-driver",
|
||
"Url": "driverview.qml",
|
||
"Category": "DDE"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 2. D-Bus连接失败
|
||
|
||
确认deepin-graphics-driver-manager服务已启动：
|
||
|
||
```bash
|
||
# 检查服务状态
|
||
systemctl status deepin-graphics-driver-manager
|
||
|
||
# 手动启动服务
|
||
sudo deepin-graphics-driver-manager -d
|
||
```
|
||
|
||
### 3. 权限问题
|
||
|
||
安装驱动需要root权限，确保PolicyKit配置正确：
|
||
|
||
```bash
|
||
# 检查PolicyKit规则
|
||
pkaction --action-id com.deepin.daemon.GraphicsDriver --verbose
|
||
```
|
||
|
||
## 代码规范
|
||
|
||
### 命名规范
|
||
|
||
- 类名：`PascalCase`（如`GraphicsDriverApplet`）
|
||
- 方法名：`camelCase`（如`refreshDeviceInfo`）
|
||
- 常量：`UPPER_SNAKE_CASE`（如`DBUS_SERVICE`）
|
||
- 成员变量：`m_`前缀（如`m_dbusInterface`）
|
||
|
||
### 文件组织
|
||
|
||
- 头文件：类声明、信号、槽、Q_PROPERTY
|
||
- 实现文件：构造函数、方法实现、D_APPLET_CLASS宏
|
||
- QML文件：界面布局、交互逻辑
|
||
|
||
## 发布流程
|
||
|
||
### 1. 版本号更新
|
||
|
||
更新`CMakeLists.txt`中的版本号：
|
||
|
||
```cmake
|
||
project(dde-graphics-driver-applet VERSION 1.0.0 LANGUAGES CXX)
|
||
```
|
||
|
||
### 2. 构建Debian包
|
||
|
||
```bash
|
||
dpkg-buildpackage -uc -us -nc -b
|
||
```
|
||
|
||
### 3. 测试安装
|
||
|
||
```bash
|
||
sudo dpkg -i ../dde-graphics-driver-applet_1.0.0_amd64.deb
|
||
```
|
||
|
||
### 4. 提交到官方仓库
|
||
|
||
```bash
|
||
# Fork仓库后
|
||
git remote add upstream https://github.com/linuxdeepin/dde-shell.git
|
||
git push origin master
|
||
# 创建Pull Request
|
||
```
|
||
|
||
## 相关资源
|
||
|
||
- [dde-shell插件开发文档](https://github.com/linuxdeepin/dde-shell/tree/master/docs/plugin)
|
||
- [deepin-graphics-driver-manager](https://github.com/linuxdeepin/deepin-graphics-driver-manager)
|
||
- [DTK开发文档](https://linuxdeepin.github.io/dtk/)
|
||
- [Qt D-Bus文档](https://doc.qt.io/qt-6/qtdbus-index.html)
|