gtk4-builder-tool

验证

validate 命令会验证给定的 UI 定义文件，并将错误报告到 stderr。

请注意，对模板的验证有限制，因为它们与它们使用的类 init 函数密切相关。如果您的 UI 文件使用来自第三方库的类型，向 LD_PRELOAD 环境变量添加这些库可能会有所帮助。

--deprecations

警告在 UI 定义文件中使用已弃用类型。

枚举

enumerate 命令会打印出 UI 定义文件中存在的所有命名对象。

--callbacks

同时打印回调的名称。

预览

preview 命令会显示 UI 定义文件。

此命令接受选项来指定顶层对象的 ID 和要使用的 CSS 文件。

--id=ID

要预览的对象的 ID。如果没有指定，gtk4-builder-tool 将自行选择一个合适对象。

--css=FILE

从指定的 CSS 文件中加载样式信息。

渲染

render 命令将 UI 定义文件的渲染保存为 png 图像或节点文件。要写入的文件名可以指定为第二个 FILE 参数。

此命令接受选项来指定顶层对象的 ID 和要使用的 CSS 文件。

--id=ID

要预览的对象的 ID。如果没有指定，gtk4-builder-tool 将自行选择一个合适对象。

--css=FILE

从指定的 CSS 文件中加载样式信息。

--node

写入序列化的节点文件而不是 png 图像。

--force

覆盖现有文件。

截图

screenshot 命令是 render 的别名词。

简化

simplify 命令通过删除设置为默认值的属性来简化 UI 定义文件，并将结果 XML 写到标准输出或输入文件中。

当指定 --3to4 选项时，simplify 命令将输入解释为 GTK 3 UI 定义文件，并尝试将其转换为 GTK 4 等价物。它执行各种转换，例如重命名属性，将子属性转换为布局属性，重新编写 GtkNotebook、GtkStack、GtkAssistant 的设置，或将工具栏改为框。

在将修改后的 UI 定义文件用于生产之前，您应该始终测试由 gtk4-builder-tool 生成的修改后的 UI 定义文件。

请注意，--3to4 的转换意味着从 GTK 3 到 GTK 4 的迁移的起点。您预计在初始转换后需要对 GUI 进行手动修复。

--replace

将内容写回到 UI 定义文件，而不是使用标准输出。

–3到4

将GTK 3 UI定义文件转换为等效的GTK 4定义。