AspectJX

由于原作者不再维护，所以fork过来自己维护。

原作者说明文档

最新版本（3.0.0）

查看完整版本日志

开发中的测试版本访问：Sonatype's snapshot repository

如何使用

插件引用

方式一：apply方式

在项目根目录的build.gradle里依赖AspectJX

// Top-level build file where you can add configuration options common to all sub-projects/modules.
buildscript {
    repositories {
        // 已发布到mavenCentral仓库
        mavenCentral()
    }

    dependencies {
        // aspectj插件
        classpath 'io.github.wurensen:gradle-android-plugin-aspectjx:<version>'
    }
}

在app项目的build.gradle里应用插件：

// 3.0.0开始，id已变更：
apply plugin: 'io.github.wurensen.android-aspectjx'

// 3.0.0以下：
apply plugin: 'android-aspectjx'
//或者这样也可以
apply plugin: 'com.hujiang.android-aspectjx'

注意：为了保持plugins方式引入和apply plugin方式引入id一致，所以插件id已变更。

方式二：plugins方式

plugins {
  // 3.0.0版本开始支持直接从gradlePluginPortal仓库拉取
  id "io.github.wurensen.android-aspectjx" version "version"
}

对于3.0.0以下版本想采用plugins方式，请用旧版本id，并且自定义拉取策略：配置方式

AspectJX配置

AspectJX默认会处理所有的二进制代码文件和库，为了提升编译效率及规避部分第三方库出现的编译兼容性问题，AspectJX提供include、exclude命令来过滤需要处理的文件及排除某些文件(包括class文件及jar文件)。

支持包名匹配

aspectjx {
    // 排除所有package路径中包含`android.support`的class文件及库（jar文件）
    exclude 'android.support'
}

注意事项1：规则的描述尽量用比较具体的范围，防止exclude的范围超出预期 注意事项2：注意apt编译期生成的类，比如项目的某个module模块用到glide注解生成类，生成的类会匹配上com.bumptech.glide导致整个module被过滤

支持*和**匹配单独使用

aspectjx {
    // 忽略所有的class文件及jar文件，相当于AspectJX不生效
    exclude '*'
}

提供enabled开关

enabled默认为true，即默认AspectJX生效

aspectjx {
    // 关闭AspectJX功能
    enabled false
}

适配情况

使用依赖	适配版本	兼容版本
Android Gradle Plugin	7.2.2	4.1.3
Gradle	7.3.3	6.5
org.aspectj:aspectjtools	1.9.6	1.9.6

适配AGP最新大版本和兼容上一个大版本

常见问题

• 问：AspectJX是否支持*.aj文件的编译?

  答：不支持。目前AspectJX仅支持annotation的方式，具体可以参考支持kotlin代码织入的AspectJ Demo

• 问：编译时会出现can't determine superclass of missing type**及其他编译错误怎么办？

  答：大部分情况下把出现问题相关的class文件或者库（jar文件）过滤掉就可以搞定了

• 问：项目使用kotlin或kotlin协程，发生织入错误？

  答：请按以下方式exclude掉kotlin库

  aspectjx {
      enabled = false
      // 移除kotlin相关，编译错误和提升速度
      exclude 'kotlin.jvm', 'kotlin.internal'
      exclude 'kotlinx.coroutines.internal', 'kotlinx.coroutines.android'
  }

有任何问题可以提Issues或者discussions

License

Copyright 2022 LanceWu

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

 http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.