在Qt Creator中使用LibreOfficeKitGTK控件崩溃问题求助

核心问题 #

在Qt Creator的Qt Widgets项目中集成LibreOfficeKitGtk控件，出现窗口空显示、点击触发SIGSEGV，调用lok_doc_view_open_document()触发SIGABRT的崩溃问题。

可能的错误点及修复方案 #

1. Qt与GTK事件循环冲突 #

Qt和GTK各自有独立的事件循环，仅在main中调用gtk_init不足以协调两者的事件处理：

• 错误表现：GTK控件无法正确接收事件，导致渲染异常或崩溃
• 修复：使用QWidget::createWindowContainer将GTK控件嵌入Qt窗口，确保事件循环协同工作。示例代码：

#include <QWidget>
#include <QWindow>
#include <gtk/gtk.h>
#include <LibreOfficeKitGtk.h>

// 在Qt窗口中嵌入GTK控件
void embedLokView(QWidget *parent) {
    GtkWidget *lokView = lok_doc_view_new();
    gtk_widget_show(lokView);

    // 将GTK控件转为Qt可识别的窗口容器
    QWindow *gtkWindow = QWindow::fromWinId(GDK_WINDOW_XID(gtk_widget_get_window(lokView)));
    QWidget *container = QWidget::createWindowContainer(gtkWindow, parent);
    container->setGeometry(0, 0, 800, 600);
}

2. LibreOfficeKit初始化不完整 #

仅调用lok_init()可能缺少必要的环境初始化：

• 错误表现：lok_doc_view_new()创建的控件处于未就绪状态，操作时触发崩溃
• 修复：初始化时指定LibreOffice安装路径，确保加载正确的运行时库：

// 初始化时指定LibreOffice安装路径（通常为/usr/lib/libreoffice）
if (!lok_init("/usr/lib/libreoffice")) {
    qFatal("Failed to initialize LibreOfficeKit");
}

3. GTK控件生命周期管理错误 #

在按钮点击事件中创建GTK窗口/控件，未正确管理内存和父子关系：

• 错误表现：控件未被正确添加到GTK容器，导致空窗口；内存未正确引用，触发段错误
• 修复：确保创建的LokDocView被添加到GTK窗口容器，且保持对象引用直到窗口销毁：

void onOpenButtonClicked() {
    // 创建GTK窗口作为容器
    GtkWidget *window = gtk_window_new(GTK_WINDOW_TOPLEVEL);
    gtk_window_set_default_size(GTK_WINDOW(window), 800, 600);

    // 创建LokDocView并添加到窗口
    GtkWidget *lokView = lok_doc_view_new();
    gtk_container_add(GTK_CONTAINER(window), lokView);

    // 加载文档
    lok_doc_view_open_document(LOK_DOC_VIEW(lokView), "/path/to/your/document.odt");

    // 显示所有控件
    gtk_widget_show_all(window);
}

4. .pro文件依赖配置遗漏 #

当前LIBS可能缺少LibreOfficeKit核心库：

• 错误表现：运行时无法找到完整的LibreOfficeKit依赖，触发SIGABRT
• 修复：添加LibreOfficeKit核心库链接：

LIBS += -llibreofficekit -llibreofficekitgtk

5. 线程安全问题 #

LibreOfficeKitGtk的操作必须在GTK主线程执行，Qt的按钮点击事件在Qt线程中，跨线程调用GTK API会导致崩溃：

• 错误表现：跨线程操作GTK控件触发SIGSEGV/SIGABRT
• 修复：使用GTK的g_idle_add将操作投递到GTK主线程：

gboolean loadDocument(gpointer data) {
    LokDocView *view = LOK_DOC_VIEW(data);
    lok_doc_view_open_document(view, "/path/to/document.odt");
    return FALSE;
}

void onLoadButtonClicked() {
    // 假设lokView是已创建的控件指针
    g_idle_add(loadDocument, lokView);
}

内容的提问来源于stack exchange，提问作者Maxi-Hard