Skip to content

分析组件之间的真实依赖关系,并分析类之间的调用情况,解决找不到类、方法、字段等问题

Notifications You must be signed in to change notification settings

MRwangqi/ModuleRef

Repository files navigation

插件能力

  1. 分析模块之间的引用关系
  2. 依赖重复类检查
  3. 未解决的引用检查,避免运行时出现 NoClassDefFoundErrorNoSuchMethodErrorNoSuchFieldError 等异常

插件介绍

插件接入:

buildscript {
    repositories {
        maven { url "https://raw.githubusercontent.com/MRwangqi/Maven/main" }
    }
    dependencies {
        classpath "com.github.MRwangqi:moduleRefPlugin:1.0.0"
    }
}

在 app/build.gradle 中添加插件:

plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
    id 'moduleRef'
}
moduleRefConfig {
    // 设置只分析的依赖模块,如果不设置,则默认分析所有依赖模块,支持正则表达式
    entryModule = ['androidx\\.compose\\.ui\\:.*']
    // 设置忽略检查的类
    ignoreClazz = [".*\\.R",
                   ".*\\.R\\\$.*",
                   ".*\\.BuildConfig"]
}

执行命令模板如下:

./gradlew moduleRef -Pbuild=${build variant}

要执行的 build variant 可以在 Android studio 中查看:

image.png

比如我们要检查 debug 的依赖分析,则命令如下:

./gradlew moduleRef -Pbuild=debug

当然,也可以直接使用如下命令进行检查,插件默认的 build variant 是 debug

./gradlew moduleRef

执行完成后会在 app/build 目录生成 moduleRef.json 文件

该插件会通过字节码来分析依赖之间的真实引用关系,分析效果如下:

{
  "androidx.compose.ui:ui:1.3.0": {
    "dependencies": [
      "org.jetbrains.kotlin:kotlin-stdlib:1.7.20",
      "androidx.compose.ui:ui-unit:1.3.0",
      "androidx.compose.runtime:runtime:1.3.0",
      "androidx.compose.ui:ui-graphics:1.3.0",
      "//............."
    ],
    "unsolved": {
      "clazz": [
        "android.view.RenderNode",
        "android.view.DisplayListCanvas"
      ],
      "fields": [
        "androidx.compose.ui.platform.RenderNodeApi23_android.view.RenderNode"
      ],
      "methods": []
    }
  }
}
  • dependenciesandroidx.compose.ui:ui:1.3.0 所使用到的依赖
  • unsolvedandroidx.compose.ui:ui:1.3.0 依赖使用到的 类、字段和方法在整个依赖关系中都找不到

其他说明:

  • 有的模块可能就是会报 unsolved,例如 androidx.compose.ui:ui 依赖的 RenderNodeApi23 与 RenderNodeApi29 类中的 RenderNode,他们的包名在不同的 SDK 版本不一样,但他们在运行阶段会通过 SDK 版本来选择加载哪个类,所以,类似这类的 unsolved 是可以放过的,但前提是做好 review

生成依赖引用关系图

插件还会根据 moduleRef.json 生成 moduleRef.pumlmoduleRef.mmd文件,如果 AS 安装了 plantUML 插件的话,可以直接在 AS 中查看 moduleRef.puml 的依赖关系图,如果没装的话,也可以导入语雀查看,如下是通过语雀导出的 moduleRef.svg 图,语雀也支持 moduleRef.mmd 的渲染,也可以使用 mermaid-js 网站来渲染 moduleRef.mmd 内容

todo

1、AbstractMethodError 异常检查:检查是否存在父类(抽象方法、接口方法)方法被子类覆盖,如果父类有,但子类没有,则说明会发生该异常

About

分析组件之间的真实依赖关系,并分析类之间的调用情况,解决找不到类、方法、字段等问题

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published