AppInitHook 项目使用教程

AppInitHook 项目使用教程

1. 项目的目录结构及介绍

AppInitHook 项目的目录结构如下：

AppInitHook/
├── CMake/
│   ├── CMakeLists.txt
│   └── ...
├── Libraries/
│   ├── CMakeLists.txt
│   └── ...
├── Modules/
│   ├── CMakeLists.txt
│   └── ...
├── TestLoader/
│   ├── CMakeLists.txt
│   └── ...
├── .gitattributes
├── .gitignore
├── CMakeLists.txt
├── LICENSE
├── README.md
└── cmake.toml

目录介绍：

• CMake/: 包含与 CMake 构建系统相关的文件和配置。
• Libraries/: 包含项目使用的库文件和相关配置。
• Modules/: 包含项目中的模块文件和相关配置。
• TestLoader/: 包含测试加载器的文件和相关配置。
• .gitattributes: Git 属性文件，用于定义文件的属性。
• .gitignore: Git 忽略文件，用于指定不需要跟踪的文件。
• CMakeLists.txt: 主 CMake 配置文件，用于定义项目的构建规则。
• LICENSE: 项目的许可证文件，采用 GPL-3.0 许可证。
• README.md: 项目的说明文件，包含项目的概述和使用说明。
• cmake.toml: 项目的 CMake 配置文件，用于定义项目的构建选项。

2. 项目的启动文件介绍

AppInitHook 项目的启动文件主要是 TestLoader/TestLoader.exe。该文件是一个测试加载器，用于测试 AppInitHook 框架的功能。

启动步骤：

1. 编译项目: 使用 CMake 编译项目，生成 TestLoader.exe。

   cmake -B build
   cmake --build build --config Release
   

2. 注册 DLL: 将 AppInitDispatcher.dll 注册到系统的 AppInit_DLLs 注册表键中。

   cmake --build build --target register_AppInitDLLs
   

3. 运行测试加载器: 运行 TestLoader.exe，观察其行为。

   build/TestLoader/TestLoader.exe
   

3. 项目的配置文件介绍

AppInitHook 项目的主要配置文件包括 cmake.toml 和 AppInitHook.ini。

cmake.toml

cmake.toml 文件用于定义项目的构建选项和模块配置。以下是一个示例：

[target.MyPrivateModule]
type = "shared"
sources = ["MyPrivateModule/*.cpp", "MyPrivateModule/*.hpp"]
link-libraries = ["HookDll"]

AppInitHook.ini

AppInitHook.ini 文件用于配置哪些模块将被加载到哪些进程中。以下是一个示例：

[TestLoader.exe]
Module=ExitProcess.dll

该配置表示 TestLoader.exe 进程将加载 ExitProcess.dll 模块。

通过以上配置文件，用户可以自定义项目的构建和运行行为，实现灵活的模块加载和进程注入。