Android Inline Hook 使用指南

---

1. 项目目录结构及介绍

Android Inline Hook，也称为 ShadowHook，是由字节跳动开发的一个专注于Android平台的内联钩子库，支持Thumb、ARM32和ARM64架构。以下是项目的主要目录结构及其简介：

• 根目录:

  • app: 示例应用程序模块，展示了如何集成并使用ShadowHook。
  • doc: 包含了项目的手册文档，包括快速入门和详细说明。
  • gradle.properties: 项目属性配置文件。
  • LICENSE: 许可证文件，明确该项目遵循MIT协议。
  • README.md与README.zh-CN.md: 分别是英文和中文版的项目简介。
  • shadowhook: 核心库源代码存放位置，包含C/C++实现的内联钩子逻辑。
  • systest: 系统测试模块，提供了对常见系统函数的钩子和解除钩子示例。

• 核心文件说明:

  • shadowhook: 存放主要的hook逻辑实现文件，例如hook函数的声明和定义。
  • doc: 重要文档区域，其中manual.zh-CN.md是对中文用户的详尽指南。

2. 项目的启动文件介绍

虽然“启动文件”通常指的是应用运行的第一个入口点，但对于库项目如ShadowHook，其“启动”概念更多体现在整合到其他应用或SDK中的方式。核心的集成点在于通过Gradle配置依赖以及初始化库的过程。具体来说，开发者首先需要在自己的应用或者库项目的build.gradle文件中添加如下依赖：

dependencies {
    implementation 'com.bytedance.android:shadowhook:1.0.10'
}

对于使用CMake或Android.mk编译的原生部分，需要在对应文件中加入对ShadowHook库的链接指令。此外，需要确保支持正确的ABI，并可能需要调整packagingOptions避免AAR包冲突。

3. 项目的配置文件介绍

Gradle 配置

• 在项目级build.gradle中启用Prefab支持，这对于处理native依赖至关重要，尤其当使用Android Gradle插件4.0及以上版本时。

android {
    buildFeatures {
        prefab true
    }
}

• 对于Android Gradle插件7.1.0之前的版本，需在gradle.properties中手动设置android.prefabVersion.

应用级别的配置

• 在App的defaultConfig中指定需要支持的ABI。

defaultConfig {
    ndk {
        abiFilters 'armeabi-v7a', 'arm64-v8a'
    }
}

• 针对SDK项目的打包，避免重复库文件的冲突，可使用packagingOptions排除特定文件。

packagingOptions {
    exclude '**/libshadowhook.so'
}

而对于APP项目，则可能需要配置以解决相同的冲突问题，使用pickFirst策略。

通过这些步骤和配置，可以成功集成ShadowHook库，并利用其提供的功能进行函数内联钩子操作。详细的使用流程和高级配置应参考项目文档中的具体指导。