入门必看小技巧
如何创建groovy文件
- 我在自己写demo学习过程中,右键发现并没有能直接选择new groovy class的选择,有的只是选择Scratch File,但是这个Scratch File创建的groovy文件并没有在我们选中的目录生成,而是在固定的Scraches and Consoles目录下生成。所以我网上搜也没找到安装什么as安装什么plugin可以直接像kotlin样,右键就能当前目录下简单生成一个groovy文件。所以最后我都是new -> File -> 手动给文件添加后缀groovy。
apply plugin以及闭包的含义
- 这里我推荐一个b站的up主的视频,里面都分析了apply plugin、buildscript、repositories、dependencies等含义。应该自行学习。
视频链接
如何自定义gradle插件
首先第一步创建一个Library,名字命名为buildSrc(这个名字在android中只能叫这个名字),专门给gradle识别为插件工程。
new -> module -> Java or Kotlin Library -> buildSrc名字在main目录下,创建 groovy、kotlin、resources、java(看个人需要不)四个Package。其中该章节最重要的就是groovy、和resources目录了。
-
groovy目录下创建自己的groovy class,resources目录这里讲下作用,我们所有实现org.gradle.api.Plugin接口的groovy类都统称为groovy插件,而resources下面新建META-INF目录后,再新建个gradle-plugins目录,该gradle-plugins目录可以自定义gradle插件往外暴露的名字对应那个插件在工作。
提示:自定义gradle插件往外暴露插件名称路径:在META-INF目录 -> gradle-plugins -> 创建 xxxx.properties文件,其中xxxx为你向外暴露的插件名称,关键字implementation-class告诉gradle映射到哪个路径下的gradle插件工作。文件里面内容如图一所示
详细步骤请看 苍耳的博客
如何判断gradle插件是否生效
-
按照苍耳大佬的博客自定义完gradle插件后,只需要在我们的app下的build.gradle引入我们自定义好的插件即可(图二所示)
温馨提示:如果没看上面推荐视频的同学我这里多嘴提一下。通过resources目录自定义往外暴露的gradle插件后,这个引入方法是不是就和com.android.application一致了呢!!所以说com.android.application实际也是一个android的groovy插件,只不过这个名义映射的是另外一个gradle插件,而不是我们自己定义的gradle插件。 -
引入插件后,只需要build一次,图三中我们就能看到输出的内容和编译后的class文件。
-
如何把转换后的class类变成java,查看是否成功在onCreate函数最后一行插入了一段代码呢?先找到我们转换过后的class类,路径如图四所示。找到class文件后,点击as顶部的Tools -> Kotlin -> show kotlin Bytecode -> 点击Decompile后,我们就能看到具体代码内容了,效果如图五所示。
编写过程中遇到问题
-
编写玩代码后,在app的gradle上依赖自己定义的gradle插件,sync的时候报错找不到该类。google搜索了一番,最后发现原来自己定义的TransformPlugin没有加.groovy后缀,导致as编制时候识别不了。但是as是不报错的。
那么如何避免、排查这类问题呢?我发现一个小窍门:你所写的所以groovy语法的文件,在sync后都会在build目录下自动生成一份,你点击自己的groovy文件的时候,as就会提示你说这个类名已经存在了,这样子就证明你写的groovy文件是没问题的。如果你sync后,点击你的groovy类没有飘红提示,那就是这个文件没添加后缀名导致的。
正确时候的as文件目录表现:
总结
- 遇到新知识,一步一脚印,多点看,我前期也是一脸懵逼,但是看的多,学的多以后,理解其中原理后,就会焕然大悟,收获很多新知识。希望大家也能一起努力进步。
- demo地址:feature_1.0.3_study_gradle分支
- 参考文献: Android-Gradle-Transform用法。该文章结合了Javassist来教导我们去入门gradle,对新手理解来说很友好。