bit7z 库编译与使用的简易指南

1. 项目目录结构及介绍

在 rikyoz/bit7z 的仓库中，主要目录结构如下：

• cmake：包含了CMake相关的脚本。
• docs：可能存放项目的文档。
• include/bit7z：库的头文件所在位置。
• src：源代码文件夹。
• tests：测试用例所在的目录。
• .gitignore：Git 忽略规则文件。
• CMakeLists.txt：整个项目的CMake构建脚本。
• CODE_OF_CONDUCT.md：项目的行为准则。
• LICENSE：项目许可证信息（通常为 MPL-2.0）。
• README.md：项目简介和使用说明。
• appveyor.yml：Windows上的持续集成配置。

该库提供了一个C++静态库接口来访问7-Zip的动态库功能，支持多种压缩和解压格式，以及加密操作。

2. 项目的启动文件介绍

尽管提供的例子没有明确指出具体的启动文件，但在示例代码中展示了如何使用库进行解压操作的main.cpp文件。这是一个简单的程序入口点，演示了如何创建Bit7zLibrary对象、设置密码并执行解压操作。

#include "include/bit7z.h"
//...
int main() {
    try {
        Bit7zLibrary lib{"7za.dll"};
        BitExtractor extractor{lib, BitFormat::SevenZip};
        // 设置密码
        extractor.setPassword(L"password");
        // 解压加密档案
        extractor.extract(L"C:\\Users\\monoliths\\Videos\\Captures\\jni 7z", 
                           L"C:\\Users\\monoliths\\Videos\\Captures\\jni");
        //...
    } catch (const BitException& ex) {
        // 处理异常
        //...
    }
    return 0;
}

实际的启动文件可能会依赖于您在具体项目中如何集成此库。

3. 项目的配置文件介绍

主要的配置文件是 CMakeLists.txt，它定义了构建过程中的各种选项和目标。例如，如何找到7-Zip的共享库、启用特定功能等。在CMake构建系统中，你可以通过设置CMake变量来调整编译选项，如：

• -DBIT7Z_USE_LEGACY_IUNKNOWN=ON：使库兼容旧版7-Zip的IUnknown接口。
• -DBIT7Z_7ZIP_VERSION="22.01"：指定要构建的7-Zip版本兼容性。

为了编译项目，你需要一个CMake环境，并运行以下命令：

1. 创建一个构建目录，如 build。
2. 进入构建目录：cd build。
3. 初始化CMake配置：cmake .. 或者指定特定的7-Zip路径和版本：cmake -DBIT7Z_7ZIP_VERSION="22.01" -DBIT7Z_USE_LEGACY_IUNKNOWN=ON ..。
4. 构建项目：make 或 cmake --build .。

请确保7-Zip的动态库（如 7za.dll）可被CMake脚本正确找到，或者通过 BIT7Z_CUSTOM_7ZIP_PATH 指定路径。

请注意，实际的配置步骤可能因您的开发环境而异，需要根据您的操作系统和开发工具进行适当调整。详细配置和使用指导应参考项目的官方文档和示例。