22.6 Qt 开发环境

Qt 作为跨平台应用程序开发框架的代表，其设计哲学与 FreeBSD 的可移植性目标高度契合。

安装 Qt Creator

技巧

可能还需要安装 CMake（cmake）工具。

使用 Ports 安装（不建议使用 Qt Creator 的二进制包，原因是可能存在兼容性和本地化支持问题）：

# cd /usr/ports/devel/qtcreator/ && make install clean # 安装 Qt Creator 本体
# cd /usr/ports/misc/qt5-l10n/ && make install clean # 安装 Qt Creator 本地化语言包（如中文）

或使用 pkg 命令安装：

# pkg install qtcreator qt5-l10n

/usr/
└── ports/
    ├── devel/
    │   └── qtcreator/ # Qt Creator IDE Port
    └── misc/
        └── qt5-l10n/ # Qt5 本地化语言包 Port

Qt Creator 中文化

参见 Bug 236518 - devel/qtcreator unsupported other languages，记录 Qt Creator 在 FreeBSD 上的多语言支持问题。

Qt Creator 界面语言默认跟随系统。如果未随系统更改，请在菜单中依次选择 Edit -> Preferences -> Environment -> Interface -> Language 手动设置。

编译器和调试器通常无需手动配置。

在 Qt Creator 中开发的程序可能无法输入中文，这是因为 Qt 支持输入法依赖插件机制。Qt 通过平台输入上下文（Platform Input Context）插件与系统输入法框架集成，常见的插件包括 IBus 和 Fcitx 5 等。

列出 Qt5 平台输入上下文（Platform Input Context）插件目录下的文件：

$ ls /usr/local/lib/qt5/plugins/platforminputcontexts

可以看到以下输出：

libfcitx5platforminputcontextplugin.so   # Fcitx5 输入法平台插件
libibusplatforminputcontextplugin.so     # IBus 输入法平台插件

/usr/local/
└── lib/
    └── qt5/
        └── plugins/
            └── platforminputcontexts/
                ├── libfcitx5platforminputcontextplugin.so # Fcitx5 输入法平台插件
                └── libibusplatforminputcontextplugin.so # IBus 输入法平台插件

这些插件分别对应 IBus 和 Fcitx 5。无法输入中文可能是因为这两个插件依赖的库版本存在不兼容问题。

为解决此类问题，应通过 Ports 编译安装 Qt Creator，而非使用 pkg 安装。

界面翻译不完整问题

有志于参与 Qt 翻译的人应关注以下资源：

• Qt Localization ，Qt 官方本地化工作指南与资源汇总。

• qttranslations ，Qt 框架多语言翻译文件仓库。

Hello World（示例程序）

本节通过一个简单的示例程序，展示如何在 Qt Creator 中创建并运行第一个 Qt 应用程序。完成 Qt Creator 的安装和配置后，我们可以开始编写第一个程序了。以下是操作步骤的图示说明：

在终端输出

除了图形界面程序外，Qt Creator 也可以用于开发命令行程序。对于一些不需要图形界面的应用，我们可以直接在终端中运行和查看输出。以下是在终端输出结果的示例：

故障排除与未竟事宜

终端汉字显示缺失

此问题尚未解决。

课后习题

1. 使用 Qt Creator 创建一个简单的图形界面程序，配置输入法插件实现中文输入，并测试运行。

2. 通过 Ports 编译安装 Qt Creator 及其依赖库，调试并修复中文输入问题。

3. 贡献 Qt Creator 的 UI 简体中文翻译。