📚 课程目录第1章搭建WPA3开发环境

1. 搭建WPA3开发环境

任务说明

本案例目标是在Linux系统上搭建WPA3开发环境，安装编译工具链、OpenSSL开发库及WPA3相关的头文件，并验证关键头文件（如 wpa_supplicant 相关头文件）可用。完成本案例后，应具备编译WPA3应用程序的基础条件。

系统要求与依赖

推荐使用Ubuntu 22.04 LTS或Debian 12（Bookworm）作为开发系统。需要root权限或sudo权限执行安装命令。核心依赖包括：

编译工具链：build-essential（gcc/g++/make）
OpenSSL开发库：libssl-dev（提供WPA3所需的加密算法接口）
WPA3相关头文件：wpa_supplicant 开发头文件（来自 libwpa-dev 或源码包）
版本控制工具：git（用于获取WPA3示例代码）

环境安装步骤

执行以下命令完成基础环境配置：

sudo apt update
sudo apt install -y build-essential libssl-dev git pkg-config
# 安装wpa_supplicant开发头文件（提供wpa_ctrl.h等）
sudo apt install -y libwpa-dev

若发行版仓库中没有 libwpa-dev，可改为从源码安装wpa_supplicant以获取头文件：

git clone git://w1.fi/hostap.git
cd hostap/wpa_supplicant
cp defconfig .config
make -j$(nproc)
# 头文件位于 hostap/src/ 目录下，后续编译时需通过 -I 指定路径

验证头文件可用性

编写一个简单的C程序，包含WPA3开发中常用的头文件，并调用OpenSSL的版本函数确认链接正常。创建 env_check.c：

#include <stdio.h>
#include <openssl/ssl.h>
#include <openssl/evp.h>
#include "wpa_ctrl.h"   // 来自libwpa-dev或hostap源码

int main() {
    printf("OpenSSL version: %s\n", OpenSSL_version(OPENSSL_VERSION));
    printf("wpa_ctrl.h included successfully.\n");
    return 0;
}

编译并运行：

# 若使用libwpa-dev安装的头文件
gcc env_check.c -o env_check $(pkg-config --cflags --libs openssl) -lwpa_client
# 若使用hostap源码，需指定头文件路径，例如：
# gcc env_check.c -o env_check -I/path/to/hostap/src/common $(pkg-config --cflags --libs openssl)

./env_check

验证判定标准

满足以下条件即视为环境搭建成功：

上述命令无报错执行完毕，env_check 可执行文件成功生成。
运行 ./env_check 输出OpenSSL版本号（如 OpenSSL 3.0.2）以及 wpa_ctrl.h included successfully.。
若使用源码方式，确认 hostap/src 目录下存在 common/wpa_ctrl.h、common/defs.h 等关键头文件。

常见问题排查

找不到 wpa_ctrl.h：确认已安装 libwpa-dev，或正确指定了hostap源码路径。头文件位于 hostap/src/common 目录。
OpenSSL版本过低：WPA3需要OpenSSL 1.1.1以上版本，Ubuntu 22.04默认提供OpenSSL 3.0，满足要求。
链接错误 undefined reference to wpa_ctrl_*：编译时需添加 -lwpa_client 链接库（方式A），或直接编译hostap源码中的相关源文件。