Gdk4剪贴板联合提供者无法向第三方应用正常提供数据

问题诊断 #

你的代码在自研程序中正常工作，但第三方应用无法粘贴，核心问题集中在以下几点：

• 编码不规范：如果csv_data是字符串类型，直接传入GLib.Bytes.new会导致字节数据不符合UTF-8标准，第三方应用依赖规范编码读取文本。
• 格式优先级与兼容性：部分GTK应用/桌面环境对Gdk.ContentProvider.new_union的格式顺序敏感，内部格式前置会导致常用的text/plain/text/csv不被优先识别。
• 内容未持久化：默认剪贴板内容在应用失去焦点后可能被清理，第三方应用无法获取到持久化的系统剪贴板数据。

修复方案 #

1. 确保文本数据UTF-8编码

将CSV字符串转为UTF-8字节，这是第三方应用读取文本的标准要求：

# 生成CSV并转为UTF-8字节
csv_str = self.get_csv_data_for_selected_cells()
csv_data = csv_str.encode('utf-8')

2. 调整格式优先级并优化内容提供器

将第三方应用常用的text/plain、text/csv放在union provider的最前面，确保优先被识别：

# 创建内容提供器，优先放置通用格式
text_provider = Gdk.ContentProvider.new_for_bytes("text/plain", GLib.Bytes.new(csv_data))
csv_provider = Gdk.ContentProvider.new_for_bytes("text/csv", GLib.Bytes.new(csv_data))
selection_provider = Gdk.ContentProvider.new_for_bytes("application/x-tab-selection", gbytes_selection)

# 按优先级组合提供器
union_provider = Gdk.ContentProvider.new_union([text_provider, csv_provider, selection_provider])

3. 强制剪贴板内容持久化

调用clipboard.store()将内容保存到系统剪贴板，避免应用失去焦点后数据丢失：

clipboard.set_content(union_provider)
clipboard.store()  # 关键：强制持久化到系统剪贴板

4. 完善调试逻辑

使用read_all_async查看所有可用格式，确认第三方应用需要的格式是否正确注册：

def on_retrieve_all_formats(self, clipboard, result):
    try:
        formats, content = clipboard.read_all_finish(result)
        print(f"可用格式: {Gdk.ContentFormats.to_string(formats)}")
        # 验证text/plain格式
        if formats.contain("text/plain"):
            content.read_value_async(GObject.TYPE_STRING, None, self.on_read_text)
    except Exception as e:
        print(f"读取剪贴板失败: {e}")

def on_read_text(self, content, result):
    try:
        text = content.read_value_finish(result)
        print(f"读取text/plain内容: {text}")
    except Exception as e:
        print(f"读取text/plain失败: {e}")

# 替换原有的read_text_async调用
clipboard.read_all_async(None, self.on_retrieve_all_formats)

完整修改后的代码 #

# Access the default clipboard for the application
clipboard = Gdk.Display.get_default().get_clipboard()

# Generate CSV data for external use, ensure UTF-8 encoding
csv_str = self.get_csv_data_for_selected_cells()
csv_data = csv_str.encode('utf-8')

# Generate and serialize internal selection data
selection = {
    'sheet_name': self.model.sheets[self.model.current_sheet_index]['name'],
    'selected_cells': self._all_selected_cells
}
serialized_selection = pickle.dumps(selection)
gbytes_selection = GLib.Bytes.new(serialized_selection)

# Create content providers with priority order
text_provider = Gdk.ContentProvider.new_for_bytes("text/plain", GLib.Bytes.new(csv_data))
csv_provider = Gdk.ContentProvider.new_for_bytes("text/csv", GLib.Bytes.new(csv_data))
selection_provider = Gdk.ContentProvider.new_for_bytes("application/x-tab-selection", gbytes_selection)

# Combine providers
union_provider = Gdk.ContentProvider.new_union([text_provider, csv_provider, selection_provider])

# Debug: print supported formats
print(Gdk.ContentFormats.to_string(union_provider.ref_formats()))

# Set clipboard content and persist to system clipboard
clipboard.set_content(union_provider)
clipboard.store()

# Verify all available formats
clipboard.read_all_async(None, self.on_retrieve_all_formats)

# Restore focus to main view
self.view.sourceview.grab_focus()
self.view.scrolled_window.grab_focus()

# Callback functions for verification
def on_retrieve_all_formats(self, clipboard, result):
    try:
        formats, content = clipboard.read_all_finish(result)
        print(f"可用格式: {Gdk.ContentFormats.to_string(formats)}")
        if formats.contain("text/plain"):
            content.read_value_async(GObject.TYPE_STRING, None, self.on_read_text)
        if formats.contain("text/csv"):
            content.read_value_async(GObject.TYPE_STRING, None, self.on_read_csv)
    except Exception as e:
        print(f"读取剪贴板失败: {e}")

def on_read_text(self, content, result):
    try:
        text = content.read_value_finish(result)
        print(f"读取text/plain内容: {text}")
    except Exception as e:
        print(f"读取text/plain失败: {e}")

def on_read_csv(self, content, result):
    try:
        csv = content.read_value_finish(result)
        print(f"读取text/csv内容: {csv}")
    except Exception as e:
        print(f"读取text/csv失败: {e}")

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