QtSingleApplication(只允许运行一个实例)使用教程

QtSingleApplication用于实现只运行一个实例，具体使用方法如下。

一、下载源码

源码地址为：https://github.com/qtproject/qt-solutions

有时进入GitHub网页会加载失败，也可直接从https://download.csdn.net/download/m0_67254672/86401164免费下载QtSingleApplication源码。

QtSingleApplication源码目录取下：

 

二、添加源码

将下载好的QtSingleApplication源码添加到工程中，放入.pro文件目录下即可。

 并在.pro文件中加入下句：

include(./qtsingleapplication/src/qtsingleapplication.pri)

 三、修改main.cpp

将QApplication改为QtSingleApplication，并添加如下代码：

#include "mainwindow.h"

#include <QtSingleApplication>
#include <QMessageBox>
#include <QDateTime>

int main(int argc, char *argv[])
{
    QtSingleApplication a("QtSingleApplication_Test_id",argc, argv);
    if(a.isRunning())//判断实例是否已经运行
    {
        QMessageBox::warning(NULL, "提示！", "该程序正在运行中！");

        QString str = "该程序正在运行中！当前时间为：" + QDateTime::currentDateTime().toString("yyyy/MM/dd hh:mm:ss");
        a.sendMessage(str, 4000); //4s后激活前个实例
        return EXIT_SUCCESS;
    }

    MainWindow w;
    a.setActivationWindow(&w，false);
    QObject::connect(&a,&QtSingleApplication::messageReceived,&w,&MainWindow::slotAppend);
    w.show();
    return a.exec();
}

void MainWindow::slotAppend(const QString &message)
{
    ui->textEdit->append(message);
}

其中，需要注意的是：

1.默认情况下，QtSingleApplication使用QApplication::applicationFilePath作为自己的id，用于识别不同的app。如果希望不受程序存放路径影响，则需要在指定id即可。QtSingleApplication app("QtSingleApplication_Test_id",argc, argv);这样即便是在不同的目录的程序，仍能互斥。

2.设置活动窗口的情况下，即使用setActivationWindow(&w)函数，第二个参数默认为true。此时，调用默认的槽函数&QtSingleApplication::activateWindow，当启动实例时发现有实例存在，相当于后面的那个实例启动存在的那个实例。

3.setActivationWindow(&w,false);函数设置为false时，不设置活动窗口，可进行信号槽的重新连接QObject::connect(&a,&QtSingleApplication::messageReceived,&w,&MainWindow::slotAppend);后面的实例的消息可以在已经存在的实例中获取到。