Question

如何用Qt写一个同一时间只能运行一个实例的应用程序

Answer 1

为了使一个应用程序在同一时间只运行一个实例，需要用某种方法在程序启动时，检测是否已有正在运行的实例，如果有，则将本次启动的参数传递给前一个实例（例如需要打开的文档的路径），如果没有，则正常启动。
实现的方法有多种：
1. 用Windows API创建一个互斥量：
#include <windows.h>

int main(int argc, char *argv[])
{
QApplication a(argc, argv);

HANDLE hMutex = CreateMutex(NULL, TRUE, L"YourApp"); // 创建一个互斥量来保证只运行一个实例
if(hMutex != NULL)
{
if(GetLastError() == ERROR_ALREADY_EXISTS)
{
QMessageBox::critical(qApp->activeWindow(), QObject::tr("An instance of this application has been run!"), QObject::tr("Only one instance can be run at a time!"));
return 1;
}
}

... // 以下是正常启动代码
}
注：如果保险起见，CreateMutex()中的字符串应该用一个GUID来保证其唯一性，Visual Studio中有一个生成GUID的工具，菜单“工具”->“创建GUID”，选择合适的定义形式，创建并拷贝到剪贴板即可。

此方法的缺点：1.使用了Windows API，不能跨平台；2.不能自动激活前一个实例的窗口。
2. 每次启动时用Windows API枚举进程，同时在第一次运行时用SetProp()函数给当前窗口设置属性，这样下次启动时，在枚举的进程中查找具有这个属性的窗口，若找到，说明已有实例在运行，将该实例的窗口激活；若未找到则正常启动。
此方法客服了前一方法的第2个缺点，但过于依赖Windows API函数（似乎还是MFC函数，对Qt程序好像不可行）。有兴趣的可以照这个链接里的代码试试
3. 利用QLocalSocket和QLocalServer，基本的思路是：
应用程序启动时首先尝试去连接一个QLocalServer，如果连接失败，说明自己是第一个实例，于是创建这么一个QLocalServer，否则将启动参数发送给QLocalServer然后退出。第一个实例的QLocalServer在收到后面启动的实例发来的参数时可以进行处理（例如激活第一个实例的窗口）。这个链接里有详细的示例代码供参考。
注：使用QLocalSocket和QLocalServer时，需要把QtNetwork库包含在项目文件中；
4. 用Qt Solutions里提供的QtSingleApplication类（最简单的方法，推荐）
从ftp://ftp.qt.nokia.com/qt/solutions/lgpl/ 下载QtSingleApplication的源码包，解压缩后按照INSTALL.TXT里的说明进行配置和编译，我选择编译成动态库，这样下次再用，只需引用头文件和lib文件即可，比较方便。
用法很简单，只需把原来main()里的QApplication对象换成QtSingleApplication对象，调用一下isRunning()方法进行判断即可。
// 原来的代码
int main(int argc, char **argv)
{
QApplication app(argc, argv);

MyMainWidget mmw;

mmw.show();
return app.exec();
}

// 修改后的代码
int main(int argc, char **argv)
{
QtSingleApplication app(argc, argv);

if (app.isRunning())
return 0;

MyMainWidget mmw;
mmw.show();
return app.exec();
}
注1：QtSingleApplication的实现方法基本上也是利用QLocalServer和QLocalSocket，所以同样依赖于QtNetwork库；
注2：以上代码只展示了QtSingleApplication最简单的用法，这个类还有更多用法，请参考源码包中带的范例和文档。
QtSingleApplication的几种用法（直接使用源码，编译成动态库等）可以参考这个链接：Qt程序只运行一个实例

Answer 2

为了使一个应用程序在同一时间只运行一个实例，需要用某种方法在程序启动时，检测是否已有正在运行的实例，如果有，则将本次启动的参数传递给前一个实例（例如需要打开的文档的路径），如果没有，则正常启动。
实现的方法有多种：
1. 用Windows API创建一个互斥量：
#include <windows.h>

int main(int argc, char *argv[])
{
QApplication a(argc, argv);

HANDLE hMutex = CreateMutex(NULL, TRUE, L"YourApp"); // 创建一个互斥量来保证只运行一个实例
if(hMutex != NULL)
{
if(GetLastError() == ERROR_ALREADY_EXISTS)
{
QMessageBox::critical(qApp->activeWindow(), QObject::tr("An instance of this application has been run!"), QObject::tr("Only one instance can be run at a time!"));
return 1;
}
}

... // 以下是正常启动代码
}
注：如果保险起见，CreateMutex()中的字符串应该用一个GUID来保证其唯一性，Visual Studio中有一个生成GUID的工具，菜单“工具”->“创建GUID”，选择合适的定义形式，创建并拷贝到剪贴板即可。

此方法的缺点：1.使用了Windows API，不能跨平台；2.不能自动激活前一个实例的窗口。
2. 每次启动时用Windows API枚举进程，同时在第一次运行时用SetProp()函数给当前窗口设置属性，这样下次启动时，在枚举的进程中查找具有这个属性的窗口，若找到，说明已有实例在运行，将该实例的窗口激活；若未找到则正常启动。
此方法客服了前一方法的第2个缺点，但过于依赖Windows API函数（似乎还是MFC函数，对Qt程序好像不可行）。有兴趣的可以照这个链接里的代码试试
3. 利用QLocalSocket和QLocalServer，基本的思路是：
应用程序启动时首先尝试去连接一个QLocalServer，如果连接失败，说明自己是第一个实例，于是创建这么一个QLocalServer，否则将启动参数发送给QLocalServer然后退出。第一个实例的QLocalServer在收到后面启动的实例发来的参数时可以进行处理（例如激活第一个实例的窗口）。这个链接里有详细的示例代码供参考。
注：使用QLocalSocket和QLocalServer时，需要把QtNetwork库包含在项目文件中；
4. 用Qt Solutions里提供的QtSingleApplication类（最简单的方法，推荐）
从ftp://ftp.qt.nokia.com/qt/solutions/lgpl/ 下载QtSingleApplication的源码包，解压缩后按照INSTALL.TXT里的说明进行配置和编译，我选择编译成动态库，这样下次再用，只需引用头文件和lib文件即可，比较方便。
用法很简单，只需把原来main()里的QApplication对象换成QtSingleApplication对象，调用一下isRunning()方法进行判断即可。
// 原来的代码
int main(int argc, char **argv)
{
QApplication app(argc, argv);

MyMainWidget mmw;

mmw.show();
return app.exec();
}

// 修改后的代码
int main(int argc, char **argv)
{
QtSingleApplication app(argc, argv);

if (app.isRunning())
return 0;

MyMainWidget mmw;
mmw.show();
return app.exec();
}
注1：QtSingleApplication的实现方法基本上也是利用QLocalServer和QLocalSocket，所以同样依赖于QtNetwork库；
注2：以上代码只展示了QtSingleApplication最简单的用法，这个类还有更多用法，请参考源码包中带的范例和文档。
QtSingleApplication的几种用法（直接使用源码，编译成动态库等）可以参考这个链接：Qt程序只运行一个实例