别只装Qt！在Deepin 20.6上配置Qt 6.3.1时，这3个环境（Android/WebAssembly/输入法）的坑你得提前知道

Deepin 20.6上Qt 6.3.1环境配置避坑指南：Android/WebAssembly/输入法全攻略

在Deepin 20.6上配置Qt 6.3.1开发环境时，很多开发者会遇到一些"隐藏"的依赖问题。这些问题往往在Qt主程序安装完成后才会暴露，导致反复折腾和浪费时间。本文将重点解决三个最棘手的配置场景：Android开发环境、WebAssembly编译环境和中文输入法支持。

1. Android开发环境：SDK/NDK/OpenSSL的精准配置

Android开发是Qt跨平台能力的重要一环，但配置过程中SDK、NDK和OpenSSL的路径问题经常让开发者头疼。以下是关键步骤和常见陷阱：

1.1 前置依赖安装

在安装Qt之前，需要确保系统具备Java环境：

sudo apt update sudo apt install -y default-jdk openjdk-11-jdk

注意：Qt 6.3.1对Java版本有特定要求，推荐使用OpenJDK 11而非最新版本。

1.2 Android Studio的正确安装方式

Deepin应用商店提供的Android Studio可能不是最新版，建议直接从官网下载：

wget https://redirector.gvt1.com/edgedl/android/studio/ide-zips/2022.2.1.20/android-studio-2022.2.1.20-linux.tar.gz tar -xzf android-studio-*.tar.gz -C ~/

安装后启动Android Studio，在SDK Manager中必须选择以下组件：

1.3 OpenSSL的特殊处理

Qt Android应用需要特定版本的OpenSSL：

wget https://github.com/KDAB/android_openssl/archive/refs/tags/openssl_1_1_1k.zip unzip openssl_1_1_1k.zip -d ~/Android/Sdk/ mv ~/Android/Sdk/android_openssl-openssl_1_1_1k ~/Android/Sdk/android_openssl

2. WebAssembly环境：emsdk与QtCreator的无缝集成

WebAssembly是Qt的前沿技术方向，但emsdk的配置往往让开发者踩坑。

2.1 emsdk的正确安装流程

避免使用系统包管理器安装emsdk，应采用官方推荐方式：

git clone https://github.com/emscripten-core/emsdk.git ~/emsdk cd ~/emsdk ./emsdk install 3.1.15 ./emsdk activate 3.1.15

为什么选择3.1.15？这是经过Qt 6.3.1官方测试的稳定版本。

2.2 环境变量配置技巧

不要在~/.bashrc中直接添加source命令，而是创建专用配置文件：

echo 'source $HOME/emsdk/emsdk_env.sh --quiet > /dev/null' > ~/.emsdkrc echo 'source ~/.emsdkrc' >> ~/.bashrc

这种做法的优势：

• 避免污染全局环境
• 可以单独禁用emsdk环境
• 启动时不会输出冗长信息

2.3 QtCreator中的特殊设置

在QtCreator的WebAssembly配置页面，需要特别注意：

1. 手动指定emsdk路径为~/emsdk
2. 在Kits配置中，检查以下编译器路径是否正确：
   • C编译器：~/emsdk/upstream/emscripten/emcc
   • C++编译器：~/emsdk/upstream/emscripten/em++

3. 中文输入法支持：fcitx for Qt6的完整解决方案

Deepin默认使用fcitx输入法框架，但Qt6需要特殊插件支持。

3.1 插件获取的正确途径

不要从非官方渠道下载插件，建议从Deepin仓库获取：

sudo apt install fcitx-frontend-qt6

如果仓库版本不兼容，可以手动编译：

git clone https://github.com/fcitx/fcitx-qt6.git mkdir build && cd build cmake .. -DCMAKE_INSTALL_PREFIX=/usr make -j4 sudo make install

3.2 插件的部署位置

Qt6输入法插件需要放置在两个关键位置：

1. Qt主目录：

   ~/Qt/6.3.1/gcc_64/plugins/platforminputcontexts/

2. QtCreator目录：

   ~/Qt/Tools/QtCreator/lib/Qt/plugins/platforminputcontexts/

重要提示：部署后需要重启QtCreator才能生效。

3.3 输入法调试技巧

如果输入法仍然不工作，可以启用调试模式：

export QT_LOGGING_RULES=qt.qpa.input*=true qtcreator

这将输出详细的输入法加载日志，帮助定位问题。

4. 系统级依赖的隐藏陷阱

除了上述三大环境，还有一些系统级依赖需要注意。

4.1 libxcb-util的兼容性问题

Deepin 20.6默认仓库可能缺少必要的库：

wget http://ftp.debian.org/debian/pool/main/libx/libxcb/libxcb-util1_0.4.0-1+b1_amd64.deb sudo dpkg -i libxcb-util1_0.4.0-1+b1_amd64.deb

4.2 图形驱动相关依赖

确保安装了Mesa驱动和开发文件：

sudo apt install libgl1-mesa-dev libegl1-mesa-dev libgles2-mesa-dev

4.3 调试工具链完整性

完整的开发工具链应包括：

• gdb 8.2+
• cmake 3.20+
• ninja-build

安装命令：

sudo apt install gdb cmake ninja-build

5. QtCreator配置的最佳实践

正确配置QtCreator可以避免后续开发中的各种问题。

5.1 Android设备配置细节

在QtCreator中添加Android设备时，关键参数设置：

• ABI：优先选择arm64-v8a
• Target API：与SDK Platform版本一致
• 设备定义：选择与测试设备最接近的型号

5.2 构建套件(Kits)的检查清单

每个Kit应验证以下设置：

1. 编译器：匹配Qt版本要求
2. 调试器：自动检测到的gdb路径
3. Qt版本：完整路径指向6.3.1
4. CMake配置：使用Qt自带的CMake

5.3 项目模板的特殊处理

创建新项目时，建议：

1. 先创建纯Qt Widgets项目测试环境
2. 确认能编译运行后再添加复杂模块
3. 对于Android项目，初始选择API级别31

6. 环境验证与问题排查

完成所有配置后，需要进行系统化验证。

6.1 Android环境验证步骤

创建简单的QML应用，检查：

1. 能否部署到模拟器
2. 能否生成签名的APK
3. OpenSSL功能是否正常

6.2 WebAssembly测试方法

使用以下命令测试Emscripten环境：

echo 'int main(){ return 0; }' > test.c emcc test.c -o test.html python3 -m http.server 8000

然后在浏览器访问localhost:8000/test.html

6.3 输入法问题诊断

如果输入法仍不正常，检查：

1. 插件文件权限是否为755
2. 是否有多余的老版本插件残留
3. fcitx-daemon是否正常运行

在实际项目中，我发现最常被忽视的是Android的OpenSSL配置。有一次花费数小时排查SSL连接问题，最终发现是OpenSSL路径包含中文目录。建议所有开发环境路径都使用纯英文命名。