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

...

Browse Source
This commit is contained in:
Fankesyooni
2022-02-04 00:36:51 +08:00
parent 53ab3eae81
commit d3ab6d58b8
9 changed files with 210 additions and 56 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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

@@ -29,21 +29,16 @@
package com.highcapable.yukihookapi.demo.hook
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.hook.factory.encase
import com.highcapable.yukihookapi.hook.proxy.YukiHookXposedInitProxy
import com.highcapable.yukihookapi.hook.entity.YukiBaseHooker
import com.highcapable.yukihookapi.hook.type.StringType
@InjectYukiHookWithXposed
class MainHooker : YukiHookXposedInitProxy {
class MainHooker : YukiBaseHooker() {
private val moduleName = BuildConfig.APPLICATION_ID
override fun onHook() = encase(moduleName) {
loadApp(name = moduleName) {
override fun onHook() =
loadApp(name = BuildConfig.APPLICATION_ID) {
MainActivity::class.java.hook {
injectMember {
method {
@@ -67,8 +62,6 @@ class MainHooker : YukiHookXposedInitProxy {
beforeHook { args().set("构造方法已被 Hook 成功") }
}
}
loadHooker(hooker = SecondHooker())
loadHooker(hooker = TestChildHooker())
}
loadApp(name = "com.android.browser", hooker = ThirdHooker())
}
}

33
app/src/main/java/com/highcapable/yukihookapi/demo/hook/SecondHooker.kt
View File

@@ -27,17 +27,40 @@
*/
package com.highcapable.yukihookapi.demo.hook
import android.app.AlertDialog
import android.widget.Toast
import com.highcapable.yukihookapi.hook.entity.YukiBaseHooker
import com.highcapable.yukihookapi.hook.type.StringType
import com.highcapable.yukihookapi.hook.factory.findMethod
import com.highcapable.yukihookapi.hook.type.ActivityClass
import com.highcapable.yukihookapi.hook.type.BundleClass
// for test
class SecondHooker : YukiBaseHooker() {
override fun onHook() =
findClass(name = "$packageName.InjectTestName").hook {
injectMember {
constructor { param(StringType) }
beforeHook { args().set("构造方法已被 Hook 成功 [2]") }
loadApp(name = "com.android.browser") {
ActivityClass.hook {
injectMember {
method {
name = "onCreate"
param(BundleClass)
}
afterHook {
AlertDialog.Builder(instance())
.setCancelable(false)
.setTitle("测试 Hook")
.setMessage("Hook 已成功")
.setPositiveButton("OK") { _, _ ->
Toast.makeText(instance(), "Hook Success", Toast.LENGTH_SHORT).show()
}.show()
}
}
injectMember {
member = hookClass.findMethod(name = "onStart")
afterHook {
Toast.makeText(instance(), "手动 Hook", Toast.LENGTH_SHORT).show()
}
}
}
}
}

33
app/src/main/java/com/highcapable/yukihookapi/demo/hook/ThirdHooker.kt → app/src/main/java/com/highcapable/yukihookapi/demo/hook/TestChildHooker.kt
View File

@@ -23,42 +23,21 @@
* 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.
* This file is Created by fankes on 2022/2/4.
*/
package com.highcapable.yukihookapi.demo.hook
import android.app.AlertDialog
import android.widget.Toast
import com.highcapable.yukihookapi.hook.entity.YukiBaseHooker
import com.highcapable.yukihookapi.hook.factory.findMethod
import com.highcapable.yukihookapi.hook.type.ActivityClass
import com.highcapable.yukihookapi.hook.type.BundleClass
import com.highcapable.yukihookapi.hook.type.StringType
// for test
class ThirdHooker : YukiBaseHooker() {
class TestChildHooker : YukiBaseHooker() {
override fun onHook() =
ActivityClass.hook {
findClass(name = "$packageName.InjectTestName").hook {
injectMember {
method {
name = "onCreate"
param(BundleClass)
}
afterHook {
AlertDialog.Builder(instance())
.setCancelable(false)
.setTitle("测试 Hook")
.setMessage("Hook 已成功")
.setPositiveButton("OK") { _, _ ->
Toast.makeText(instance(), "Hook Success", Toast.LENGTH_SHORT).show()
}.show()
}
}
injectMember {
member = hookClass.findMethod(name = "onStart")
afterHook {
Toast.makeText(instance(), "手动 Hook", Toast.LENGTH_SHORT).show()
}
constructor { param(StringType) }
beforeHook { args().set("构造方法已被 Hook 成功 [2]") }
}
}
}

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

@@ -0,0 +1,114 @@
/**
* 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/4.
*/
@file:Suppress("unused")
package com.highcapable.yukihookapi.demo.hook.inject
import android.app.AlertDialog
import android.widget.Toast
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
import com.highcapable.yukihookapi.hook.type.ActivityClass
import com.highcapable.yukihookapi.hook.type.BundleClass
import com.highcapable.yukihookapi.hook.type.StringType
// for test
@InjectYukiHookWithXposed
class MainInjecter : YukiHookXposedInitProxy {
override fun onHook() {
// 方案 1
encase(BuildConfig.APPLICATION_ID, MainHooker(), SecondHooker())
// 方案 2
encase(BuildConfig.APPLICATION_ID) {
loadApp(name = BuildConfig.APPLICATION_ID) {
MainActivity::class.java.hook {
injectMember {
method {
name = "test"
returnType = StringType
}
replaceTo("这段文字已被 Hook 成功")
}
injectMember {
method {
name = "test"
param(StringType)
returnType = StringType
}
beforeHook { args().set("方法参数已被 Hook 成功") }
}
}
InjectTest::class.java.hook {
injectMember {
constructor { param(StringType) }
beforeHook { args().set("构造方法已被 Hook 成功") }
}
}
findClass(name = "$packageName.InjectTestName").hook {
injectMember {
constructor { param(StringType) }
beforeHook { args().set("构造方法已被 Hook 成功 [2]") }
}
}
}
loadApp(name = "com.android.browser") {
ActivityClass.hook {
injectMember {
method {
name = "onCreate"
param(BundleClass)
}
afterHook {
AlertDialog.Builder(instance())
.setCancelable(false)
.setTitle("测试 Hook")
.setMessage("Hook 已成功")
.setPositiveButton("OK") { _, _ ->
Toast.makeText(instance(), "Hook Success", Toast.LENGTH_SHORT).show()
}.show()
}
}
injectMember {
member = hookClass.findMethod(name = "onStart")
afterHook {
Toast.makeText(instance(), "手动 Hook", Toast.LENGTH_SHORT).show()
}
}
}
}
}
}
}

16
yukihookapi/src/main/java/com/highcapable/yukihookapi/YukiHookAPI.kt
View File

@@ -32,6 +32,7 @@ package com.highcapable.yukihookapi
import android.content.pm.ApplicationInfo
import com.highcapable.yukihookapi.YukiHookAPI.encase
import com.highcapable.yukihookapi.annotation.DoNotUseField
import com.highcapable.yukihookapi.hook.entity.YukiBaseHooker
import com.highcapable.yukihookapi.param.CustomParam
import com.highcapable.yukihookapi.param.PackageParam
@@ -65,6 +66,21 @@ object YukiHookAPI {
packageParamCallback = initiate
}
/**
* 作为模块装载调用入口方法 - Xposed API
* @param moduleName 模块包名 - 填入当前的 BuildConfig.APPLICATION_ID
* @param hooker Hook 子类数组 - 必填不能为空
* @throws IllegalStateException 如果 [hooker] 是空的
*/
fun encase(moduleName: String = "", vararg hooker: YukiBaseHooker) {
modulePackageName = moduleName
packageParamCallback = {
if (hooker.isNotEmpty())
hooker.forEach { it.assignInstance(packageParam = this) }
else error("Hooker is empty")
}
}
/**
* 自定义 Hook 方法装载入口
* @param classLoader [ClassLoader]

9
yukihookapi/src/main/java/com/highcapable/yukihookapi/hook/entity/YukiBaseHooker.kt
View File

@@ -65,6 +65,15 @@ import com.highcapable.yukihookapi.param.PackageParam
*/
abstract class YukiBaseHooker : PackageParam() {
/**
* 赋值并克隆一个 [PackageParam]
* @param packageParam 需要使用的 [PackageParam]
*/
internal fun assignInstance(packageParam: PackageParam) {
baseAssignInstance(packageParam)
onHook()
}
/** 子类 Hook 开始 */
abstract fun onHook()
}

10
yukihookapi/src/main/java/com/highcapable/yukihookapi/hook/factory/YukiHookFactory.kt
View File

@@ -34,6 +34,7 @@ import android.content.Intent
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.proxy.YukiHookXposedInitProxy
import com.highcapable.yukihookapi.param.PackageParam
@@ -45,6 +46,15 @@ import com.highcapable.yukihookapi.param.PackageParam
fun YukiHookXposedInitProxy.encase(moduleName: String = "", initiate: PackageParam.() -> Unit) =
YukiHookAPI.encase(moduleName, initiate)
/**
* 在 [YukiHookXposedInitProxy] 中装载 [YukiHookAPI]
* @param moduleName 模块包名 - 填入当前的 BuildConfig.APPLICATION_ID
* @param hooker Hook 子类数组 - 必填不能为空
* @throws IllegalStateException 如果 [hooker] 是空的
*/
fun YukiHookXposedInitProxy.encase(moduleName: String = "", vararg hooker: YukiBaseHooker) =
YukiHookAPI.encase(moduleName, *hooker)
/**
* 判断模块是否在太极、无极中激活
* @return [Boolean] 是否激活

8
yukihookapi/src/main/java/com/highcapable/yukihookapi/hook/proxy/YukiHookXposedInitProxy.kt
View File

@@ -64,6 +64,14 @@ import com.highcapable.yukihookapi.hook.factory.encase
*
* ....
*
* 若你喜欢分类创建 Hooker - 还可以这样写：
*
* ......
*
* override fun onHook() = encase(moduleName = "模块包名", MainHooker(), SecondHooker(), ThirdHooker() ...)
*
* ......
*
* 详情请参考 https://github.com/fankes/YukiHookAPI/wiki
*/
@Keep

26
yukihookapi/src/main/java/com/highcapable/yukihookapi/param/PackageParam.kt
View File

@@ -44,8 +44,8 @@ import de.robv.android.xposed.callbacks.XC_LoadPackage
* @param customParam 自定义装载类 - 默认空
*/
open class PackageParam(
private val baseParam: XC_LoadPackage.LoadPackageParam? = null,
private val customParam: CustomParam? = null
private var baseParam: XC_LoadPackage.LoadPackageParam? = null,
private var customParam: CustomParam? = null
) {
/**
@@ -85,6 +85,15 @@ open class PackageParam(
*/
val isFirstApplication get() = baseParam?.isFirstApplication ?: true
/**
* 赋值并克隆另一个 [PackageParam]
* @param another 另一个 [PackageParam]
*/
internal fun baseAssignInstance(another: PackageParam) {
this.baseParam = another.baseParam
this.customParam = another.customParam
}
/**
* 装载并 Hook 指定包名的 APP
* @param name 包名
@@ -94,20 +103,13 @@ open class PackageParam(
if (packageName == name) initiate(this)
}
/**
* 装载并 Hook 指定包名的 APP
* @param name 包名
* @param hooker Hook 子类
*/
fun loadApp(name: String, hooker: YukiBaseHooker) {
if (packageName == name) hooker.onHook()
}
/**
* 装载 Hook 子类
*
* 你可以在 Hooker 中继续装载 Hooker
* @param hooker Hook 子类
*/
fun loadHooker(hooker: YukiBaseHooker) = hooker.onHook()
fun loadHooker(hooker: YukiBaseHooker) = hooker.assignInstance(packageParam = this)
/**
* 将目标 [Class] 绑定到 [appClassLoader]