快速开始

集成 YukiHookAPI 到你的项目中。

环境要求

Windows 7 及以上/macOS 10.14 及以上/Linux 发行版 (Arch/Debian)
Android Studio 2021.1 及以上
IntelliJ IDEA 2021.1 及以上
Kotlin 1.7.0 及以上
Android Gradle Plugin 7.0 及以上
Gradle 7.0 及以上
Java 11 及以上 (Since API 1.0.80)
Java 17 及以上 (Since API 1.2.0)

自动构建项目

YukiHookAPI 提供了一个自动化构建工具，它可以帮助你快速构建一个拥有 Xposed 模块依赖的 Android 标准项目模板，使用构建好的模板即可直接开始下一步工作。

你可以点击这里进行查看。

手动配置项目

若你不想使用自动化构建工具，你依然可以按照以下方式手动配置项目依赖。

创建项目

使用 Android Studio 或 IntelliJ IDEA 创建新的 Android 项目，并在 Language 一栏选择 Kotlin 以自动添加基础依赖。

集成依赖

我们推荐使用 Kotlin DSL 作为 Gradle 构建脚本语言并推荐使用 SweetDependency在新窗口中打开来管理依赖。

SweetDependency (推荐)

在你的项目 SweetDependency 配置文件中添加存储库和依赖。

示例如下

repositories:
  # 作为 Xposed 模块使用务必添加，其它情况可选
  rovo89-xposed-api:
    url: https://api.xposed.info/
  # MavenCentral 有 2 小时缓存，若无法集成最新版本请添加
  sonatype-oss-releases:

plugins:
  # 作为 Xposed 模块使用务必添加，其它情况可选
  com.google.devtools.ksp:
    version: +
  ...

libraries:
  # 作为 Xposed 模块使用务必添加，其它情况可选
  de.robv.android.xposed:
    api:
      version: 82
      repositories:
        rovo89-xposed-api
  io.github.dreammooncai.yukihookapi:
    api:
      version: +
    # 作为 Xposed 模块使用务必添加，其它情况可选
    ksp-xposed:
      version-ref: <this>::api
  ...

添加完成后运行一次 Gradle Sync，所有依赖版本将自动装配。

接下来，在你的项目 build.gradle.kts 中部署插件。

示例如下

plugins {
    // 作为 Xposed 模块使用务必添加，其它情况可选
    autowire(libs.plugins.com.google.devtools.ksp)
    // ...
}

然后，在你的项目 build.gradle.kts 中部署依赖。

示例如下

dependencies {
    // 基础依赖
    implementation(io.github.dreammooncai.yukihookapi.api)
    // 作为 Xposed 模块使用务必添加，其它情况可选
    compileOnly(de.robv.android.xposed.api)
    // 作为 Xposed 模块使用务必添加，其它情况可选
    ksp(io.github.dreammooncai.yukihookapi.ksp.xposed)
}

传统方式

在你的项目 build.gradle.kts 或 build.gradle 中添加存储库。

Kotlin DSL

repositories {
    google()
    mavenCentral()
    // 作为 Xposed 模块使用务必添加，其它情况可选
    maven { url("https://api.xposed.info/") }
    // MavenCentral 有 2 小时缓存，若无法集成最新版本请添加此地址
    maven { url("https://s01.oss.sonatype.org/content/repositories/releases/") }
}

Groovy DSL

repositories {
    google()
    mavenCentral()
    // 作为 Xposed 模块使用务必添加，其它情况可选
    maven { url 'https://api.xposed.info/' }
    // MavenCentral 有 2 小时缓存，若无法集成最新版本请添加此地址
    maven { url 'https://s01.oss.sonatype.org/content/repositories/releases/' }
}

在你的项目 build.gradle.kts 或 build.gradle 中添加插件。

Kotlin DSL

plugins {
    // 作为 Xposed 模块使用务必添加，其它情况可选
    id("com.google.devtools.ksp") version "<ksp-version>"
}

Groovy DSL

plugins {
    // 作为 Xposed 模块使用务必添加，其它情况可选
    id 'com.google.devtools.ksp' version '<ksp-version>'
}

在你的项目 build.gradle.kts 或 build.gradle 中添加依赖。

Kotlin DSL

dependencies {
    // 基础依赖
    implementation("io.github.dreammooncai.yukihookapi:api:<yuki-version>")
    // 作为 Xposed 模块使用务必添加，其它情况可选
    compileOnly("de.robv.android.xposed:api:82")
    // 作为 Xposed 模块使用务必添加，其它情况可选
    ksp("io.github.dreammooncai.yukihookapi:ksp-xposed:<yuki-version>")
}

Groovy DSL

dependencies {
    // 基础依赖
    implementation 'io.github.dreammooncai.yukihookapi:api:<yuki-version>'
    // 作为 Xposed 模块使用务必添加，其它情况可选
    compileOnly 'de.robv.android.xposed:api:82'
    // 作为 Xposed 模块使用务必添加，其它情况可选
    ksp 'io.github.dreammooncai.yukihookapi:ksp-xposed:<yuki-version>'
}

请将 <ksp-version> 修改为这里在新窗口中打开的最新版本 (请注意选择你当前对应的 Kotlin 版本)。

请将 <yuki-version> 修改为这里的最新版本。

特别注意

YukiHookAPI 的 api 与 ksp-xposed 依赖的版本必须一一对应，否则将会造成版本不匹配错误。

我们推荐使用 SweetDependency在新窗口中打开来自动帮你装配依赖。

配置 Java 版本

在你的项目 build.gradle.kts 或 build.gradle 中修改 Kotlin 的 Java 版本为 17 及以上。

Kotlin DSL

android {
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_21
        targetCompatibility = JavaVersion.VERSION_21
    }
    kotlinOptions {
        jvmTarget = "21"
    }
}

Groovy DSL

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_21
        targetCompatibility JavaVersion.VERSION_21
    }
    kotlinOptions {
        jvmTarget = '21'
    }
}

注意

自 API 1.0.80 版本后 Kotlin 使用的 Java 版本默认为 11，不再支持 1.8 及以下版本。

自 API 1.2.0 版本后 Kotlin 使用的 Java 版本默认为 17，不再支持 11 及以下版本。

作为 Xposed 模块使用

在你的 AndroidManifest.xml 中添加基础代码。

示例如下

<!-- 设置为 Xposed 模块 -->
<meta-data
    android:name="xposedmodule"
    android:value="true" />

<!-- 设置你的模块描述 -->
<meta-data
    android:name="xposeddescription"
    android:value="填写你的 Xposed 模块描述" />

<!-- 最低 Xposed 版本号，若你正在使用 EdXposed/LSPosed，建议最低为 93 -->
<meta-data
    android:name="xposedminversion"
    android:value="93" />

<!-- 可选：配置支持 New XSharedPreferences 可无需调整 xposedminversion 为 93 -->
<meta-data
    android:name="xposedsharedprefs"
    android:value="true"/>

在你的项目中创建一个 Hook 入口类，继承于 IYukiHookXposedInit 并加入注解 @InjectYukiHookWithXposed。

示例如下

@InjectYukiHookWithXposed
object HookEntry : IYukiHookXposedInit {

    override fun onHook() = YukiHookAPI.encase {
        // Your code here.
    }
}

建议

请在 onInit 方法中配置 YukiHookAPI 并将 isDebug 模式设置为如下形式。

示例如下

override fun onInit() = configs {
    isDebug = BuildConfig.DEBUG
}

你还可以将你的模块 APP 的 Application 继承于 ModuleApplication 以实现完整使用体验。

更多功能请参考 ModuleApplication。

然后，你就可以开始编写 Hook 代码了。

有关作为 Xposed 模块使用的相关配置详细内容，你可以点击这里继续阅读。

若你目前正在使用 Rovo89 Xposed API 等 Hook API，你可以参考从其它 Hook API 迁移。

作为 Hook API 使用

集成方式

创建你的自定义 Application。

特别注意

无论使用任何 Hook Framework，你都需要加入其对接的 Xposed 依赖支持。

若目标 Hook Framework 没有集成 Rovo89 Xposed API 你需要自行实现并对接 XposedBridge。

在 attachBaseContext 中添加 YukiHookAPI.encase 方法。

示例如下

override fun attachBaseContext(base: Context?) {
    // 装载 Hook Framework
    //
    // Your code here.
    //
    // 装载 YukiHookAPI
    YukiHookAPI.encase(base) {
        // Your code here.
    }
    super.attachBaseContext(base)
}

然后，你就可以开始编写 Hook 代码了，方式与作为 Xposed 模块使用基本一致。

有关作为 Hook API 使用的相关配置详细内容，你可以点击这里继续阅读。

注意

使用自定义的 Hook Framework 而并非完整的 Xposed 模块时，YukiHookPrefsBridge、YukiHookDataChannel 以及 Resources Hook 功能将失效。

# 快速开始

# 环境要求

# 自动构建项目

# 手动配置项目

# 创建项目

# 集成依赖

# SweetDependency (推荐)

# 传统方式

# 配置 Java 版本

# 作为 Xposed 模块使用

# 作为 Hook API 使用

# 集成方式

快速开始

环境要求

自动构建项目

手动配置项目

创建项目

集成依赖

SweetDependency (推荐)

传统方式

配置 Java 版本

作为 Xposed 模块使用

作为 Hook API 使用

集成方式