Android平台Qt5.5.1共享库事件循环启动及信号槽失效解决方法

刚好之前处理过类似的Qt Android共享库问题，你的判断完全正确——信号槽失效就是因为共享库内部没有运行Qt的事件循环，Qt的信号分发、槽函数调用全靠事件循环来驱动。下面给你几个可行的解决办法：

1. 在共享库初始化时启动本地事件循环 #

如果你的共享库是在独立线程中被加载的，可以在库的入口初始化函数里创建并启动QEventLoop，示例代码如下：

#include <QEventLoop>
#include <QTimer>

// 假设这是你的JNI入口函数，被Android端调用初始化库
extern "C" void JNICALL Java_com_your_package_MyNativeLib_init(JNIEnv* env, jobject thiz) {
    QEventLoop loop;
    
    // 用QTimer触发初始化逻辑，避免阻塞事件循环启动
    QTimer::singleShot(0, [&]() {
        // 在这里完成库的初始化，比如创建对象、连接信号槽
        setupLibComponents();
    });
    
    // 启动事件循环，这个调用会阻塞当前线程，直到你调用loop.quit()退出
    loop.exec();
}

如果共享库是被Qt Android应用的主线程加载的，那主线程本身已经有Qt的事件循环，这种情况你只需要确保信号槽连接正确即可；但如果是被纯Android原生应用调用，那不管主线程还是子线程，都得手动启动事件循环。

2. 把库逻辑放到独立线程中运行 #

要是不想阻塞加载库的线程，可以把共享库的核心逻辑封装到QThread子类里，在子线程内部启动事件循环：

#include <QThread>
#include <QEventLoop>

class LibraryWorker : public QThread {
    Q_OBJECT
protected:
    void run() override {
        QEventLoop loop;
        // 初始化库的业务逻辑，包括信号槽连接
        initLibraryLogic();
        // 启动子线程的事件循环
        loop.exec();
    }
private:
    void initLibraryLogic() {
        // 这里写你的库初始化代码，比如创建业务对象、连接信号槽
    }
};

// 库初始化入口
extern "C" void JNICALL Java_com_your_package_MyNativeLib_init(JNIEnv* env, jobject thiz) {
    static LibraryWorker worker;
    // 启动子线程，事件循环会在run()方法中启动
    worker.start();
}

这种方式的好处是事件循环在子线程运行，不会阻塞主线程，而且符合Qt的线程模型，跨线程的信号槽也能正常工作。

3. 检查信号槽的连接细节 #

除了事件循环，还要确认信号槽的连接是否符合Qt的规则：

• 跨线程连接时，确保使用Qt::QueuedConnection（默认跨线程连接就是这个类型，不用手动指定也可以），避免因为线程上下文不匹配导致槽函数不执行。
• 如果你用的是旧的SIGNAL/SLOT宏，要确保函数签名完全一致；用新的Lambda或函数指针连接的话，要注意捕获变量的生命周期。

示例的Lambda连接方式：

connect(yourSender, &YourSenderClass::yourSignal, yourReceiver, [=]() {
    // 槽函数的具体逻辑
});

额外注意事项 #

• 确保共享库正确链接了QtCore模块，事件循环依赖这个核心模块才能运行。
• 如果是JNI调用场景，要确保Qt的JNI环境初始化正确，比如调用QtAndroid::initialize()（如果用到了Qt Android的相关API）。
• 不要在事件循环运行的线程中执行耗时操作，否则会阻塞事件循环，导致信号槽无法及时处理。

内容的提问来源于stack exchange，提问作者Jian Liu