Open Salamander 项目下载及安装教程

1. 项目介绍

Open Salamander 是一个快速且可靠的双面板文件管理器，专为 Windows 系统设计。该项目起源于 Servant Salamander，最初由 Petr Šolín 在捷克技术大学学习期间开发，并于1997年作为免费软件发布。随着项目的不断发展，它被重新命名为 Altap Salamander，并在2023年以 GPLv2 许可证开源，成为 Open Salamander 5.0。

2. 项目下载位置

要下载 Open Salamander 项目，请访问项目的 GitHub 仓库。您可以通过以下步骤进行下载：

1. 打开命令行工具（如 PowerShell 或 Git Bash）。
2. 使用以下命令克隆项目仓库：

   git clone https://github.com/OpenSalamander/salamander.git
   

3. 项目安装环境配置

在安装 Open Salamander 之前，您需要确保系统满足以下环境配置要求：

• 操作系统：Windows 10 或更新版本。
• 开发工具：Visual Studio 2022，并安装了“桌面开发与 C++”工作负载。
• 可选组件：Windows 11 SDK（版本 10.0.22621.0）。
• 其他工具：Git、PowerShell 7.2 或更新版本、HTMLHelp Workshop 1.3。

环境配置示例

4. 项目安装方式

安装 Open Salamander 的步骤如下：

1. 设置环境变量：在系统环境变量中设置 OPENSAL_BUILD_DIR，指向您希望用于构建的目录。确保路径以反斜杠结尾，例如：

   setx OPENSAL_BUILD_DIR "D:\Build\OpenSal\"
   

2. 构建项目：

   • 打开 Visual Studio 2022，加载项目解决方案文件 \src\vcxproj\salamand.sln。
   • 或者，您也可以在命令行中使用以下命令进行构建：

     \src\vcxproj\rebuild.cmd
     

3. 填充构建目录：使用以下命令填充构建目录，以确保所有必要的文件都已准备好运行 Open Salamander：

   \src\vcxproj\populate_build_dir.cmd
   

5. 项目处理脚本

Open Salamander 项目包含多个处理脚本，用于自动化构建和配置过程。以下是一些关键脚本的说明：

• clean_all_interm.cmd：清理所有中间文件。
• clean_src_interm.cmd：清理源代码中的中间文件。
• clang-format：用于格式化代码的工具。
• normalize.ps1：用于规范化项目文件的 PowerShell 脚本。

通过这些脚本，您可以更高效地管理和构建 Open Salamander 项目。

---

通过以上步骤，您可以成功下载、配置并安装 Open Salamander 项目。希望这篇教程对您有所帮助！