Dexmaker

一个用于在编译时或运行时针对Dalvik虚拟机进行代码生成的Java语言API。与cglib或ASM不同，该库生成Dalvik .dex文件而不是Java .class文件。

它有一个小巧、接近底层的API。这个API反映了Dalvik字节码规范，给你对生成的字节码有很强的控制。代码是逐条指令生成的; 如果需要的话,你可以带来自己的抽象语法树。由于它使用Dalvik的dx工具作为后端,你可以免费获得高效的寄存器分配和常规/宽指令选择。

它的作用是什么?

Mockito Mocks

Dexmaker允许您在Android项目中使用Mockito模拟库,通过生成Dalvik字节码类代理来实现。只需在androidTestImplementation依赖项中添加dexmaker-mockito,您就可以在Android Instrumentation测试中使用Mockito。

Dexmaker针对的Mockito版本可以在dexmaker-mockito的build.gradle文件中找到。一般规则是Dexmaker的主版本和次版本将匹配Mockito的主版本和次版本。

模拟最终类和方法

从Android "P"版本开始,可以使用dexmaker-mockito-inline库模拟final类和方法。如果您在运行Android P或更高版本的设备或模拟器上执行测试,您可以在androidTestImplementation依赖项中添加dexmaker-mockito-inline(而不是dexmaker-mockito;不要同时添加两者),并且可以使用普通的Mockito API在Android Instrumentation测试中模拟final类和方法。

**注意:**这个功能需要在Android P中引入的操作系统API,无法在旧版本的Android上工作。

类代理

Dexmaker包含一个用于类代理的标准代码生成器。 如果您只想进行AOP或类模拟,您不需要处理字节码。

运行时代码生成

这个示例生成一个类和一个方法。然后将该类加载到当前进程并调用其方法。

public final class HelloWorldMaker {
    public static void main(String[] args) throws Exception {
        DexMaker dexMaker = new DexMaker();

        // 生成一个HelloWorld类。
        TypeId<?> helloWorld = TypeId.get("LHelloWorld;");
        dexMaker.declare(helloWorld, "HelloWorld.generated", Modifier.PUBLIC, TypeId.OBJECT);
        generateHelloMethod(dexMaker, helloWorld);

        // 创建dex文件并加载它。
        File outputDir = new File(".");
        ClassLoader loader = dexMaker.generateAndLoad(HelloWorldMaker.class.getClassLoader(),
                outputDir, outputDir);
        Class<?> helloWorldClass = loader.loadClass("HelloWorld");

        // 在进程内执行我们新生成的代码。
        helloWorldClass.getMethod("hello").invoke(null);
    }

    /**
     * 生成等同于以下方法的Dalvik字节码。
     *    public static void hello() {
     *        int a = 0xabcd;
     *        int b = 0xaaaa;
     *        int c = a - b;
     *        String s = Integer.toHexString(c);
     *        System.out.println(s);
     *        return;
     *    }
     */
    private static void generateHelloMethod(DexMaker dexMaker, TypeId<?> declaringType) {
        // 查找我们沿途需要的一些类型。
        TypeId<System> systemType = TypeId.get(System.class);
        TypeId<PrintStream> printStreamType = TypeId.get(PrintStream.class);

        // 确定declaringType上的'hello()'方法。
        MethodId hello = declaringType.getMethod(TypeId.VOID, "hello");

        // 在dexMaker上声明该方法。使用返回的Code实例
        // 作为一个我们可以附加指令的构建器。
        Code code = dexMaker.declare(hello, Modifier.STATIC | Modifier.PUBLIC);

        // 提前声明我们需要的所有局部变量。API需要这样做。
        Local<Integer> a = code.newLocal(TypeId.INT);
        Local<Integer> b = code.newLocal(TypeId.INT);
        Local<Integer> c = code.newLocal(TypeId.INT);
        Local<String> s = code.newLocal(TypeId.STRING);
        Local<PrintStream> localSystemOut = code.newLocal(printStreamType);

        // int a = 0xabcd;
        code.loadConstant(a, 0xabcd);

        // int b = 0xaaaa;
        code.loadConstant(b, 0xaaaa);

        // int c = a - b;
        code.op(BinaryOp.SUBTRACT, c, a, b);

        // String s = Integer.toHexString(c);
        MethodId<Integer, String> toHexString
                = TypeId.get(Integer.class).getMethod(TypeId.STRING, "toHexString", TypeId.INT);
        code.invokeStatic(toHexString, s, c);

        // System.out.println(s);
        FieldId<System, PrintStream> systemOutField = systemType.getField(printStreamType, "out");
        code.sget(systemOutField, localSystemOut);
        MethodId<PrintStream, Void> printlnMethod = printStreamType.getMethod(
                TypeId.VOID, "println", TypeId.STRING);
        code.invokeVirtual(printlnMethod, null, localSystemOut, s);

        // return;
        code.returnVoid();
    }
}

下载

对于Mockito支持,通过Maven下载最新的.jar:

    <dependency>
      <groupId>com.linkedin.dexmaker</groupId>
      <artifactId>dexmaker-mockito</artifactId>
      <version>2.28.4</version>
      <type>pom</type>
    </dependency>

或Gradle:

    androidTestImplementation 'com.linkedin.dexmaker:dexmaker-mockito:2.28.4'

注意: Mockito的依赖关系将被传递包含,所以不需要同时指定Mockito和dexmaker-mockito

快照

您可以使用快照构建来测试最新的未发布更改。在将每个合并推送到主分支后,都会通过部署快照 Github Action 工作流发布一个新的快照。

只需将Sonatype快照存储库添加到您的Gradle脚本中:

repositories {
    maven {
        url "https://oss.sonatype.org/content/repositories/snapshots/"
    }
}

您可以在gradle.properties文件中找到最新的快照版本号。