AndroidAOP 是专属于 Android 端 Aop 框架,只需一个注解就可以请求权限、切换线程、禁止多点、监测生命周期等等,本库不是基于 AspectJ 实现的 Aop,当然你也可以定制出属于你的 Aop 代码
AndroidAOP – Github链接
特色功能
1、本库内置了开发中常用的一些切面注解供你使用
2、本库支持让你自己做切面,语法简单易上手
3、本库同步支持 Java 和 Kotlin 代码
4、本库支持切入三方库
5、本库支持切点方法为 Lambda 表达式的情况
6、本库支持生成所有切点信息Json文件,方便一览所有切点位置在此配置
7、本库不是基于 AspectJ 实现的,织入代码量极少,侵入性极低
点此下载apk
版本限制
最低Gradle版本:8.0
最低SDK版本:minSdkVersion >= 21
使用步骤
在开始之前可以给项目一个Star吗?非常感谢,你的支持是我唯一的动力。欢迎Star和Issues!
一、在项目根目录下的build.gradle添加(必须)
buildscript {
dependencies {
//必须项
classpath 'io.github.FlyJingFish.AndroidAop:android-aop-plugin:1.2.0'
}
}
plugins {
//非必须项 ,如果需要自定义切面,并且使用 android-aop-ksp 这个库的话需要配置 ,下边版本号根据你项目的 Kotlin 版本决定
id 'com.google.devtools.ksp' version '1.8.0-1.0.9' apply false
}
Kotlin 和 KSP Github 的匹配版本号列表
二、在 app 的build.gradle添加(此步为必须项)
⚠️注意:此步为必须项
//必须项
plugins {
...
id 'android.aop'//最好放在最后一行
}
三、引入依赖库
plugins {
//非必须项 ,如果需要自定义切面,并且使用 android-aop-ksp 这个库的话需要配置
id 'com.google.devtools.ksp'
}
dependencies {
//必须项
implementation 'io.github.FlyJingFish.AndroidAop:android-aop-core:1.2.0'
implementation 'io.github.FlyJingFish.AndroidAop:android-aop-annotation:1.2.0'
//非必须项 ,如果你想自定义切面需要用到,⚠️支持Java和Kotlin代码写的切面
ksp 'io.github.FlyJingFish.AndroidAop:android-aop-ksp:1.2.0'
//非必须项 ,如果你想自定义切面需要用到,⚠️只适用于Java代码写的切面
annotationProcessor 'io.github.FlyJingFish.AndroidAop:android-aop-processor:1.2.0'
//⚠️上边的 android-aop-ksp 和 android-aop-processor 二选一
}
提示:ksp 或 annotationProcessor只是在当前 module 起作用,在哪个 module 中有自定义切面代码就加在哪个 module,必须依赖项可以通过 api 方式只加到公共 module 上
四、在 app 的build.gradle添加 androidAopConfig 配置项(此步为可选配置项)
plugins {
...
}
androidAopConfig {
// enabled 为 false 切面不再起作用,默认不写为 true
enabled true
// include 不设置默认全部扫描,设置后只扫描设置的包名的代码
include '你项目的包名','自定义module的包名','自定义module的包名'
// exclude 是扫描时排除的包
// 可排除 kotlin 相关,提高速度
exclude 'kotlin.jvm', 'kotlin.internal','kotlinx.coroutines.internal', 'kotlinx.coroutines.android'
// verifyLeafExtends 是否开启验证叶子继承,默认打开,如果没有设置 @AndroidAopMatchClassMethod 的 type = MatchType.LEAF_EXTENDS,可以关闭
verifyLeafExtends true
//默认关闭,开启在 Build 或 打包后 将会生成切点信息json文件在 app/build/tmp/cutInfo.json
cutInfoJson false
}
android {
...
}
提示:合理使用 include 和 exclude 可提高编译速度,建议直接使用 include 设置你项目的相关包名(包括 app 和自定义 module 的)
另外设置此处之后由于 Android Studio 可能有缓存,建议重启 AS 并 clean 下项目再继续开发
本库内置了一些功能注解可供你直接使用
注解名称 |
参数说明 |
功能说明 |
@SingleClick |
value = 快速点击的间隔,默认1000ms |
单击注解,加入此注解,可使你的方法只有单击时才可进入 |
@DoubleClick |
value = 两次点击的最大用时,默认300ms |
双击注解,加入此注解,可使你的方法双击时才可进入 |
@IOThread |
ThreadType = 线程类型 |
切换到子线程的操作,加入此注解可使你的方法内的代码切换到子线程执行 |
@MainThread |
无参数 |
切换到主线程的操作,加入此注解可使你的方法内的代码切换到主线程执行 |
@OnLifecycle |
value = Lifecycle.Event |
监听生命周期的操作,加入此注解可使你的方法内的代码在对应生命周期内才去执行 |
@TryCatch |
value = 你自定义加的一个flag |
加入此注解可为您的方法包裹一层 try catch 代码 |
@Permission |
value = 权限的字符串数组 |
申请权限的操作,加入此注解可使您的代码在获取权限后才执行 |
@Scheduled |
initialDelay = 延迟开始时间 interval = 间隔 repeatCount = 重复次数 isOnMainThread = 是否主线程 id = 唯一标识 |
定时任务,加入此注解,可使你的方法每隔一段时间执行一次,调用AndroidAop.shutdownNow(id)或AndroidAop.shutdown(id)可停止 |
@Delay |
delay = 延迟时间 isOnMainThread = 是否主线程 id = 唯一标识 |
延迟任务,加入此注解,可使你的方法延迟一段时间执行,调用AndroidAop.shutdownNow(id)或AndroidAop.shutdown(id)可取消 |
@CustomIntercept |
value = 你自定义加的一个字符串数组的flag |
自定义拦截,配合 AndroidAop.setOnCustomInterceptListener 使用,属于万金油 |
上述注解使用示例都在这,还有这
这块强调一下 @OnLifecycle
- 1、@OnLifecycle 加到的方法所属对象必须是属于直接或间接继承自 FragmentActivity 或 Fragment的方法才有用,或者注解方法的对象实现 LifecycleOwner 也可以
- 2、如果第1点不符合的情况下,可以给切面方法第一个参数设置为第1点的类型,在调用切面方法传入也是可以的,例如:
public class StaticClass {
@SingleClick(5000)
@OnLifecycle(Lifecycle.Event.ON_RESUME)
public static服务器托管网 void onStaticPermission(MainActivity activity, int maxSelect , ThirdActivity.OnPhotoSelectListener back){
back.onBack();
}
}
下面再着重介绍下 @TryCatch @Permission @CustomIntercept
- @TryCatch 使用此注解你可以设置以下设置(非必须)
AndroidAop.INSTANCE.setOnThrowableListener(new OnThrowableListener() {
@Nullable
@Override
public Object handleThrowable(@NonNull String flag, @Nullable Throwable throwable,TryCatch tryCatch) {
// TODO: 2023/11/11 发生异常可根据你当时传入的flag作出相应处理,如果需要改写返回值,则在 return 处返回即可
return 3;
}
});
- @Permission 使用此注解必须配合以下设置(⚠️此步为必须设置的,否则是没效果的)
AndroidAop.INSTANCE.setOnPermissionsInterceptListener(new OnPermissionsInterceptListener() {
@SuppressLint("CheckResult")
@Override
public void requestPermission(@NonNull ProceedJoinPoint joinPoint, @NonNull Permission permission, @NonNull OnRequestPermissionListener call) {
Object target = joinPoint.getTarget();
if (target instanceof FragmentActivity){
RxPermissions rxPermissions = new RxPermissions((FragmentActivity) target);
rxPermissions.request(permission.value()).subscribe(call::onCall);
}else if (target instanceof Fragment){
RxPermissions rxPermissions = new RxPermissions((Fragment) target);
rxPermissions.request(permission.value()).subscribe(call::onCall);
}else{
// TODO: target 不是 FragmentActivity 或 Fragment ,说明注解所在方法不在其中,请自行处理这种情况
// 建议:切点方法第一个参数可以设置为 FragmentActivity 或 Fragment ,然后 joinPoint.args[0] 就可以拿到
}
}
});
- @CustomIntercept 使用此注解你必须配合以下设置(⚠️此步为必须设置的,否则还有什么意义呢?)
AndroidAop.INSTANCE.setOnCustomInterceptListener(new OnCustomInterceptListener() {
@Nullable
@Override
public Object invoke(@NonNull ProceedJoinPoint joinPoint, @NonNull CustomIntercept customIntercept) {
// TODO: 2023/11/11 在此写你的逻辑 在合适的地方调用 joinPoint.proceed(),
// joinPoint.proceed(args)可以修改方法传入的参数,如果需要改写返回值,则在 return 处返回即可
return null;
}
});
上边三个监听,最好放到你的 application 中
此外本库也同样支持让你自己做切面,实现起来非常简单!
本库通过 @AndroidAopPointCut 和 @AndroidAopMatchClassMethod 两种注解,实现自定义切面
一、@AndroidAopPointCut 是在方法上通过注解的形式做切面的,上述中注解都是通过这个做的,详细使用请看wiki文档
⚠️注意:自定义的注解(也就是被 @AndroidAopPointCut 注解的注解类)如果是 Kotlin 代码请用 android-aop-ksp 那个库
下面以 @CustomIntercept 为例介绍下该如何使用
- 创建注解
@AndroidAopPointCut(CustomInterceptCut.class)
@Target({ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
public @interface CustomIntercept {
String[] value() default {};
}
- 创建注解处理切面的类(需要实现 BasePointCut 接口,它的泛型填上边的注解)
class CustomInterceptCut : BasePointCut {
override fun invoke(
joinPoint: ProceedJoinPoint,
annotation: CustomIntercept //annotation就是你加到方法上的注解
): Any? {
// 在此写你的逻辑
// joinPoint.proceed() 表示继续执行切点方法的逻辑,不调用此方法不会执行切点方法里边的代码
// 关于 ProceedJoinPoint 可以看wiki 文档,详细点击下方链接
return joinPoint.proceed()
}
}
关于 ProceedJoinPoint 使用说明,下文的 ProceedJoinPoint 同理
- 使用
直接将你写的注解加到任意一个方法上,例如加到了 onCustomIntercept() 当 onCustomIntercept() 被调用时首先会进入到上文提到的 CustomInterceptCut 的 invoke 方法上
@CustomIntercept("我是自定义数据")
fun onCustomIntercept(){
}
二、@AndroidAopMatchClassMethod 是做匹配某类及其对应方法的切面的
匹配方法支持精准匹配,点此看wiki详细使用文档
⚠️注意:自定义的匹配类方法切面(也就是被 @AndroidAopMatchClassMethod 注解的代码)如果是 Kotlin 代码请用 android-aop-ksp 那个库
- 例子一
package com.flyjingfish.test_lib;
public class TestMatch {
public void test1(int value1,String value2){
}
public String test2(int value1,String value2){
return value1+value2;
}
}
假如 TestMatch 是要匹配的类,而你想要匹配到 test2 这个方法,下边是匹配写法:
package com.flyjingfish.test_lib.mycut;
@AndroidAopMatchClassMethod(
targetClassName = "com.flyjingfish.test_lib.TestMatch",
methodName = ["test2"],
type = MatchType.SELF
)
class MatchTestMatchMethod : MatchClassMethod {
override fun invoke(joinPoint: ProceedJoinPoint, methodName: String): Any? {
Log.e("MatchTestMatchMethod","======"+methodName+",getParameterTypes="+joinPoint.getTargetMethod().getParameterTypes().length);
// 在此写你的逻辑
//不想执行原来方法逻辑,就不调用下边这句
return joinPoint.proceed()
}
}
可以看到上方 AndroidAopMatchClassMethod 设置的 type 是 MatchType.SELF 表示只匹配 TestMatch 这个类自身,不考虑其子类
- 例子二
假如想 Hook 所有的 android.view.View.OnClickListener 的 onClick,说白了就是想全局监测所有的设置 OnClickListener 的点击事件,代码如下:
@AndroidAopMatchClassMethod(
targetClassName = "android.view.View.OnClickListener",
methodName = ["onClick"],
type = MatchType.EXTENDS //type 一定是 EXTENDS 因为你想 hook 所有继承了 OnClickListener 的类
)
class MatchOnClick : MatchClassMethod {
// @SingleClick(5000) //联合 @SingleClick ,给所有点击增加防多点,6不6
override fun invoke(joinPoint: ProceedJoinPoint, methodName: String): Any? {
Log.e("MatchOnClick", "=====invoke=====$methodName")
return joinPoint.proceed()
}
}
可以看到上方 AndroidAopMatchClassMethod 设置的 type 是 MatchType.EXTENDS 表示匹配所有继承自 OnClickListener 的子类,另外更多继承方式,请参考Wiki文档
⚠️注意:如果子类没有该方法,则切面无效,另外对同一个类的同一个方法不要做多次匹配,否则只有一个会生效
匹配切面实用场景:
- 例如你想做退出登陆逻辑时可以使用上边这个,只要在页面内跳转就可以检测是否需要退出登陆
- 又或者你想在三方库某个方法上设置切面,可以直接设置对应类名,对应方法,然后 type = MatchType.SELF,这样可以侵入三方库的代码,当然这么做记得修改上文提到的 androidAopConfig 的配置
详细使用请看wiki文档
常见问题
1、Build时报错 “ZipFile invalid LOC header (bad signature)”
- 请重启Android Studio,然后 clean 项目
2、 同一个方法存在多个注解或匹配切面时,怎么处理的
- 多个切面叠加到一个方法上时注解优先于匹配切面(上文的匹配切面),注解切面之间从上到下依次执行
- 调用 proceed 才会执行下一个切面,多个切面中最后一个切面执行 proceed
- 在前边切面中调用 proceed(args)
- 存在异步调用proceed时,第一个异步调用 proceed 切面的返回值(就是 invoke 的返回值)就是切入方法的返回值;
混淆规则
下边是涉及到本库的一些必须混淆规则
# AndroidAop必备混淆规则 -----start-----
-keep class * {
@androidx.annotation.Keep ;
}
-keepnames class * implements com.flyjingfish.android_aop_annotation.base.BasePointCut
-keepnames class * implements com.flyjingfish.android_aop_annotation.base.MatchClassMethod
-keep class * implements com.flyjingfish.android_aop_annotation.base.BasePointCut{
public ();
}
-keep class * implements com.flyjingfish.android_aop_annotation.base.MatchClassMethod{
public ();
}
# AndroidAop必备混淆规则 -----end-----
服务器托管,北京服务器托管,服务服务器托管网器租用 http://www.fwqtg.net
机房租用,北京机房租用,IDC机房托管, http://www.fwqtg.net
Homebrew 是 macOS 上的强大的包管理工具,可以高效管理各种软件包。Homebrew 由 Max Howell 从 2009 年开始开发并在 GitHub 上开源,最初在 macOS 用户中和 Ruby 社区中得到广泛使用,2019 年 Homeb…