Qt-AES 项目使用教程

1. 项目的目录结构及介绍

Qt-AES 项目是一个基于 Qt 的 AES 加密类库，提供了简单易用的 AES 加密和解密功能。以下是项目的目录结构及其简介：

• CMakeLists.txt：CMake 配置文件，用于构建项目。
• CONTRIBUTING.md：贡献指南，介绍了如何为项目贡献代码。
• LICENSE：项目许可证文件，本项目采用 UNLICENSE 许可。
• README.md：项目说明文件，包含了项目的基本信息和用法介绍。
• QtAESConfig.cmake.in：CMake 配置文件模板，用于生成 QtAESConfig.cmake 文件。
• main.cpp：主程序文件，包含了项目的主入口点。
• qaesencryption.cpp：AES 加密类实现文件。
• qaesencryption.h：AES 加密类声明文件。
• qaesencryption.pro：Qt 项目文件，用于配置 Qt Creator。
• res.qrc：资源文件，可用于存储项目所需的资源。
• unit_test：单元测试目录，包含了项目的单元测试代码。

2. 项目的启动文件介绍

项目的启动文件是 main.cpp，它包含了项目的主入口点。以下是一个简单的示例，展示了如何使用 Qt-AES 类进行加密和解密操作：

#include "qaesencryption.h"

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    // 创建 AES 加密对象
    QAESEncryption encryption(QAESEncryption::AES_128, QAESEncryption::ECB);

    // 待加密的文本
    QByteArray plainText = "Hello, AES Encryption!";

    // 密钥
    QByteArray key = "1234567890123456"; // AES-128 长度的密钥

    // 加密
    QByteArray encodedText = encryption.encode(plainText, key);

    // 解密
    QByteArray decodedText = encryption.decode(encodedText, key);

    // 输出结果
    qDebug() << "Encrypted:" << encodedText.toHex();
    qDebug() << "Decrypted:" << decodedText;

    return app.exec();
}

3. 项目的配置文件介绍

项目的配置文件是 qaesencryption.pro，它用于配置 Qt Creator 项目的构建过程。以下是一些基本的配置：

QT += core

QT -= gui

greaterThan(QT_MAJOR_VERSION, 4): QT += concurrent

TARGET = QtAES
CONFIG += console
CONFIG -= app_bundle

TEMPLATE = app

SOURCES += main.cpp \
    qaesencryption.cpp

HEADERS += qaesencryption.h

CONFIG += precompile_header

PRECOMPILE_HEADER = qaesencryption.h

contains(QT_CONFIG, "aei")|contains(QT_CONFIG, "sse2") {
    message(Using hardware acceleration)
    DEFINES += USE_INTEL_AES_IF_AVAILABLE
}

在这个配置文件中，我们指定了项目需要的 Qt 模块，定义了项目目标名称，添加了源文件和头文件，并进行了硬件加速的配置。如果编译器支持 AES-NI 指令集，那么会自动启用硬件加速。