SandHook 项目使用教程

1. 项目目录结构及介绍

SandHook 是一个用于 Android ART Hook、Native Inline Hook 和 Single Instruction Hook 的开源项目。以下是项目的目录结构及其介绍：

SandHook/
├── annotation/          # 注解相关文件
├── app/                 # 示例应用
├── built/               # 构建相关文件
├── doc/                 # 文档
├── gradle/wrapper/      # Gradle 包装器
├── hookers/             # Hook 插件示例
├── hooklib/             # ART Hook 核心库
├── nativehook/          # Native Hook 库
├── xposedcompat/        # Xposed API 兼容实现
├── xposedcompat_new/    # 另一种 Xposed API 兼容实现
├── .gitignore           # Git 忽略文件
├── LICENSE.txt          # 项目许可证
├── README.md            # 项目自述文件
├── build.gradle         # 构建脚本
├── gradle.properties    # Gradle 属性文件
├── gradlew              # Gradle 包装器脚本
├── gradlew.bat          # Gradle 包装器脚本（Windows）
└── settings.gradle      # Gradle 设置文件

主要目录介绍：

• annotation: 包含注解相关的文件，用于定义 Hook 方法的注解。
• app: 示例应用，展示了如何使用 SandHook 进行 Hook。
• hooklib: ART Hook 的核心库，提供了对 Android ART 运行时的 Hook 支持。
• nativehook: Native Hook 库，提供了对 Native 方法的 Hook 支持。
• xposedcompat: Xposed API 兼容实现，允许在非 Xposed 环境下使用 Xposed API。
• xposedcompat_new: 另一种 Xposed API 兼容实现，优化了首次 Hook 的速度。

2. 项目启动文件介绍

项目的启动文件主要包括 build.gradle 和 settings.gradle。

build.gradle

build.gradle 是项目的构建脚本，定义了项目的依赖、插件和其他构建配置。以下是部分内容示例：

plugins {
    id 'com.android.application'
    id 'kotlin-android'
}

android {
    compileSdkVersion 30
    defaultConfig {
        applicationId "com.swift.sandhook"
        minSdkVersion 19
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation 'com.swift.sandhook:hooklib:4.2.0'
    implementation 'com.swift.sandhook:nativehook:4.2.0'
}

settings.gradle

settings.gradle 是项目的设置文件，定义了项目的模块和依赖关系。以下是内容示例：

include ':app', ':hooklib', ':nativehook', ':xposedcompat', ':xposedcompat_new'

3. 项目配置文件介绍

项目的配置文件主要包括 gradle.properties 和 local.properties。

gradle.properties

gradle.properties 是 Gradle 的属性文件，定义了项目的全局属性。以下是内容示例：

org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
android.useAndroidX=true
android.enableJetifier=true

local.properties

local.properties 是本地配置文件，通常包含 Android SDK 的路径等信息。以下是内容示例：

sdk.dir=/path/to/your/Android/Sdk

通过以上配置文件，可以对项目进行构建和运行环境的配置。

---

以上是 SandHook 项目的使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望这些内容能帮助你更好地理解和使用 SandHook 项目。