HighCapable/YukiHookAPI
5
0
Fork 0
mirror of https://github.com/HighCapable/YukiHookAPI.git synced 2025-09-01 08:15:37 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

...

Browse Source
This commit is contained in:
Fankesyooni
2022-02-05 03:53:38 +08:00
parent 5c3335fab3
commit e6bfc181de
44 changed files with 349 additions and 216 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
.idea/compiler.xml generated
View File

@@ -1,6 +1,9 @@
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
<component name="CompilerConfiguration">
<bytecodeTargetLevel target="11" />
<bytecodeTargetLevel target="1.8">
<module name="YukiHookAPI.app" target="11" />
<module name="YukiHookAPI.yukihookapi-yaya" target="11" />
</bytecodeTargetLevel>
</component>
</project>

1
.idea/gradle.xml generated
View File

@@ -12,6 +12,7 @@
<option value="$PROJECT_DIR$" />
<option value="$PROJECT_DIR$/app" />
<option value="$PROJECT_DIR$/yukihookapi" />
<option value="$PROJECT_DIR$/yukihookapi-ksp-xposed" />
</set>
</option>
<option name="resolveModulePerSourceSet" value="false" />

5
.idea/jarRepositories.xml generated
View File

@@ -36,5 +36,10 @@
<option name="name" value="Google" />
<option name="url" value="https://dl.google.com/dl/android/maven2/" />
</remote-repository>
<remote-repository>
<option name="id" value="maven4" />
<option name="name" value="maven4" />
<option name="url" value="https://dl.bintray.com/kotlin/kotlin-eap" />
</remote-repository>
</component>
</project>

2
.idea/misc.xml generated
View File

@@ -7,7 +7,7 @@
</map>
</option>
</component>
<component name="ProjectRootManager" version="2" languageLevel="JDK_11" default="true" project-jdk-name="Android Studio default JDK" project-jdk-type="JavaSDK">
<component name="ProjectRootManager" version="2" languageLevel="JDK_1_8" project-jdk-name="Android Studio default JDK" project-jdk-type="JavaSDK">
<output url="file://$PROJECT_DIR$/build/classes" />
</component>
<component name="ProjectType">

5
app/build.gradle
View File

@@ -1,6 +1,7 @@
plugins {
id 'com.android.application'
id 'org.jetbrains.kotlin.android'
id 'com.google.devtools.ksp' version '1.6.10-1.0.2'
}
android {
@@ -32,12 +33,16 @@ android {
}
dependencies {
// Used 82 API Version
compileOnly 'de.robv.android.xposed:api:82'
// Implementation API
implementation project(':yukihookapi')
ksp project(':yukihookapi-ksp-xposed')
implementation 'androidx.core:core-ktx:1.7.0'
implementation 'androidx.appcompat:appcompat:1.4.1'
implementation 'com.google.android.material:material:1.5.0'
implementation 'androidx.constraintlayout:constraintlayout:2.1.3'
implementation project(path: ':yukihookapi')
testImplementation 'junit:junit:4.13.2'
androidTestImplementation 'androidx.test.ext:junit:1.1.3'
androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'

1
app/src/main/assets/xposed_init Normal file
View File

@@ -0,0 +1 @@
com.highcapable.yukihookapi.demo.InjectTest_YukiHookXposedInit

1
app/src/main/java/com/highcapable/yukihookapi/demo/hook/MainHooker.kt
View File

@@ -36,6 +36,7 @@ import com.highcapable.yukihookapi.hook.entity.YukiBaseHooker
import com.highcapable.yukihookapi.hook.type.BundleClass
import com.highcapable.yukihookapi.hook.type.StringType
// for test
class MainHooker : YukiBaseHooker() {
override fun onHook() =

4
app/src/main/java/com/highcapable/yukihookapi/demo/hook/inject/MainInjecter.kt
View File

@@ -35,6 +35,8 @@ import com.highcapable.yukihookapi.annotation.xposed.InjectYukiHookWithXposed
import com.highcapable.yukihookapi.demo.BuildConfig
import com.highcapable.yukihookapi.demo.InjectTest
import com.highcapable.yukihookapi.demo.MainActivity
import com.highcapable.yukihookapi.demo.hook.MainHooker
import com.highcapable.yukihookapi.demo.hook.SecondHooker
import com.highcapable.yukihookapi.hook.factory.encase
import com.highcapable.yukihookapi.hook.factory.findMethod
import com.highcapable.yukihookapi.hook.proxy.YukiHookXposedInitProxy
@@ -48,7 +50,7 @@ class MainInjecter : YukiHookXposedInitProxy {
override fun onHook() {
// 方案 1
// encase(BuildConfig.APPLICATION_ID, MainHooker(), SecondHooker())
encase(MainHooker(), SecondHooker())
// 方案 2
encase(BuildConfig.APPLICATION_ID) {
loadApp(name = BuildConfig.APPLICATION_ID) {

2
build.gradle
View File

@@ -6,6 +6,7 @@ buildscript {
maven { url 'https://maven.aliyun.com/nexus/content/groups/public/' }
maven { url 'https://maven.aliyun.com/nexus/content/repositories/jcenter' }
maven { url "https://www.jitpack.io" }
maven { url "https://dl.bintray.com/kotlin/kotlin-eap" }
mavenCentral()
}
dependencies {
@@ -23,6 +24,7 @@ allprojects {
maven { url 'https://maven.aliyun.com/nexus/content/groups/public/' }
maven { url 'https://maven.aliyun.com/nexus/content/repositories/jcenter' }
maven { url "https://www.jitpack.io" }
maven { url "https://dl.bintray.com/kotlin/kotlin-eap" }
mavenCentral()
}
}

1
settings.gradle
View File

@@ -1,3 +1,4 @@
rootProject.name = "YukiHookAPI"
include ':app'
include ':yukihookapi'
include ':yukihookapi-ksp-xposed'

1
yukihookapi-ksp-xposed/.gitignore vendored Normal file
View File

@@ -0,0 +1 @@
/build

20
yukihookapi-ksp-xposed/build.gradle Normal file
View File

@@ -0,0 +1,20 @@
plugins {
id 'java-library'
id 'org.jetbrains.kotlin.jvm'
id 'com.google.devtools.ksp' version '1.6.10-1.0.2'
}
java {
sourceCompatibility = JavaVersion.VERSION_1_8
targetCompatibility = JavaVersion.VERSION_1_8
}
dependencies {
// Used 82 API Version
compileOnly 'de.robv.android.xposed:api:82'
compileOnly 'androidx.annotation:annotation:1.3.0'
implementation project(':yukihookapi')
implementation 'com.google.auto.service:auto-service-annotations:1.0.1'
compileOnly 'com.google.devtools.ksp:symbol-processing-api:1.6.10-1.0.2'
ksp 'dev.zacsweers.autoservice:auto-service-ksp:1.0.0'
}

183
yukihookapi-ksp-xposed/src/main/java/com/highcapable/yukihookapi_ksp_xposed/YukiHookXposedProcessor.kt Normal file
View File

@@ -0,0 +1,183 @@
/**
* MIT License
*
* Copyright (C) 2022 HighCapable
*
* This file is part of YukiHookAPI.
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
* SOFTWARE.
*
* This file is Created by fankes on 2022/2/5.
*/
@file:Suppress("unused")
package com.highcapable.yukihookapi_ksp_xposed
import com.google.auto.service.AutoService
import com.google.devtools.ksp.processing.*
import com.google.devtools.ksp.symbol.FileLocation
import com.google.devtools.ksp.symbol.KSAnnotated
import com.google.devtools.ksp.symbol.KSClassDeclaration
import com.highcapable.yukihookapi.annotation.xposed.InjectYukiHookWithXposed
import java.io.File
/**
* 这是 YukiHook API 的自动生成处理类 - 核心基于 KSP
*
* 可以帮你快速生成 Xposed 入口类和包名
*
* 你只需要添加 [InjectYukiHookWithXposed] 注释即可完美解决一切问题
*/
@AutoService(SymbolProcessorProvider::class)
class YukiHookXposedProcessor : SymbolProcessorProvider {
override fun create(environment: SymbolProcessorEnvironment) = object : SymbolProcessor {
/** 插入 Xposed 尾部的名称 */
private val xposedClassShortName = "_YukiHookXposedInit"
/**
* 创建一个环境方法体方便调用
* @param env 方法体
*/
private fun environment(env: SymbolProcessorEnvironment.() -> Unit) = runCatching { environment.apply(env) }
override fun process(resolver: Resolver) = emptyList<KSAnnotated>().let {
injectProcess(resolver)
it
}
/**
* 开始作业入口
* @param resolver [Resolver]
*/
private fun injectProcess(resolver: Resolver) = environment {
var injectOnce = true
resolver.getSymbolsWithAnnotation(InjectYukiHookWithXposed::class.java.name)
.asSequence()
.filterIsInstance<KSClassDeclaration>().forEach {
if (injectOnce) {
injectAssets(
codePath = (it.location as? FileLocation?)?.filePath ?: "",
packageName = it.packageName.asString(),
className = it.simpleName.asString()
)
injectClass(it.packageName.asString(), it.simpleName.asString())
} else logger.error(message = "@InjectYukiHookWithXposed only can be use in once times")
/** 仅处理第一个标记的类 - 再次处理将拦截并报错 */
injectOnce = false
}
}
/**
* 自动生成 Xposed assets 入口文件
* @param codePath 注释类的完整代码文件路径
* @param packageName 包名
* @param className 类名
*/
private fun injectAssets(codePath: String, packageName: String, className: String) = environment {
runCatching {
if (codePath.isBlank()) error("Project CodePath is empty")
val projectPath = when (File.separator) {
"\\" -> {
if (codePath.contains("\\src\\main\\"))
codePath.split("\\src\\main\\")[0] + "\\src\\main\\"
else error("Project source path must be ..\\src\\main\\..")
}
"/" -> {
if (codePath.contains("/src/main/"))
codePath.split("/src/main/")[0] + "/src/main/"
else error("Project source path must be ../src/main/..")
}
else -> error("Unix File Separator unknown")
}
File("$projectPath${File.separator}assets").also { assFile ->
if (!assFile.exists() || !assFile.isDirectory) {
assFile.delete()
assFile.mkdirs()
}
File("${assFile.absolutePath}${File.separator}xposed_init")
.writeText(text = "$packageName.${className}$xposedClassShortName")
}
}.onFailure {
logger.error(message = "Inject XposedAssets Failed! $it")
}
}
/**
* 注入并生成指定类
* @param packageName 包名
* @param className 类名
*/
private fun injectClass(packageName: String, className: String) = environment {
var realPackageName = "unknown"
if (packageName.contains(".hook."))
realPackageName = packageName.split(".hook.")[0]
else logger.warn(message = "YukiHook cannot identify your App's package name,please refer to the wiki https://github.com/fankes/YukiHookAPI/wiki to fix the package name or manually configure the package name")
codeGenerator.createNewFile(Dependencies.ALL_FILES, packageName, fileName = "${className}_YukiHookXposedInit")
.apply {
/** 🤡 由于插入的代码量不大就不想用工具生成了 */
write(
("@file:Suppress(\"EXPERIMENTAL_API_USAGE\")\n" +
"\n" +
"package $packageName\n" +
"\n" +
"import androidx.annotation.Keep\n" +
"import com.highcapable.yukihookapi.YukiHookAPI\n" +
"import com.highcapable.yukihookapi.hook.xposed.YukiHookModuleStatus\n" +
"import com.highcapable.yukihookapi.hook.log.loggerE\n" +
"import de.robv.android.xposed.IXposedHookLoadPackage\n" +
"import de.robv.android.xposed.XC_MethodReplacement\n" +
"import de.robv.android.xposed.XposedHelpers\n" +
"import de.robv.android.xposed.callbacks.XC_LoadPackage\n" +
"import $packageName.$className\n" +
"\n" +
"@Keep\n" +
"class $className$xposedClassShortName : IXposedHookLoadPackage {\n" +
"\n" +
" override fun handleLoadPackage(lpparam: XC_LoadPackage.LoadPackageParam?) {\n" +
" if (lpparam == null) return\n" +
" runCatching {\n" +
" $className().onHook()\n" +
" }.onFailure {\n" +
" loggerE(msg = \"Try to load $packageName.$className Failed\", e = it)\n" +
" }\n" +
" YukiHookAPI.modulePackageName.ifEmpty {\n" +
" YukiHookAPI.modulePackageName = \"$realPackageName\"\n" +
" \"$realPackageName\"\n" +
" }.also {\n" +
" if (lpparam.packageName == it)\n" +
" XposedHelpers.findAndHookMethod(\n" +
" YukiHookModuleStatus::class.java.name,\n" +
" lpparam.classLoader,\n" +
" \"isActive\",\n" +
" object : XC_MethodReplacement() {\n" +
" override fun replaceHookedMethod(param: MethodHookParam?) = true\n" +
" })\n" +
" }\n" +
" YukiHookAPI.onXposedLoaded(lpparam)\n" +
" }\n" +
"}").toByteArray()
)
flush()
close()
}
}
}
}

42
yukihookapi/build.gradle
View File

@@ -1,41 +1,19 @@
plugins {
id 'com.android.library'
id 'org.jetbrains.kotlin.android'
id 'java-library'
id 'org.jetbrains.kotlin.jvm'
}
android {
compileSdk 31
defaultConfig {
minSdk 22
targetSdk 31
testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
consumerProguardFiles "consumer-rules.pro"
}
sourceSets { main { java.srcDirs("src/main/kotlin") } }
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
}
}
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
kotlinOptions {
jvmTarget = '1.8'
}
java {
sourceCompatibility = JavaVersion.VERSION_1_8
targetCompatibility = JavaVersion.VERSION_1_8
sourceSets.main { java.srcDir("src/api/kotlin") }
}
kotlin { sourceSets.main { kotlin.srcDir("src/api/kotlin") } }
dependencies {
// Used 82 API Version
compileOnly 'de.robv.android.xposed:api:82'
implementation 'androidx.appcompat:appcompat:1.4.1'
testImplementation 'junit:junit:4.13.2'
androidTestImplementation 'androidx.test.ext:junit:1.1.3'
androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'
compileOnly fileTree(include: ['android-stub.jar'], dir: 'libs')
implementation 'androidx.annotation:annotation:1.3.0'
}

0
yukihookapi/consumer-rules.pro
View File

BIN
yukihookapi/libs/android-stub.jar Normal file
View File

Binary file not shown.

21
yukihookapi/proguard-rules.pro vendored
View File

@@ -1,21 +0,0 @@
# Add project specific ProGuard rules here.
# You can control the set of applied configuration files using the
# proguardFiles setting in build.gradle.
#
# For more details, see
# http://developer.android.com/guide/developing/tools/proguard.html
# If your project uses WebView with JS, uncomment the following
# and specify the fully qualified class name to the JavaScript interface
# class:
#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
# public *;
#}
# Uncomment this to preserve the line number information for
# debugging stack traces.
#-keepattributes SourceFile,LineNumberTable
# If you keep the line number information, uncomment this to
# hide the original source file name.
#-renamesourcefileattribute SourceFile

33
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/YukiHookAPI.kt → yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/YukiHookAPI.kt
View File

@@ -30,11 +30,14 @@
package com.highcapable.yukihookapi
import android.content.pm.ApplicationInfo
import androidx.annotation.Keep
import com.highcapable.yukihookapi.YukiHookAPI.encase
import com.highcapable.yukihookapi.annotation.DoNotUseField
import com.highcapable.yukihookapi.annotation.DoNotUseMethod
import com.highcapable.yukihookapi.hook.entity.YukiBaseHooker
import com.highcapable.yukihookapi.param.CustomParam
import com.highcapable.yukihookapi.param.PackageParam
import com.highcapable.yukihookapi.hook.param.CustomParam
import com.highcapable.yukihookapi.hook.param.PackageParam
import de.robv.android.xposed.callbacks.XC_LoadPackage
/**
* YukiHook 的装载 API 调用类
@@ -43,22 +46,36 @@ import com.highcapable.yukihookapi.param.PackageParam
*
* 模块装载方式已经自动对接 Xposed API - 可直接调用 [encase] 完成操作
*/
@Keep
object YukiHookAPI {
/** 全局标识 */
const val TAG = "YukiHookAPI"
/** Xposed Hook API 绑定的模块包名 */
/**
* Xposed Hook API 绑定的模块包名 - 未写将自动生成
* - 你不应该设置此变量的名称 - 请使用 [encase] 装载模块包名
*/
@DoNotUseField
internal var modulePackageName = ""
@Keep
var modulePackageName = ""
/** Xposed Hook API 方法体回调 */
@DoNotUseField
internal var packageParamCallback: (PackageParam.() -> Unit)? = null
private var packageParamCallback: (PackageParam.() -> Unit)? = null
/**
* 装载 Xposed API 回调
*
* - 装载代码将自动生成 - 你不应该手动使用此方法装载 Xposed 模块事件
* @param lpparam Xposed [XC_LoadPackage.LoadPackageParam]
*/
@DoNotUseMethod
@Keep
fun onXposedLoaded(lpparam: XC_LoadPackage.LoadPackageParam) = packageParamCallback?.invoke(PackageParam(lpparam))
/**
* 作为模块装载调用入口方法 - Xposed API
* @param moduleName 模块包名 - 填入当前的 BuildConfig.APPLICATION_ID
* @param moduleName 你的模块包名 - 可通过 Xposed API 自动生成
* @param initiate Hook 方法体
*/
fun encase(moduleName: String = "", initiate: PackageParam.() -> Unit) {
@@ -68,7 +85,7 @@ object YukiHookAPI {
/**
* 作为模块装载调用入口方法 - Xposed API
* @param moduleName 模块包名 - 填入当前的 BuildConfig.APPLICATION_ID
* @param moduleName 你的模块包名 - 可通过 Xposed API 自动生成
* @param hooker Hook 子类数组 - 必填不能为空
* @throws IllegalStateException 如果 [hooker] 是空的
*/

2
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/annotation/DoNotUseField.kt → yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/annotation/DoNotUseField.kt
View File

@@ -45,7 +45,7 @@ package com.highcapable.yukihookapi.annotation
)
@Retention(AnnotationRetention.BINARY)
/**
* ⚠️ 警告方法外部调用声明
* -️ 警告方法外部调用声明
* 此方法除继承和接口外不应该在这里被调用
* 如果调用此方法可能会出现错误或 APP 发生异常
*/

2
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/annotation/DoNotUseMethod.kt → yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/annotation/DoNotUseMethod.kt
View File

@@ -45,7 +45,7 @@ package com.highcapable.yukihookapi.annotation
)
@Retention(AnnotationRetention.BINARY)
/**
* ⚠️ 警告方法外部调用声明
* - 警告方法外部调用声明
* 此方法除继承和接口外不应该在这里被调用
* 如果调用此方法可能会出现错误或 APP 发生异常
*/

0
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/annotation/UseLessField.kt → yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/annotation/UseLessField.kt
View File

0
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/annotation/UseLessMethod.kt → yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/annotation/UseLessMethod.kt
View File

65
yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/annotation/xposed/InjectYukiHookWithXposed.kt Normal file
View File

@@ -0,0 +1,65 @@
/**
* MIT License
*
* Copyright (C) 2022 HighCapable
*
* This file is part of YukiHookAPI.
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
* SOFTWARE.
*
* This file is Created by fankes on 2022/2/3.
*/
@file:Suppress("unused")
package com.highcapable.yukihookapi.annotation.xposed
import androidx.annotation.Keep
import com.highcapable.yukihookapi.YukiHookAPI
import com.highcapable.yukihookapi.hook.proxy.YukiHookXposedInitProxy
/**
* 标识 YukiHook 注入 Xposed 入口的类注释
*
* - 你的项目 source 目录必须为 ../src/main/ 后方内容根据你自行喜好定义即可 - 否则编译会报错
*
* - 你的 Hook 入口类(HookEntryClass) 需要按照此格式创建 --> 你的模块APP包名/hook/...可允许子包名存在.../你的入口类
*
* 例子：com.example.module.hook.MainHook、com.example.module.hook.inject.MainInject、com.example.module.hook.custom.CustomClass
*
* 你的 xposed_init 入口将被自动生成为 --> 你的模块APP包名/hook/...可允许子包名存在.../你的入口类_YukiHookXposedInit
*
* 例子：com.example.module.hook.MainHook_YukiHookXposedInit
*
* - 你的模块包名将被这样识别：|com.example.module|.hook...
*
* - 若你不喜欢这样创建类 - 没问题 - 请在 [YukiHookAPI.encase] 中自行指定模块包名即可 - 但不按照规则定义包名你将会收到编译警告
*
* 例子：YukiHookAPI.encase(moduleName = "com.example.module", ...)
*
* - 最后这一点很重要：请不要随意修改项目 ../src/main/assets/xposed_init 中的内容 - 否则可能会导致模块装载发生错误
*
* 你必须将被注释的类继承于 [YukiHookXposedInitProxy] 接口实现 [YukiHookXposedInitProxy.onHook] 方法 - 否则编译会报错
*
* 只能拥有一个 Hook 入口 - 若存在多个注释编译会报错
*
* 详情请参考 [YukiHookAPI Wiki](https://github.com/fankes/YukiHookAPI/wiki)
*/
@Target(AnnotationTarget.CLASS)
@Keep
annotation class InjectYukiHookWithXposed

4
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/hook/core/YukiHookCreater.kt → yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/core/YukiHookCreater.kt
View File

@@ -34,8 +34,8 @@ import com.highcapable.yukihookapi.hook.core.finder.ConstructorFinder
import com.highcapable.yukihookapi.hook.core.finder.FieldFinder
import com.highcapable.yukihookapi.hook.core.finder.MethodFinder
import com.highcapable.yukihookapi.hook.log.loggerE
import com.highcapable.yukihookapi.param.HookParam
import com.highcapable.yukihookapi.param.PackageParam
import com.highcapable.yukihookapi.hook.param.HookParam
import com.highcapable.yukihookapi.hook.param.PackageParam
import de.robv.android.xposed.XC_MethodHook
import de.robv.android.xposed.XC_MethodReplacement
import de.robv.android.xposed.XposedBridge

0
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/hook/core/finder/ConstructorFinder.kt → yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/core/finder/ConstructorFinder.kt
View File

0
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/hook/core/finder/FieldFinder.kt → yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/core/finder/FieldFinder.kt
View File

0
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/hook/core/finder/MethodFinder.kt → yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/core/finder/MethodFinder.kt
View File

2
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/hook/entity/YukiBaseHooker.kt → yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/entity/YukiBaseHooker.kt
View File

@@ -29,8 +29,8 @@ package com.highcapable.yukihookapi.hook.entity
import com.highcapable.yukihookapi.YukiHookAPI
import com.highcapable.yukihookapi.annotation.DoNotUseMethod
import com.highcapable.yukihookapi.hook.param.PackageParam
import com.highcapable.yukihookapi.hook.proxy.YukiHookXposedInitProxy
import com.highcapable.yukihookapi.param.PackageParam
/**
* YukiHook 的子类实现

0
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/hook/factory/ReflectionFactory.kt → yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/factory/ReflectionFactory.kt
View File

15
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/hook/factory/YukiHookFactory.kt → yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/factory/YukiHookFactory.kt
View File

@@ -35,12 +35,12 @@ import android.net.Uri
import android.os.Bundle
import com.highcapable.yukihookapi.YukiHookAPI
import com.highcapable.yukihookapi.hook.entity.YukiBaseHooker
import com.highcapable.yukihookapi.hook.param.PackageParam
import com.highcapable.yukihookapi.hook.proxy.YukiHookXposedInitProxy
import com.highcapable.yukihookapi.param.PackageParam
/**
* 在 [YukiHookXposedInitProxy] 中装载 [YukiHookAPI]
* @param moduleName 模块包名 - 填入当前的 BuildConfig.APPLICATION_ID
* @param moduleName 你的模块包名 - 可通过 Xposed API 自动生成
* @param initiate Hook 方法体
*/
fun YukiHookXposedInitProxy.encase(moduleName: String = "", initiate: PackageParam.() -> Unit) =
@@ -48,11 +48,18 @@ fun YukiHookXposedInitProxy.encase(moduleName: String = "", initiate: PackagePar
/**
* 在 [YukiHookXposedInitProxy] 中装载 [YukiHookAPI]
* @param moduleName 模块包名 - 填入当前的 BuildConfig.APPLICATION_ID
* @param hooker Hook 子类数组 - 必填不能为空
* @throws IllegalStateException 如果 [hooker] 是空的
*/
fun YukiHookXposedInitProxy.encase(moduleName: String = "", vararg hooker: YukiBaseHooker) =
fun YukiHookXposedInitProxy.encase(vararg hooker: YukiBaseHooker) = YukiHookAPI.encase(hooker = hooker)
/**
* 在 [YukiHookXposedInitProxy] 中装载 [YukiHookAPI]
* @param moduleName 你的模块包名 - 可通过 Xposed API 自动生成
* @param hooker Hook 子类数组 - 必填不能为空
* @throws IllegalStateException 如果 [hooker] 是空的
*/
fun YukiHookXposedInitProxy.encase(moduleName: String, vararg hooker: YukiBaseHooker) =
YukiHookAPI.encase(moduleName, *hooker)
/**

0
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/hook/log/LoggerFactory.kt → yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/log/LoggerFactory.kt
View File

2
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/param/CustomParam.kt → yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/param/CustomParam.kt
View File

@@ -25,7 +25,7 @@
*
* This file is Created by fankes on 2022/2/2.
*/
package com.highcapable.yukihookapi.param
package com.highcapable.yukihookapi.hook.param
import android.content.pm.ApplicationInfo

2
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/param/HookParam.kt → yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/param/HookParam.kt
View File

@@ -27,7 +27,7 @@
*/
@file:Suppress("unused", "MemberVisibilityCanBePrivate")
package com.highcapable.yukihookapi.param
package com.highcapable.yukihookapi.hook.param
import de.robv.android.xposed.XC_MethodHook
import java.lang.reflect.Constructor

6
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/param/PackageParam.kt → yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/param/PackageParam.kt
View File

@@ -27,7 +27,7 @@
*/
@file:Suppress("unused", "MemberVisibilityCanBePrivate", "EXPERIMENTAL_API_USAGE")
package com.highcapable.yukihookapi.param
package com.highcapable.yukihookapi.hook.param
import android.content.pm.ApplicationInfo
import com.highcapable.yukihookapi.annotation.DoNotUseMethod
@@ -40,7 +40,7 @@ import de.robv.android.xposed.callbacks.XC_LoadPackage
*
* 如果你想将 YukiHook 作为 Hook API 使用 - 你可自定义 [customParam]
*
* ⚠️ 特别注意如果 [baseParam] 和 [customParam] 都为空将发生问题
* - 特别注意如果 [baseParam] 和 [customParam] 都为空将发生问题
* @param baseParam 对接 Xposed API 的 [XC_LoadPackage.LoadPackageParam] - 默认空
* @param customParam 自定义装载类 - 默认空
*/
@@ -116,7 +116,7 @@ open class PackageParam(
/**
* 将目标 [Class] 绑定到 [appClassLoader]
*
* ⚠️ 请注意未绑定到 [appClassLoader] 的 [Class] 不能被装载 - 调用 [hook] 方法会自动绑定
* - 请注意未绑定到 [appClassLoader] 的 [Class] 不能被装载 - 调用 [hook] 方法会自动绑定
* @return [Class]
* @throws NoClassDefFoundError 如果找不到类会报错
*/

0
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/hook/proxy/YukiHookXposedInitProxy.kt → yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/proxy/YukiHookXposedInitProxy.kt
View File

0
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/hook/type/ComponentTypeFactory.kt → yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/type/ComponentTypeFactory.kt
View File

0
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/hook/type/VariableTypeFactory.kt → yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/type/VariableTypeFactory.kt
View File

0
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/hook/type/ViewTypeFactory.kt → yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/type/ViewTypeFactory.kt
View File

0
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/hook/utils/ReflectionUtils.java → yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/utils/ReflectionUtils.java
View File

0
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/hook/xposed/YukiHookModuleStatus.kt → yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/xposed/YukiHookModuleStatus.kt
View File

2
yukihookapi/src/main/AndroidManifest.xml
View File

@@ -1,2 +0,0 @@
<?xml version="1.0" encoding="utf-8"?>
<manifest package="com.highcapable.yukihookapi" />

1
yukihookapi/src/main/assets/xposed_init
View File

@@ -1 +0,0 @@
com.highcapable.yukihookapi.hook.xposed.YukiHookLoadPackage

45
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/annotation/xposed/InjectYukiHookWithXposed.kt
View File

@@ -1,45 +0,0 @@
/**
* MIT License
*
* Copyright (C) 2022 HighCapable
*
* This file is part of YukiHookAPI.
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
* SOFTWARE.
*
* This file is Created by fankes on 2022/2/3.
*/
package com.highcapable.yukihookapi.annotation.xposed
import androidx.annotation.Keep
import com.highcapable.yukihookapi.hook.proxy.YukiHookXposedInitProxy
import com.highcapable.yukihookapi.hook.xposed.YukiHookLoadPackage
/**
* 标识注入 YukiHook 的类
*
* 此类将使用 [YukiHookLoadPackage] 自动调用 XposedInit
*
* 你可以将被注释的类继承于 [YukiHookXposedInitProxy] 接口实现 [YukiHookXposedInitProxy.onHook] 方法
*
* 只能拥有一个 Hook 入口 - 多个入口将以首个得到的入口为准
*/
@Target(AnnotationTarget.CLASS)
@Keep
annotation class InjectYukiHookWithXposed

90
yukihookapi/src/main/kotlin/com/highcapable/yukihookapi/hook/xposed/YukiHookLoadPackage.kt
View File

@@ -1,90 +0,0 @@
/**
* MIT License
*
* Copyright (C) 2022 HighCapable
*
* This file is part of YukiHookAPI.
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
* SOFTWARE.
*
* This file is Created by fankes on 2022/2/2.
*/
@file:Suppress("EXPERIMENTAL_API_USAGE")
package com.highcapable.yukihookapi.hook.xposed
import androidx.annotation.Keep
import com.highcapable.yukihookapi.YukiHookAPI
import com.highcapable.yukihookapi.annotation.xposed.InjectYukiHookWithXposed
import com.highcapable.yukihookapi.hook.factory.clazz
import com.highcapable.yukihookapi.hook.factory.findConstructor
import com.highcapable.yukihookapi.hook.factory.findMethod
import com.highcapable.yukihookapi.hook.log.loggerE
import com.highcapable.yukihookapi.hook.proxy.YukiHookXposedInitProxy
import com.highcapable.yukihookapi.hook.type.BooleanType
import com.highcapable.yukihookapi.param.PackageParam
import de.robv.android.xposed.IXposedHookLoadPackage
import de.robv.android.xposed.callbacks.XC_LoadPackage
/**
* 接管 Xposed 的 [IXposedHookLoadPackage] 入口
*
* 你可以使用 [YukiHookAPI.encase] 或在 [YukiHookXposedInitProxy] 中监听模块开始装载
*
* 需要标识 Hook 入口的类 - 请声明注释 [InjectYukiHookWithXposed]
*/
@Keep
class YukiHookLoadPackage : IXposedHookLoadPackage {
override fun handleLoadPackage(lpparam: XC_LoadPackage.LoadPackageParam?) {
if (lpparam == null) return
runCatching {
/** 执行入口方法 */
hookEntryClassName().clazz.apply {
findMethod(name = "onHook")?.invoke(findConstructor()?.newInstance())
}
}.onFailure {
loggerE(msg = "Try to load ${hookEntryClassName()} Failed", e = it)
}
/** 装载 APP Hook 实体类 */
PackageParam(lpparam).apply {
/** Hook 模块激活状态 */
loadApp(name = YukiHookAPI.modulePackageName) {
YukiHookModuleStatus::class.java.hook {
injectMember {
method {
name = "isActive"
returnType = BooleanType
}
replaceToTrue()
}.onAllFailure { loggerE(msg = "Try to Hook ModuleStatus Failed", e = it) }
}
}
/** 设置装载回调 */
YukiHookAPI.packageParamCallback?.invoke(this)
}
}
/**
* 获得目标装载类名 - 通过 APT 自动设置 TODO 待实现
* @return [String] 目标装载类名
*/
@Keep
private fun hookEntryClassName() = "com.highcapable.yukihookapi.demo.hook.inject.MainInjecter"
}