如何在GNOME Builder的单元测试栏中添加自定义测试用例？

1 定位默认测试目录 #

GNOME Builder创建的Python GTK项目默认基于Meson构建系统，自动生成的单元测试文件存放在项目根目录的tests/文件夹下，你找不到源码的默认生成测试也在该路径中，Builder通过同目录下的meson.build文件识别所有测试项。

2 编写自定义单元测试 #

测试规则和常规Python单元测试完全一致：

• 测试文件统一放在tests/目录下，文件名以test_前缀开头
• 推荐使用Python内置unittest框架编写，测试GTK组件时可直接引入对应库调用
  示例测试代码：

import unittest
from gi.repository import Gtk
# 引入你自己的应用模块
from your_app.main_window import MainWindow

class TestMainWindow(unittest.TestCase):
    # 测试主窗口标题是否符合预期
    def test_window_title(self):
        test_win = MainWindow()
        self.assertEqual(test_win.get_title(), "你的应用名称")
    
    # 测试按钮点击逻辑
    def test_button_click(self):
        test_win = MainWindow()
        test_win.test_button.emit("clicked")
        self.assertEqual(test_win.click_count, 1)

3 配置Meson识别自定义测试 #

修改tests/meson.build文件，将你新增的测试文件添加到配置中，示例配置如下：

python = import('python').find_installation('python3')

# 原有默认测试配置
test('default_test', python, args: files('test_default.py'))
# 新增你编写的测试配置
test('test_main_window', python, args: files('test_main_window.py'))
# 每新增一个测试文件就对应添加一行配置

保存配置后点击Builder顶部菜单栏「构建」→「重新配置项目」，让构建系统重新加载测试列表。

4 在Builder测试板块运行测试 #

• 点击左侧边栏烧杯形状的「单元测试」按钮，即可看到所有已配置的测试条目，包含默认生成测试和你新增的自定义测试
• 点击单个测试条目右侧的运行按钮可单独执行该测试，点击板块顶部的全局运行按钮可执行所有测试
• 测试运行的结果、报错日志会直接展示在对应测试条目下方，无需切换终端执行

常见问题排查 #

• 自定义测试没有出现在测试列表：先确认meson.build配置语法正确，再重新配置项目刷新测试列表
• 测试运行提示找不到应用模块：可在测试文件开头添加项目源码路径到Python搜索路径，或在meson.build中配置测试运行时的环境变量

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