QT 基础项目结构 DEMO

### QT 安装

[Qt 5.15 下载路径](https://download.qt.io/archive/qt/5.15/)

[Linux安装qt完整版教程](https://blog.csdn.net/m0_45463480/article/details/127696388)

## Vscode 构建 QT 编译工程

Qt 项目示例使用 CMake 构建系统。

### 项目结构

```
MyQtProject/
│
├── CMakeLists.txt
├── main.cpp
└── .vscode/
    ├── settings.json
    └── launch.json
```

### CMakeLists.txt

```cmake
cmake_minimum_required(VERSION 3.14)

project(MyQtProject)

set(CMAKE_PREFIX_PATH "/path/to/Qt") # 修改为你的 Qt 安装路径

find_package(Qt5 COMPONENTS Widgets REQUIRED)

add_executable(MyApp main.cpp)

target_link_libraries(MyApp Qt5::Widgets)
```

### main.cpp

```cpp
#include <QApplication>
#include <QPushButton>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    
    QPushButton button("Hello, Qt!");
    button.resize(200, 100);
    button.show();

return app.exec();
}
```

### .vscode/settings.json

```json
{
    "cmake.configureSettings": {
        "CMAKE_PREFIX_PATH": "/path/to/Qt"
    },
    "cmake.generator": "Ninja"
}
```

### .vscode/launch.json

```json
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Launch MyApp",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/build/MyApp",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "miDebuggerPath": "/usr/bin/gdb",
            "preLaunchTask": "CMake: build"
        }
    ]
}
```

### 构建和运行

1. 在 VSCode 中打开 `MyQtProject` 文件夹。
2. 运行命令面板 `Ctrl+Shift+P`，选择 `CMake: Configure`。
3. 选择 `CMake: Build` 进行构建。
4. 运行或调试项目。

确保将 `/path/to/Qt` 替换为你的实际 Qt 安装路径。这样你就有了一个简单的 Qt 项目，可以在 VSCode 中进行开发和调试。

### 调试错误信息

```bash
bj@orangepi3b:~/WorkShip/Qt_Project/build$ ./MyApp 
libGL error: glx: failed to create dri3 screen
libGL error: failed to load driver: rockchip
libGL error: glx: failed to create dri2 screen
libGL error: failed to load driver: rockchip

#出现 libGL error: failed to load driver: rockchip 错误通常与图形驱动程序有关

```

**更新OpenGL 驱动也无法解决**

```bash
sudo apt install libgl1-mesa-glx libgl1-mesa-dri
```

**使用软件渲染启动应用**

```bash
LIBGL_ALWAYS_SOFTWARE=1 your_application
#LIBGL_ALWAYS_SOFTWARE=1 ./MyApp

# 或在终端中手动运行命令，配置环境变量
export LIBGL_ALWAYS_SOFTWARE=1
```

## QT 常用指令

```bash
#查看已安装的模块
qmake -query QT_INSTALL_LIBS
```

**QT 模块安装**

```bash
sudo apt install libqt5core5a libqt5gui5 libqt5serialport5 libqt5printsupport5
sudo apt install qttools5-dev
sudo apt-get install libqt5serialport5-dev
```

**QT 的 CMakeLists.txt 配置添加串口**

```cmake
cmake_minimum_required(VERSION 3.5)
project(MyProject)
# 查找 Qt 包
find_package(Qt5 REQUIRED COMPONENTS Core SerialPort)
# 添加可执行文件
add_executable(MyApp main.cpp)
# 链接 Qt 库
target_link_libraries(MyApp Qt5::Core Qt5::SerialPort)
```

由于 /dev/ttyS7 所属于 dialog 组，所以需要将当前用户添加到 dialout 组：

```bash
crw-rw---- 1 root dialout 4, 71 Sep 25 14:29 /dev/ttyS7
```

这将列出当前用户所属的所有组。如果 `dialout` 在输出中，那么用户就在该组中。

```bash
groups $(whoami)
```

要将用户添加到 `dialout` 组，可以使用以下命令：

```bash
sudo usermod -aG dialout bj
sudo usermod -aG dialout $(whoami)
```

将 `username` 替换为你的用户名。完成后，建议你注销并重新登录以使更改生效。