Android编译期代码生成之apt实践入门

 2023-09-13 阅读 15 评论 0

摘要:现在 Android 主流库中使用 apt 的越来越多,如Dagger2,ButterKnife,DBflow等。不研究一下其怎么玩的,心里实在是不舒服斯基,所以就有了这篇apt代码简单生成的文章。文章的末尾,会附上一些关于注解的基础知识,有兴趣的童鞋可

现在 Android 主流库中使用 apt 的越来越多,如Dagger2,ButterKnife,DBflow等。不研究一下其怎么玩的,心里实在是不舒服斯基,所以就有了这篇apt代码简单生成的文章。文章的末尾,会附上一些关于注解的基础知识,有兴趣的童鞋可以再去看看。

Annotation库-定义注解

android源代码的编译过程、首先,我们得需要新建一个名称为annotation的Java Library。这里简单的建一个@interfact的注解类即可。如下:

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.CLASS)
public @interface Test {String value();
}

可以看到的是,这是编译时期的注解,主要作用于Class。之后,在调用的地方就是需要使用我们的这个注解。

Compiler库-注解处理器

1.使用库引入

这里,也使用的是Java Library,我们把报名定为 compiler,先定义gradle文件:

apply plugin: 'java'sourceCompatibility = 1.7
targetCompatibility = 1.7dependencies {compile 'com.google.auto.service:auto-service:1.0-rc2'compile 'com.squareup:javapoet:1.7.0'compile project(':annotation')
}

代码中,引入两个库,AutoService主要的作用是注解processor类,并对其生成 META-INF 的配置信息。

JavaPoet这个库的主要作用就是帮助我们通过类调用的形式来生成代码。

2. 定义Processor类

建立一个名称为TestProcessor的类,如下:

@AutoService(Processor.class)
public class TestProcessor extends AbstractProcessor {@Overridepublic Set<String> getSupportedAnnotationTypes() {return Collections.singleton(Test.class.getCanonicalName());}@Overridepublic boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {return false;}
}

其中要注意的是使用AutoSerivce的注解,这样就不用再手动配置 META-INF文件了。方法getSupportedAnnotationTypes则是定义我们针对生成的注解类,方法process则是我们的重头戏,其中则是我们生成代码的主要逻辑之处:

@Override
public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {Set<? extends Element> set = roundEnv.getElementsAnnotatedWith(Test.class);for (Element element : set) {if (element.getKind() != ElementKind.CLASS) {processingEnv.getMessager().printMessage(Diagnostic.Kind.ERROR, "only support class");}MethodSpec main = MethodSpec.methodBuilder("main").addModifiers(Modifier.PUBLIC, Modifier.STATIC).returns(void.class).addParameter(String[].class, "args").addStatement("$T.out.println($S)", System.class, "Hello, JavaPoet!").build();TypeSpec helloWorld =TypeSpec.classBuilder("HelloWorld").addModifiers(Modifier.PUBLIC, Modifier.FINAL).addMethod(main).build();JavaFile javaFile = JavaFile.builder("com.lighters.apt", helloWorld).build();try {javaFile.writeTo(processingEnv.getFiler());} catch (IOException e) {e.printStackTrace();}}return false;
}

这里简单使用JavaPoet文档中的第一个example, 生成一个简单的HelloWorld类。大家可自己行去查看JavaPoet的更多用法,支持各种姿势生成Java的代码,并与Processor完美契合。

代码调用

准备工作都完成之后,接下来就在我们的主目录app下面,通过添加注解,来查看我们的代码生成逻辑。

1.添加依赖

在根目录的build.gradle文件中的dependencies节点下面添加如下代码:

classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8' 

app的build.gradle中添加如下代码:

apply plugin: 'com.neenbedankt.android-apt'
dependencies {compile project(':annotation')apt project(':compiler')
}

2.添加注解

这里,就偷一个小懒,在MainActivity上,添加注解Test,格式如下:

@Test("haha")
public class MainActivity extends AppCompatActivity {
}

3.代码生成

注意,这里定义的注解为编译期的注解,所以代码的生成,只需要通过执行Rebuild即可。执行完成之后,在app的build/generated/source/apt目录下,即可看到咱们的代码,如图:
代码生成

总结

apt代码的生成是定义编译期的注解,再通过继承Proccesor实现代码生成逻辑,实现了编译期生成代码的逻辑。相对于在运行期通过反射来说,提高了程序的运行速度。这里只是简单引导大家搭建自己的apt处理器,更多的内容期待大家各自玩出花来。

学习资料

附上一篇标准的编译期代码生成,以及trinea关于annotation的详细介绍。

  • Annotation实战【自定义AbstractProcessor】

  • Java Annotation 及几个常用开源项目注解原理简析

另外,使用apt的代码库Dagger2, Butterknife大家可自行深入研究了。

转载请注明原文链接: http://alighters.com/blog/2016/05/10/apt-code-generate/

版权声明:本站所有资料均为网友推荐收集整理而来,仅供学习和研究交流使用。

原文链接:https://hbdhgg.com/3/51727.html

发表评论:

本站为非赢利网站,部分文章来源或改编自互联网及其他公众平台,主要目的在于分享信息,版权归原作者所有,内容仅供读者参考,如有侵权请联系我们删除!

Copyright © 2022 匯編語言學習筆記 Inc. 保留所有权利。

底部版权信息