i18n:更改输出为英文;

feat:添加延迟加载查找;
feat:添加递归查找参数  --recursive; 默认递归 20 层;
feat:添加额外查找目录参数 --search-dirs;
feat:添加不跳过核心 dll 参数 --all;
feat:添加 --ignore-dll 参数,忽略 dll;
feat:添加版本号管理功能;

Author: JKWTCN

CMakeLists.txt

@@ -1,7 +1,23 @@
 cmake_minimum_required(VERSION 3.10)
 
-project(win_deploy VERSION 1.0)
-# set the C++ standard to C++ 17
+# Get current year for copyright
+string(TIMESTAMP PROJECT_YEAR "%Y")
+
+project(win_deploy
+    VERSION 1.1.0.0
+    DESCRIPTION "Windows DLL dependency analyzer and deployment tool"
+    LANGUAGES CXX
+)
+
+# Project version configuration (explicit for flexibility)
+set(PROJECT_VERSION_MAJOR 1)
+set(PROJECT_VERSION_MINOR 1)
+set(PROJECT_VERSION_PATCH 0)
+set(PROJECT_VERSION_TWEAK 0)
+set(PROJECT_VERSION "${PROJECT_VERSION_MAJOR}.${PROJECT_VERSION_MINOR}.${PROJECT_VERSION_PATCH}.${PROJECT_VERSION_TWEAK}")
+set(PROJECT_NAME "win_deploy")
+
+# Set the C++ standard to C++ 17
 set(CMAKE_CXX_STANDARD 17)
 set(CXX_STANDARD_REQUIRED true)
 if(MSVC)
@@ -17,4 +33,41 @@ set(
 add_executable(
     win_deploy
     ${SOURCES}
+    ${CMAKE_BINARY_DIR}/version.rc
 )
+
+# Set version properties for the executable
+set_target_properties(win_deploy PROPERTIES
+    VERSION ${PROJECT_VERSION}
+    SOVERSION ${PROJECT_VERSION_MAJOR}
+    OUTPUT_NAME "win_deploy"
+)
+
+# Configure version header file (optional)
+configure_file(
+    ${CMAKE_SOURCE_DIR}/version.h.in
+    ${CMAKE_BINARY_DIR}/version.h
+    @ONLY
+)
+
+# Configure Windows version resource
+configure_file(
+    ${CMAKE_SOURCE_DIR}/version.rc.in
+    ${CMAKE_BINARY_DIR}/version.rc
+    @ONLY
+)
+
+# Add version information to the source files
+target_compile_definitions(win_deploy PRIVATE
+    PROJECT_VERSION_MAJOR=${PROJECT_VERSION_MAJOR}
+    PROJECT_VERSION_MINOR=${PROJECT_VERSION_MINOR}
+    PROJECT_VERSION_PATCH=${PROJECT_VERSION_PATCH}
+    PROJECT_VERSION_TWEAK=${PROJECT_VERSION_TWEAK}
+    PROJECT_VERSION="${PROJECT_VERSION}"
+)
+
+# Display build information
+message(STATUS "Project: ${PROJECT_NAME}")
+message(STATUS "Version: ${PROJECT_VERSION}")
+message(STATUS "Description: ${PROJECT_DESCRIPTION}")
+message(STATUS "Build type: ${CMAKE_BUILD_TYPE}")

README.md

@@ -1,6 +1,6 @@
 # WinDeploy - Windows Dependency DLL Analysis and Deployment Tool
 
-**[中文](README_CN.MD) | [English](README.MD)**
+**[English](README.MD) | [中文](README_CN.MD)**
 
 ## Project Introduction
 
@@ -9,8 +9,11 @@ WinDeploy is a command-line tool for analyzing the dependency DLLs of Windows ex
 ## Features
 
 - Analyze PE headers of Windows executable files to extract the list of dependent DLLs
+- Support recursive analysis of all levels of DLL dependencies
 - Support searching for DLL files in multiple locations (executable directory, system directories, PATH environment variables, etc.)
+- Support loading additional search directories and ignore lists from files
 - Optionally copy dependent DLLs to a specified directory
+- Automatically identify and skip Windows system core DLLs (such as KERNEL32.dll, USER32.dll, etc.)
 - Support for x64 and x86 architecture PE files
 - Use RAII pattern to manage Windows resources, ensuring proper resource release
 - Detailed error handling and log output
@@ -53,56 +56,138 @@ After building, the executable file will be located in the `build/bin` directory
 ### Basic Usage
 
 ```bash
-# Analyze dependency DLLs of an executable
+# Analyze dependency DLLs of an executable (first level only)
 win_deploy.exe C:\Path\To\YourApp.exe
+
+# Recursively analyze all levels of dependency DLLs
+win_deploy.exe C:\Path\To\YourApp.exe --recursive
+
+# Recursively analyze with specified maximum depth (default: 20)
+win_deploy.exe C:\Path\To\YourApp.exe --recursive 10
 ```
 
-### Copy Dependency DLLs to a Specified Directory
+### Release Mode
 
 ```bash
-# Copy dependency DLLs to a specified directory
-win_deploy.exe C:\Path\To\YourApp.exe --copy C:\DestDir
+# Release mode: Recursively analyze dependencies (depth: 2) and copy to executable's directory
+win_deploy.exe C:\Path\To\YourApp.exe --release
+
+# Release mode with specified recursion depth
+win_deploy.exe C:\Path\To\YourApp.exe --release 3
 ```
 
-### Copy Dependency DLLs to the Executable's Directory
+### Copy Dependency DLLs
 
 ```bash
+# Copy dependency DLLs to a specified directory
+win_deploy.exe C:\Path\To\YourApp.exe --copy C:\DestDir
+
 # Copy dependency DLLs to the executable's directory
 win_deploy.exe C:\Path\To\YourApp.exe --copy-exe-dir
+
+# Copy all DLLs (including system core DLLs)
+win_deploy.exe C:\Path\To\YourApp.exe --copy-exe-dir --copy-all
+```
+
+### Using Additional Search Directories
+
+```bash
+# Load additional search directories from file
+win_deploy.exe C:\Path\To\YourApp.exe --search-dirs search_paths.txt
+
+# search_paths.txt file format (one directory path per line):
+# C:\MyLibs\bin
+# D:\ThirdParty\libs
+# # Lines starting with # or ; are treated as comments
+```
+
+### Using Ignore List
+
+```bash
+# Load ignore list from file
+win_deploy.exe C:\Path\To\YourApp.exe --ignore-dll ignore.txt
+
+# ignore.txt file format:
+# # Can contain DLL names
+# unwanted.dll
+# # Can contain full paths
+# C:\Windows\System32\skip_this.dll
+# # Can contain directory paths (all DLLs in that directory will be ignored)
+# C:\TemporaryLibs
+```
+
+### Combining Options
+
+```bash
+# Release mode + additional search directories + ignore list
+win_deploy.exe C:\Path\To\YourApp.exe --release --search-dirs search_paths.txt --ignore-dll ignore.txt
 ```
 
 ### Command Line Arguments
 
 ```
 Usage: win_deploy.exe <executable_path> [options]
+
 Options:
-  --copy <target_dir>    Copy dependency DLLs to the specified directory
-  --copy-exe-dir         Copy dependency DLLs to the executable's directory
+  --release [depth]     Release mode: Recursively analyze dependencies (default depth: 2)
+                        and copy to the executable's directory
+  --recursive [depth]   Recursively analyze all DLL dependencies (default depth: 20)
+  --copy <target_dir>   Copy dependency DLLs to the specified directory
+  --copy-exe-dir        Copy dependency DLLs to the executable's directory
+  --copy-all            Copy all DLLs (including system core DLLs)
+  --search-dirs <file>  Load additional search directories from file (one path per line)
+  --ignore-dll <file>   Load ignore list from file (DLL names, paths, or directories)
+
 Examples:
   win_deploy.exe C:\Path\To\YourApp.exe
+  win_deploy.exe C:\Path\To\YourApp.exe --release
+  win_deploy.exe C:\Path\To\YourApp.exe --release 3
+  win_deploy.exe C:\Path\To\YourApp.exe --recursive
+  win_deploy.exe C:\Path\To\YourApp.exe --recursive 10
   win_deploy.exe C:\Path\To\YourApp.exe --copy C:\DestDir
   win_deploy.exe C:\Path\To\YourApp.exe --copy-exe-dir
+  win_deploy.exe C:\Path\To\YourApp.exe --copy-exe-dir --copy-all
+  win_deploy.exe C:\Path\To\YourApp.exe --search-dirs test_path.txt
+  win_deploy.exe C:\Path\To\YourApp.exe --release --ignore-dll ignore.txt
+  win_deploy.exe C:\Path\To\YourApp.exe --release --search-dirs test_path.txt --ignore-dll ignore.txt
 ```
 
+**Notes**:
+
+- By default, system core DLLs (such as KERNEL32.dll, USER32.dll, etc.) are automatically skipped during copying
+- Use the `--copy-all` parameter to copy all DLLs, including system core DLLs
+- `--release` mode is equivalent to `--recursive 2 --copy-exe-dir`
+
 ## How It Works
 
-1. **PE File Analysis**: The tool reads the PE header of the executable file, parses the Import Directory, and obtains all dependent DLL names.
-2. **DLL Search**: Search for DLL files in the following order:
+1. **PE File Analysis**: The tool reads the PE header of the executable file, parses the Import Directory and Delay Load Import Directory, and obtains all dependent DLL names.
 
+2. **Recursive Analysis**: If recursive mode is enabled, the tool will逐层 analyze the dependencies of each dependent DLL until the maximum recursion depth is reached or all dependencies are analyzed.
+
+3. **DLL Search**: Search for DLL files in the following priority order:
+
+   - **Additional specified search directories** (specified via `--search-dirs` parameter, highest priority)
    - Executable file directory
    - Current working directory
    - System directory (System32)
    - Windows directory
    - All directories in the PATH environment variable
-3. **File Copying**: If the copy option is specified, the tool will copy the found DLL files to the target directory, automatically create the directory structure, and skip existing files.
+
+4. **File Copying**: If the copy option is specified, the tool will copy the found DLL files to the target directory:
+   - Automatically identify and skip Windows system core DLLs (unless using `--copy-all`)
+   - Skip DLLs in the ignore list
+   - Automatically create target directory
+   - Skip existing files
 
 ## Technical Details
 
 - Use Windows API for file operations and PE file parsing
 - Implement RVA (Relative Virtual Address) to file offset conversion
+- Support parsing of regular import tables and delay load import tables
 - Use RAII pattern to manage Windows handles and memory-mapped views
-- Support detection of various PE file architectures
+- Support detection of various PE file architectures (x64, x86)
 - Include complete error handling and boundary checks
+- Automatically detect system core DLL list, including KERNEL32, USER32, GDI32, ADVAPI32, etc.
 
 ## Project Structure
 
@@ -112,7 +197,8 @@ windeployexe/
 ├── CMakeLists.txt       # CMake build configuration
 ├── CMakeSettings.json   # Visual Studio CMake settings
 ├── .gitignore           # Git ignore file
-└── README.MD           # Project documentation
+├── README.MD            # Project documentation (English)
+└── README_CN.md         # Project documentation (Chinese)
 ```
 
 ## License