Qt单实例托盘应用：如何唤起已有实例并退出新实例？

你的现有代码已经实现了单实例检测，但缺少新实例通知旧实例唤起窗口的关键步骤。直接用QSharedMemory只能判断是否有实例在跑，没法传递“唤起窗口”的指令，我们可以用Qt的QLocalSocket和QLocalServer来实现进程间通信，具体改造如下：

1. 改造main.cpp代码 #

我们需要在旧实例中启动一个本地服务，新实例检测到已有实例时，通过套接字给旧实例发消息，然后新实例直接退出；旧实例收到消息后，就把窗口显示到前台。

#include <QApplication>
#include <QQmlApplicationEngine>
#include <QIcon>
#include <QSystemTrayIcon>
#include <QQmlContext>
#include <QSystemSemaphore>
#include <QSharedMemory>
#include <QLocalServer>
#include <QLocalSocket>
#include <QWindow>

Q_DECLARE_METATYPE(QSystemTrayIcon::ActivationReason)

// 唤起主窗口的工具函数
void activateMainWindow(QWindow* window) {
    if (!window) return;
    // 把窗口显示到前台并激活
    window->show();
    window->raise();
    window->requestActivate();
}

Q_DECL_EXPORT int main(int argc, char *argv[]) {
#if defined(Q_OS_WIN)
    QCoreApplication::setAttribute(Qt::AA_EnableHighDpiScaling);
#endif
    QApplication app(argc, argv);
    app.setApplicationName("DeployApp");
    const QString serverName = app.applicationName() + "_LocalServer";

    // 保留原有单实例检测逻辑
    QSystemSemaphore semaphore("deploy_sem", 1);
    semaphore.acquire();
#ifndef Q_OS_WIN32
    QSharedMemory nix_fix_shared_memory("deploy_shared_mem");
    if(nix_fix_shared_memory.attach()){
        nix_fix_shared_memory.detach();
    }
#endif
    QSharedMemory sharedMemory("deploy_shared_mem");
    bool is_running = sharedMemory.attach();
    if (!is_running) {
        sharedMemory.create(1);
    }
    semaphore.release();

    // 新实例逻辑：发送唤起指令后立即退出
    if (is_running) {
        QLocalSocket socket;
        socket.connectToServer(serverName);
        if (socket.waitForConnected(1000)) {
            socket.write("show");
            socket.waitForBytesWritten(100);
        }
        return 0;
    }

    // 旧实例逻辑：启动本地服务监听新实例的消息
    QLocalServer server;
    if (!server.listen(serverName)) {
        // 清理残留套接字后重试
        QLocalServer::removeServer(serverName);
        server.listen(serverName);
    }

    QQmlApplicationEngine engine;
    qmlRegisterType<QSystemTrayIcon>("QSystemTrayIcon", 1, 0, "QSystemTrayIcon");
    qRegisterMetaType<QSystemTrayIcon::ActivationReason>("ActivationReason");
    engine.rootContext()->setContextProperty("iconTray", QIcon(":/deploy.png"));
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));

    if (engine.rootObjects().isEmpty()) return -1;

    // 获取主窗口对象
    QWindow* mainWindow = qobject_cast<QWindow*>(engine.rootObjects().first());

    // 处理新实例的连接请求
    QObject::connect(&server, &QLocalServer::newConnection, [&]() {
        QLocalSocket* socket = server.nextPendingConnection();
        if (socket->waitForReadyRead(1000)) {
            QString message = QString::fromUtf8(socket->readAll());
            if (message == "show") {
                activateMainWindow(mainWindow);
            }
        }
        socket->deleteLater();
    });

    return app.exec();
}

2. 优化main.qml（可选） #

你的QML代码已经实现了托盘逻辑，这里可以优化下窗口切换的细节，确保唤起时窗口能正确置顶：

import QtQuick 2.9
import QtQuick.Controls 2.2
import QtQuick.Controls 1.4 as Tray
import QtQuick.Window 2.0
import QSystemTrayIcon 1.0

Window {
    visible: true
    id: application
    width: 640
    height: 480
    title: qsTr("Test")

    QSystemTrayIcon {
        id: systemTray
        Component.onCompleted: {
            icon = iconTray
            toolTip = "Deploy App"
            show()
        }

        onActivated: {
            if(reason === QSystemTrayIcon.Context) { // 右键弹出菜单
                trayMenu.popup()
            } else { // 左键切换显示/隐藏
                if (application.visibility === Window.Hidden) {
                    application.show()
                    application.raise()
                    application.requestActivate()
                } else {
                    application.hide()
                }
            }
        }
    }

    Tray.Menu {
        id: trayMenu
        Tray.MenuItem {
            text: qsTr("Show App")
            onTriggered: {
                application.show()
                application.raise()
                application.requestActivate()
            }
        }
        Tray.MenuItem {
            text: qsTr("Quit")
            onTriggered: {
                systemTray.hide()
                Qt.quit()
            }
        }
    }
}

关键逻辑说明 #

• 单实例检测：保留你原来的QSystemSemaphore+QSharedMemory方案，确保同一时间只有一个实例能创建共享内存。
• 进程间通信：旧实例启动QLocalServer监听特定名称的套接字；新实例检测到已有实例时，通过QLocalSocket连接并发送"show"指令，随后直接退出。
• 窗口唤起：旧实例收到指令后，调用activateMainWindow函数，将窗口显示、置顶并激活，确保用户能立即看到。

这样改造后，启动新实例时，它会自动唤起已运行的窗口，然后自己退出，完全符合你的需求。

内容的提问来源于stack exchange，提问作者Junius L