qt QZipWriter详解

1、概述

QZipWriter是Qt框架中用于创建ZIP文件的类。它允许开发者将多个文件和目录压缩成一个ZIP文件，支持多种压缩算法，并且易于集成到现有的Qt项目中。通过QZipWriter，开发者可以轻松实现文件的压缩、管理压缩包中的文件等功能。

需要注意的是，QZipWriter属于QtGui模块，在Qt 6中已被移除，但在早期的Qt版本中，如Qt 5，它仍然是一个可用的类。此外，要使用QZipWriter，需要在安装Qt时选择Sources源码安装，否则无法使用该类。

2、重要方法

QZipWriter类提供了一些关键的方法来操作ZIP文件，以下是一些重要的方法：

构造方法：QZipWriter(const QString &fileName, QIODevice::OpenMode mode = (QIODevice::WriteOnly | QIODevice::Truncate))；其中，fileName参数指定了要创建的ZIP文件的路径，mode参数指定了打开文件的模式，默认为只写和截断模式。
设置压缩策略：void setCompressionPolicy(CompressionPolicy policy)；其中，CompressionPolicy是一个枚举类型，用于指定压缩策略，包括始终压缩（AlwaysCompress）、从不压缩（NeverCompress）和自动压缩（AutoCompress）。
添加文件：void addFile(const QString &fileName, const QByteArray &data)；该方法允许将指定的文件数据添加到ZIP文件中。fileName参数指定了文件在ZIP文件中的路径，data参数包含了要添加的文件数据。
添加目录：void addDirectory(const QString &dirName)；该方法允许在ZIP文件中创建一个新的目录。dirName参数指定了要创建的目录的名称。

3、重要信号

QZipWriter类本身并不直接提供信号（signals）。然而，在使用QZipWriter进行文件压缩时，可以结合Qt的信号槽机制来处理压缩过程中的各种事件。例如，可以在一个单独的线程中执行压缩操作，并通过信号将压缩进度、成功或失败的结果传递回主线程。

虽然QZipWriter没有专门的信号，但开发者可以通过自定义的方式实现类似的通知机制。例如，可以在压缩类中添加一个信号，当压缩完成时触发该信号，并传递压缩结果作为参数。

4、常用枚举类型

QZipWriter类中使用了一个枚举类型CompressionPolicy来指定压缩策略，该枚举类型包含以下三个值：

AlwaysCompress：始终对文件进行压缩。
NeverCompress：从不对文件进行压缩。
AutoCompress：根据文件的内容和类型自动决定是否进行压缩

#include <QFile>
#include <QDir>
#include <QDebug>
#include <QTextStream>
#include <QFileInfo>
#include <QtGui/private/qzipwriter_p.h> // 注意：在Qt 6中，QZipWriter已被移除，需要从Qt 5的源码中查找该头文件

// 递归函数，用于将文件夹及其子文件夹中的文件添加到ZIP压缩包
void addFolderToZip(QZipWriter &zipWriter, const QString &folderPath, const QString &parentFolder = "") {
    QDir dir(folderPath);

    // 获取该文件夹下的所有文件和子文件夹
    QStringList files = dir.entryList(QDir::Files | QDir::Dirs | QDir::NoDotAndDotDot);

    foreach (const QString &fileName, files) {
        QString fullPath = dir.filePath(fileName);
        QString zipFileName = parentFolder.isEmpty() ? fileName : parentFolder + "/" + fileName;

        if (QFileInfo(fullPath).isDir()) {
            // 如果是文件夹，则递归调用
            addFolderToZip(zipWriter, fullPath, zipFileName);
        } else {
            // 如果是文件，则添加到ZIP
            QFile file(fullPath);
            if (file.open(QIODevice::ReadOnly)) {
                zipWriter.addFile(zipFileName, &file);  // 添加文件到ZIP
                file.close();
            } else {
                qCritical() << "Failed to open file:" << fullPath;
            }
        }
    }
}

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


    QString folderPath  = "D:/gui/Qt"; // 替换为要压缩的源目录路径
    QString zipFilePath  = "D:/gui/Qt.zip"; // 替换为目标ZIP文件路径
    // 创建 QFile 对象并打开为写模式
	QFile zipFile(zipFilePath);
	if (!zipFile.open(QIODevice::WriteOnly)) {
		qCritical() << "Failed to open ZIP file for writing.";
		return -1;
	}

	// 创建 QZipWriter 对象，准备压缩文件
	QZipWriter zipWriter(&zipFile);

	zipWriter.setCompressionPolicy(QZipWriter::AutoCompress);

	// 开始递归添加文件夹中的文件
	addFolderToZip(zipWriter, folderPath, "qt");

	// 关闭 ZIP 文件
	zipWriter.close();
	zipFile.close();

	qDebug() << "Folder compression completed successfully.";


    return a.exec();
}

注意：要在.pro添加如下：