如何在Python中调用Vala编写的自定义GTK部件？异常问题求助

首先拍板：这种调用方式完全可行，问题绝对不是Python的锅，大概率出在你的Vala部件实现、编译配置或者Python调用的细节上。下面咱们一步步排查解决：

一、先确认你的Vala部件本身没问题 #

首先得确保circular-progress-bar.vala里的进度条是个完整可工作的GTK部件。比如你是不是只定义了一个带文本属性的类，但没重写draw方法来绘制进度条的图形部分？如果是这样，那Python调用后自然只会显示文本，因为部件根本没做绘制逻辑。

给你个极简的可工作Vala部件示例参考：

public class TestShared.CircularProgressBar : Gtk.Widget {
    public double progress { get; set; } = 0.0;
    public string label { get; set; } = "";

    public CircularProgressBar() {
        this.set_size_request(100, 100);
    }

    protected override bool draw(Cairo.Context cr) {
        // 画背景灰圆
        cr.set_source_rgb(0.8, 0.8, 0.8);
        cr.arc(this.get_allocated_width()/2.0, this.get_allocated_height()/2.0, 40, 0, 2*Math.PI);
        cr.fill();

        // 画进度蓝弧
        cr.set_source_rgb(0.2, 0.6, 1.0);
        cr.arc(this.get_allocated_width()/2.0, this.get_allocated_height()/2.0, 40, -Math.PI/2, -Math.PI/2 + 2*Math.PI*progress);
        cr.line_to(this.get_allocated_width()/2.0, this.get_allocated_height()/2.0);
        cr.fill();

        // 画中心文本
        Pango.Layout layout = this.create_pango_layout(this.label);
        int width, height;
        layout.get_size(out width, out height);
        cr.move_to((this.get_allocated_width() - width/Pango.SCALE)/2.0, (this.get_allocated_height() - height/Pango.SCALE)/2.0);
        Pango.cairo_show_layout(cr, layout);

        return true;
    }
}

二、检查编译步骤的细节 #

你的编译命令看起来大方向对，但有几个小细节要盯紧：

1. 确认--library=testShared的命名和后续GIR/typelib的命名完全一致，别拼错字母大小写。
2. 编译完的test_shared.so和testShared-0.1.typelib要放在系统能找到的路径里：
   • 要么把.so丢去/usr/lib/，或者临时设置LD_LIBRARY_PATH指向你的编译目录
   • 要么把.typelib丢去/usr/lib/girepository-1.0/，或者临时设置GI_TYPELIB_PATH指向编译目录
     嫌麻烦的话，也可以在Python代码开头加这两行临时设置：

   import os
   os.environ['LD_LIBRARY_PATH'] = f'./:{os.environ.get("LD_LIBRARY_PATH", "")}'
   os.environ['GI_TYPELIB_PATH'] = f'./:{os.environ.get("GI_TYPELIB_PATH", "")}'
   

三、Python调用的正确姿势 #

确保你的Python代码正确初始化了GTK，并且正确实例化、添加了部件：

import gi
gi.require_version('Gtk', '3.0')
# 加载自定义库，版本要和GIR里的0.1完全匹配
gi.require_version('TestShared', '0.1')
from gi.repository import Gtk, TestShared

class TestWindow(Gtk.Window):
    def __init__(self):
        super().__init__(title="Circular Progress Test")
        self.set_default_size(300, 300)

        # 实例化自定义进度条，设置属性
        progress_bar = TestShared.CircularProgressBar()
        progress_bar.label = "50%"
        progress_bar.progress = 0.5

        self.add(progress_bar)

win = TestWindow()
win.connect("destroy", Gtk.main_quit)
win.show_all()
Gtk.main()

四、排查小技巧 #

1. 运行Python代码时，别忽略终端的报错信息！如果提示GIR加载失败，那肯定是typelib路径不对。
2. 用g-ir-inspect TestShared 0.1命令检查你的GIR是否正确导出了部件，要是看不到CircularProgressBar，说明编译时GIR生成出问题了。
3. 编译Vala时别忽略警告，比如如果部件没正确注册到GObject类型系统，也会导致无法正常显示。

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