Fishhook 开源项目教程

Fishhook 开源项目教程

fishhookA library that enables dynamically rebinding symbols in Mach-O binaries running on iOS.项目地址:https://gitcode.com/gh_mirrors/fi/fishhook

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

Fishhook 是一个由 Facebook 开发的开源项目，主要用于在 iOS 和 macOS 平台上进行动态符号重绑定。以下是 Fishhook 的目录结构及其介绍：

fishhook/
├── LICENSE
├── README.md
├── fishhook.c
├── fishhook.h
└── tests/
    ├── fishhook_test.c
    └── main.m

• LICENSE: 项目的许可证文件，通常包含项目的授权和使用条款。
• README.md: 项目的说明文档，包含项目的基本介绍、使用方法和贡献指南。
• fishhook.c: 项目的主要源代码文件，包含了实现动态符号重绑定的核心逻辑。
• fishhook.h: 项目的头文件，定义了供外部调用的接口。
• tests/: 测试目录，包含项目的测试代码。
  • fishhook_test.c: 测试文件，用于验证 Fishhook 的功能。
  • main.m: 测试的主入口文件。

2. 项目的启动文件介绍

Fishhook 项目的启动文件位于 tests/main.m。这个文件是测试程序的入口点，负责初始化和运行测试用例。以下是 main.m 文件的简要介绍：

#import <Foundation/Foundation.h>
#import "fishhook.h"

// 定义一些原函数和替换函数
static void (*original_func)(void);
static void replaced_func(void) {
    NSLog(@"替换后的函数被调用了");
}

int main(int argc, const char * argv[]) {
    @autoreleasepool {
        // 重绑定符号
        struct rebinding rebindings[] = {
            {"original_func", replaced_func, (void *)&original_func}
        };
        rebind_symbols(rebindings, 1);

        // 调用原函数
        original_func();
    }
    return 0;
}

• main 函数是程序的入口点，负责初始化自动释放池并执行符号重绑定操作。
• rebind_symbols 函数用于执行符号重绑定，将 original_func 函数替换为 replaced_func 函数。
• 调用 original_func 时，实际上会执行 replaced_func 函数。

3. 项目的配置文件介绍

Fishhook 项目本身没有传统的配置文件，因为它的主要功能是通过代码动态重绑定符号。项目的配置主要依赖于编译和链接过程中的设置。以下是一些可能涉及的配置：

• 编译选项: 在编译 Fishhook 时，通常不需要特殊的编译选项。标准的 clang 编译器命令即可：

  clang -o test_fishhook tests/main.m fishhook.c
  

• 链接选项: 链接时也不需要特殊的选项，标准链接命令即可：

  clang -o test_fishhook tests/main.m fishhook.c
  

• 环境变量: 在运行测试程序时，可能需要设置一些环境变量，例如 DYLD_INSERT_LIBRARIES 用于动态库注入，但这不是 Fishhook 项目特有的。

总结来说，Fishhook 项目的配置主要集中在编译和链接阶段，没有独立的配置文件。

fishhookA library that enables dynamically rebinding symbols in Mach-O binaries running on iOS.项目地址:https://gitcode.com/gh_mirrors/fi/fishhook