快速开始

集成 KYukiReflection 到你的项目中。

环境要求

• Windows 7 及以上/macOS 10.14 及以上/Linux 发行版 (Arch/Debian)

• Android Studio 2024.1 及以上

• IntelliJ IDEA 2024.2(暂不支持安卓最新组件) 及以上

• Kotlin 2.0.0 及以上

• Android Gradle Plugin 8.5 及以上

• Gradle 8.8 及以上

• Java 21 及以上

项目要求

项目需要使用 Android Studio 或 IntelliJ IDEA 创建且类型为 Java 或 Android 项目并已集成 Kotlin 环境依赖。

集成依赖

我们推荐使用 Kotlin DSL 作为 Gradle 构建脚本语言并推荐使用 SweetDependency 来管理依赖。

SweetDependency (推荐)

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

示例如下

repositories:
  # MavenCentral 有 2 小时缓存，若无法集成最新版本请添加
  sonatype-oss-releases:

libraries:
  io.github.dreammooncai.yukireflection:
    api:
      version: +
  ...

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

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

示例如下

dependencies {
    implementation(io.github.dreammooncai.yukireflection.api)
    // ...
}

传统方式

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

Kotlin DSL

repositories {
    google()
    mavenCentral()
    // MavenCentral 有 2 小时缓存，若无法集成最新版本请添加此地址
    maven { url("https://s01.oss.sonatype.org/content/repositories/releases/") }
}

Groovy DSL

repositories {
    google()
    mavenCentral()
    // MavenCentral 有 2 小时缓存，若无法集成最新版本请添加此地址
    maven { url 'https://s01.oss.sonatype.org/content/repositories/releases/' }
}

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

Kotlin DSL

dependencies {
    implementation("io.github.dreammooncai.yukireflection:api:<yuki-version>")
    // ...
}

Groovy DSL

dependencies {
    implementation 'io.github.dreammooncai.yukireflection:api:<yuki-version>'
    // ...
}

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

特别注意

如果你的项目目前正在使用 KYukiHookAPI 的 1.x.x 版本，你依然可以继续集成 KYukiReflection，因为 KYukiHookAPI 所依赖于此库即使不集成也会隐式打包到您的项目，后续可能会另作改动，更多使用教程请参阅 KYukiHookAPI 的 文档 查看对应的使用教程。

KYukiHookAPI 将在 YukiHookAPI 2.0.0 版本进行相关参考变动。

配置 Java 版本

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

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.1 版本后 Kotlin 使用的 Java 版本默认为 21，不再支持 11 及以下版本。