创建 TAR 文件时如何保留目录结构？

Question

我在 Qt 6 C++ 项目中使用microtar 。

我正在尝试归档一个目录。 我想归档文件夹的内容、其子文件夹和（纯文本）文件，并在输出的 TAR 文件中保留目录结构。

但是，虽然我能够生成一个包含所有给定目录的内容和文件的 TAR 文件，但不会保留目录结构，并且 TAR 文件的内容都位于相同的深度/级别。

我正在使用下面的代码，我尝试遍历给定目录并递归文件夹以获取其中的任何子文件夹和文件等。

---

tar_test.h：

#pragma once

#include "microtar.h"
#include <filesystem>
#include <QDir>
#include <QFile>
#include <QIODevice>
#include <QString>
#include <QTextStream>

const QString readFile(QString path);
void writeFile(QString text, QString path);
void dirToTar_entry(QString readPath, QString writePath);
void dirToTar_recursor(mtar_t& tar, QString readPath);
void checkMakeDir(QString path);

tar_test.cpp：

#include "tar_test.h"

const QString readFile(QString path)
{
    QString text;
    QFile file(path);
    if (file.open(QFile::ReadOnly | QIODevice::Text))
    {
        QTextStream in(&file);
        text = in.readAll();
        file.close();
    }
    return text;
}

void writeFile(QString text, QString path)
{
    QFile file(path);
    if (file.open(QIODevice::WriteOnly | QIODevice::Text))
    {
        QTextStream out(&file);
        out << text;
        file.close();
    }
}

void dirToTar_entry(QString readPath, QString writePath)
{
    auto tar_path_tmp = writePath.toLocal8Bit();
    auto tar_path = tar_path_tmp.data();
    mtar_t tar;
    mtar_open(&tar, tar_path, "w");
    dirToTar_recursor(tar, readPath);
    mtar_finalize(&tar);
    mtar_close(&tar);
}

void dirToTar_recursor(mtar_t& tar, QString readPath)
{
    const auto dirs = QDir(readPath).entryList(QDir::Dirs | QDir::NoDotAndDotDot);
    for (const auto& dir : dirs)
    {
        auto name_tmp = dir.toLocal8Bit();
        auto name = name_tmp.data();
        mtar_write_dir_header(&tar, name);
        //mtar_write_data(&tar, 0, 0); // I don't know if this is the issue, but the archive writes the same even if I omit this line?
        dirToTar_recursor(tar, QDir(readPath + "/" + dir).absolutePath());
    }
    const auto files = QDir(readPath).entryList(QDir::Files | QDir::NoDotAndDotDot);
    for (const auto& file : files)
    {
        auto name_tmp = file.toLocal8Bit();
        auto name = name_tmp.data();
        auto str_tmp = readFile(readPath + "/" + file).toLocal8Bit();
        auto str = str_tmp.data();
        mtar_write_file_header(&tar, name, strlen(str));
        mtar_write_data(&tar, str, strlen(str));
    }
}

void checkMakeDir(QString path)
{
    if (QDir(path).exists()) return;
    std::filesystem::path fs_path = path.toStdString();
    std::filesystem::create_directories(fs_path);
}

然后我有一个测试按钮，我在其中创建了一个测试目录和 output TAR 文件：

connect(testButton, &QPushButton::clicked, this, [&]()
        {
            const QString path = "C:\\Dev\\NPT\\NewPaneTest\\TestProjects\\TestRoot\\";
            auto temp = QString::fromStdString(tempFolder.string()) + "\\TestRoot\\";
            checkMakeDir(temp);
            auto test_file = temp + "\\test.tar";
            dirToTar_entry(path, test_file);
        });

---

我非常感谢任何和所有的帮助。 我很确定我错过了一些明显的东西，但我现在看不到它。

---

编辑：

就我而言，解决方案是 QDir::entryList 只返回目录或文件名，而不是完整或相对路径。 因此，没有相对路径，所有内容都在同一级别存档。 这对我有用：

void dirToTar_entry(QString readPath, QString writePath)
{
    auto tar_path_tmp = writePath.toLocal8Bit();
    auto tar_path = tar_path_tmp.data();
    mtar_t tar;
    mtar_open(&tar, tar_path, "w");
    dirToTar_recursor(tar, readPath);
    mtar_finalize(&tar);
    mtar_close(&tar);
}

void dirToTar_recursor(mtar_t& tar, QString rootPath, QString currentReadPath)
{
    if (currentReadPath.isEmpty())
        currentReadPath = rootPath;
    QString relative_path;
    if (currentReadPath != rootPath)
        relative_path = QDir(rootPath).relativeFilePath(currentReadPath) + "/";
    else
        relative_path = "";

    const auto dirs = QDir(currentReadPath).entryList(QDir::Dirs | QDir::NoDotAndDotDot);
    for (const auto& dir : dirs)
    {
        auto path = relative_path + dir;
        auto name_tmp = path.toLocal8Bit();
        auto name = name_tmp.data();
        mtar_write_dir_header(&tar, name);
        mtar_write_data(&tar, 0, 0);
        dirToTar_recursor(tar, rootPath, QDir(currentReadPath + "/" + dir).absolutePath());
    }
    const auto files = QDir(currentReadPath).entryList(QDir::Files | QDir::NoDotAndDotDot);
    for (const auto& file : files)
    {
        auto path = relative_path + file;
        auto name_tmp = path.toLocal8Bit();
        auto name = name_tmp.data();
        auto str_tmp = readFile(currentReadPath + "/" + file).toLocal8Bit();
        auto str = str_tmp.data();
        mtar_write_file_header(&tar, name, strlen(str));
        mtar_write_data(&tar, str, strlen(str));
    }
}

将 readPath 参数划分为 static rootPath，加上仅在递归中传递的可选 currentReadPath，使我始终可以在 function 的开头使用 QDir::relativeFilePath 获取相对路径。

Answer 1

下面是一个工作示例，它根据使用 QDirIterator的答案使用不同的目录递归。 答案也使用了此处嵌套程序中演示的方法。

我相信创建 tar 目录与 tar 文件头的细节导致了发布的示例中的问题。 tar 存档中有很多遗留格式，如格式文档中所述

# FILE: test1.cpp
#include "microtar.h"
#include <QDirIterator>
#include <QDir>
#include <QFile>
#include <QIODevice>
#include <QString>

const QString readFile(QString path)
{
    QString text;
    QFile file(path);
    if (file.open(QFile::ReadOnly | QIODevice::Text))
    {
        QTextStream in(&file);
        text = in.readAll();
        file.close();
    }
    return text;
}

int main() {
 const QString path = "abc";
 auto test_file = "test.tar";
 mtar_t tar;
 mtar_open(&tar, test_file, "w");
 QDirIterator it( path, QStringList() << "*.csv", QDir::Files, QDirIterator::Subdirectories);
 while (it.hasNext())
 {
   auto name = it.next().toLocal8Bit().data();
   auto str = readFile(name).toLocal8Bit().data();
   mtar_write_file_header(&tar, name, strlen(str));
   mtar_write_data(&tar, str, strlen(str));
 }
 mtar_finalize(&tar);
 mtar_close(&tar);
 return 0;
}

使用以下命令创建：

qmake -project
echo "CONFIG -= app_bundle" >> test1.pro
qmake
make
./test1
tar -tf test.tar 
abc/one/x00.csv
abc/two/x01.csv
abc/two/three/x02.csv

您可以在 C 代码中像这样探索 microtar。

git clone https://github.com/rxi/microtar.git
git clone https://github.com/domeengine/nest.git
cd nest/src
cp ../../microtar/src/microtar.c .
cp ../../microtar/src/microtar.h .
gcc -I -o nest main.c
mv ../../abc .
./nest -z -o abc.tar abc
Bundling: abc/one/x00.csv
Bundling: abc/two/x01.csv
Bundling: abc/two/three/x02.csv
Created bundle abc.tar.
tar -tf abc.tar 
one/x00.csv
two/x01.csv
two/three/x02.csv

此处描述的 tar 格式表示：

应使用 REGTYPE 创建新档案。 此外，为了向后兼容， tar 将名称以斜杠结尾的常规文件视为目录。

示例代码仅使用mtar_write_file_header新档案。

另一种选择是检查mtar_write_directory_header并参考 TAR 文件格式，其中包含如下内容：

名称字段中的目录名称应以斜杠结尾

Answer 2

就我而言，解决方案是 QDir::entryList 只返回目录或文件名，而不是完整或相对路径。 因此，没有相对路径，所有内容都在同一级别存档。 这对我有用：

void dirToTar_entry(QString readPath, QString writePath)
{
    auto tar_path_tmp = writePath.toLocal8Bit();
    auto tar_path = tar_path_tmp.data();
    mtar_t tar;
    mtar_open(&tar, tar_path, "w");
    dirToTar_recursor(tar, readPath);
    mtar_finalize(&tar);
    mtar_close(&tar);
}

void dirToTar_recursor(mtar_t& tar, QString rootPath, QString currentReadPath)
{
    if (currentReadPath.isEmpty())
        currentReadPath = rootPath;
    QString relative_path;
    if (currentReadPath != rootPath)
        relative_path = QDir(rootPath).relativeFilePath(currentReadPath) + "/";
    else
        relative_path = "";

    const auto dirs = QDir(currentReadPath).entryList(QDir::Dirs | QDir::NoDotAndDotDot);
    for (const auto& dir : dirs)
    {
        auto path = relative_path + dir;
        auto name_tmp = path.toLocal8Bit();
        auto name = name_tmp.data();
        mtar_write_dir_header(&tar, name);
        mtar_write_data(&tar, 0, 0);
        dirToTar_recursor(tar, rootPath, QDir(currentReadPath + "/" + dir).absolutePath());
    }
    const auto files = QDir(currentReadPath).entryList(QDir::Files | QDir::NoDotAndDotDot);
    for (const auto& file : files)
    {
        auto path = relative_path + file;
        auto name_tmp = path.toLocal8Bit();
        auto name = name_tmp.data();
        auto str_tmp = readFile(currentReadPath + "/" + file).toLocal8Bit();
        auto str = str_tmp.data();
        mtar_write_file_header(&tar, name, strlen(str));
        mtar_write_data(&tar, str, strlen(str));
    }
}

将 readPath 参数划分为 static rootPath，加上仅在递归中传递的可选 currentReadPath，使我始终可以在 function 的开头使用 QDir::relativeFilePath 获取相对路径。