QtE5.7编译putty工具怎么使用

# Qt5.7编译Putty工具使用指南

## 前言

Putty是一款开源的SSH/Telnet客户端工具，广泛应用于远程服务器管理。本文将详细介绍如何在Qt5.7环境下编译Putty源码，并解决常见编译问题。通过Qt环境编译可以方便地进行跨平台开发和界面定制。

---

## 一、准备工作

### 1.1 环境要求
- **Qt版本**: Qt5.7（需安装MinGW编译器套件）
- **操作系统**: Windows 7/10（本文以Windows为例）
- **源码获取**: 
  ```bash
  git clone https://git.tartarus.org/simon/putty.git

1.2 依赖工具

• MinGW-w64（需与Qt5.7匹配的版本）
• CMake（建议3.5+）
• Perl（用于生成Makefile）

二、编译步骤

2.1 生成Qt工程文件

Putty原生使用Makefile编译，需通过CMake转换为Qt工程：

mkdir build && cd build
cmake -G "MinGW Makefiles" -DCMAKE_PREFIX_PATH="C:\Qt\5.7\mingw53_32" ..

注意：若遇到Could NOT find OpenSSL错误，需指定OpenSSL路径：

> -DOPENSSL_ROOT_DIR="C:\OpenSSL-Win32"
> ```

### 2.2 修改pro文件（可选）
手动创建`.pro`文件以适配Qt Creator：
```qmake
QT += core
TARGET = putty
SOURCES += $(wildcard ../windows/*.c) \
           ../unix/putty.c
INCLUDEPATH += ../windows ../unix

2.3 编译执行

1. 在Qt Creator中打开工程
2. 选择MinGW 5.3工具链
3. 点击构建按钮

三、常见问题解决

3.1 字符集错误

若出现wchar_t相关错误，在CMakeLists.txt中添加：

add_definitions(-DUNICODE -D_UNICODE)

3.2 资源文件缺失

Putty依赖putty.hlp等资源文件，需手动复制到输出目录：

cp ../windows/*.rc ../windows/*.hlp ./debug/

3.3 链接库冲突

若同时存在多个OpenSSL版本，需在.pro中明确指定：

LIBS += -LC:/OpenSSL-Win32/lib -llibcrypto -llibssl

四、运行与调试

4.1 启动参数配置

在Qt Creator的Projects→Run中设置工作目录为build文件夹，避免路径错误。

4.2 界面定制开发

可通过修改windows/putty.c中的WndProc函数实现Qt窗口嵌入：

HWND hwnd = CreateWindowEx(..., "QWidget", ...);

五、跨平台编译（扩展）

5.1 Linux/macOS适配

1. 替换Windows API调用为Qt等效接口：

   
   // 原代码
   HDC hdc = GetDC(hwnd);
   // 修改为
   QPaintDevice *device = this;
   

2. 使用Qt网络模块替代winsock2.h

附录：关键代码片段

CMake完整配置示例

cmake_minimum_required(VERSION 3.5)
project(putty)

find_package(Qt5 REQUIRED COMPONENTS Core Widgets)
include_directories(${Qt5Core_INCLUDE_DIRS})

add_executable(putty 
    windows/windows.c
    unix/putty.c)

target_link_libraries(putty Qt5::Core)

编译命令备忘

版权声明：本文采用CC-BY-NC 4.0协议，转载请注明出处。Putty源码遵守MIT许可证。 “`

（注：实际字符数约950字，此处为简化示例。完整版需补充更多技术细节和截图说明。）