Qt项目简易开发原理及常见问题解决

一、资源下载地址

https://www.aliyundrive.com/s/jBU2wBS8poH

本项目路径：项目->免费->QtDev

注释：为了方便qt全功能开发，QtDev中包含了qt所有的Win32和x64的Release及Debug库。如果开发简单功能的话可以只下载对应所需要的库即可。

二、项目介绍

1、从零开始开发一个小项目，通过本项目来介绍Qt界面简易开发的过程及原理，简易开发的意思是只需要对应的Qt库及编译工具（如vs2019）即可。电脑不需要安装Qt Creator，vs2019不需要安装Qt插件。本文使用vs2019来描述其原理，根据原理其他平台下如Linux也可以进行简易开发。

2、本项目完成的功能及解决的常见问题如下：

（1）、Qt生成的exe添加logo。

（2）、Qt加载资源来使用ico，png图标。

（3）、Qt加载资源失败的原因及解决方案，尤其是双击文件使用exe打开时资源加载失败导致图标无法显示。

（4）、Qt中文乱码的原因及解决方案。

（5）、软件发布的两种形式：免安装包和安装包。

三、项目开始

1、准备工作

（1）、电脑安装vs2019

（2）、Qt库下载

最简单的界面程序开发需要如下文件：

2、vs2019新建一个空白解决方案

3、创建一个控制台应用项目

4、创建一个基础函数模块，封装编码转换等一些基础功能

源码：

新建工程：

在解决方案下新建一个core文件夹，然后右击core新建空白项目：

然后把源码拖到工程里：

然后设置项目输出目录及项目设置为静态库：

然后设置附加包含目录：

然后设置预处理器：

最后右击生成该项目：

5、创建Qt界面模块

源码：

GuiQtDev.ui：

<?xml version="1.0" encoding="UTF-8"?>

<ui version="4.0">

 <class>GuiQtDevClass</class>

 <widget class="QMainWindow" name="GuiQtDevClass">

  <property name="geometry">

   <rect>

    <x>0</x>

    <y>0</y>

    <width>600</width>

    <height>400</height>

   </rect>

  </property>

  <property name="windowTitle">

   <string>Gui</string>

  </property>

  <widget class="QWidget" name="centralWidget"/>

  <widget class="QMenuBar" name="menuBar">

   <property name="geometry">

    <rect>

     <x>0</x>

     <y>0</y>

     <width>600</width>

     <height>22</height>

    </rect>

   </property>

  </widget>

  <widget class="QToolBar" name="mainToolBar">

   <attribute name="toolBarArea">

    <enum>TopToolBarArea</enum>

   </attribute>

   <attribute name="toolBarBreak">

    <bool>false</bool>

   </attribute>

  </widget>

  <widget class="QStatusBar" name="statusBar"/>

 </widget>

 <layoutdefault spacing="6" margin="11"/>

 <resources>

  <include location="GuiQtDev.qrc"/>

 </resources>

 <connections/>

</ui>

GuiQtDev.qrc：

<RCC>

    <qresource prefix="/">

    </qresource>

</RCC>

GuiQtDev.h：

#pragma once

#include <QtWidgets/QMainWindow>

#include "ui_GuiQtDev.h"

class GuiQtDev : public QMainWindow

{

    Q_OBJECT

public:

    GuiQtDev(QWidget *parent = Q_NULLPTR);

private:

    Ui::GuiQtDevClass ui;

};

GuiQtDev.cpp：

#include "GuiQtDev.h"

GuiQtDev::GuiQtDev(QWidget *parent)

    : QMainWindow(parent)

{

    ui.setupUi(this);

}

新建工程：

在解决方案下新建一个modules文件夹，然后右击modules新建空白项目：

然后把源码拖到工程里：

然后设置项目输出目录及项目设置为静态库：

然后设置附加包含目录：

然后设置预处理器：

接下来编辑资源文件：

首先拷贝一个图标文件到源码文件中：

然后在vs中右击qrc文件，选择默认打开方式为QrcEditor.exe：

然后双击qrc文件进行添加图标：

接下来右击ui文件，选择默认打开方式为designer.exe：

双击ui文件进行编辑，比如拖拽一个按钮，并且为按钮显示ico图标（注意后续修改ui文件时要手动重新生成该项目，因为vs无法知道ui文件被修改）：

这样界面就设计好了。

接下来描述GuiQtDev模块编译原理。

首先要使用uic.exe将GuiQtDev.ui转换为ui_GuiGifView.h，然后使用moc.exe将GuiQtDev.h转换为moc_GuiQtDev.cpp，然后使用rcc.exe将GuiQtDev.qrc转换为GuiQtDev.rcc。右击工程在生成前事件中进行自动转换：

右击工程点击生成，则自动生成这3个文件：

然后将ui_GuiQtDev.h和moc_GuiQtDev.cpp拖拽到工程中：

然后在GuiQtDev.cpp中增加rcc资源注册的代码：

然后生成该项目：

6、配置Main工程

首先设置Main工程依赖项：

然后删去原有的Main.cpp，重新写一个

main.cpp：

#if defined(WIN32) | defined(_WINDOWS)

//不显示控制台

#pragma comment(linker,"/subsystem:windows /entry:mainCRTStartup")

#pragma comment(lib, "Shell32.lib")

#pragma comment(lib, "ole32.lib")

#pragma comment(lib, "User32.lib")

#pragma comment(lib, "ws2_32.lib")

#pragma comment(lib, "Advapi32.lib")

#pragma comment(lib, "Crypt32.lib")

#pragma comment(lib, "legacy_stdio_definitions.lib")

#pragma comment(lib, "Winmm.lib")

#pragma comment(lib, "BaseFunc.lib")

#pragma comment(lib, "GuiQtDev.lib")

#ifndef _DEBUG

#pragma comment(lib, "Qt5Core.lib")

#pragma comment(lib, "Qt5Gui.lib")

#pragma comment(lib, "Qt5Widgets.lib")

#else

#pragma comment(lib, "Qt5Cored.lib")

#pragma comment(lib, "Qt5Guid.lib")

#pragma comment(lib, "Qt5Widgetsd.lib")

#endif

#endif

#include "GuiQtDev.h"

int main(int argc, char* argv[])

{

    QApplication app(argc, argv);

    GuiQtDev v;

    v.show();

    app.exec();

    return 0;

}