All Downloads are FREE. Search and download functionalities are using the official Maven repository.

de.mobilej.ProcessRealAndroidJar Maven / Gradle / Ivy

Go to download

Gradle plugin to be used in combination with the new unit testing feature of the Gradle Plugin / Android Studio to use real classes for e.g. SparseArray.

The newest version!
/*
   Copyright (C) 2015 Björn Quentin

   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.
 */

package de.mobilej;

import java.io.BufferedInputStream;
import java.io.BufferedOutputStream;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.nio.file.FileSystem;
import java.nio.file.FileSystems;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.StandardCopyOption;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Enumeration;
import java.util.List;
import java.util.jar.JarEntry;
import java.util.jar.JarOutputStream;
import java.util.zip.ZipEntry;
import java.util.zip.ZipFile;
import java.util.zip.ZipOutputStream;

import javassist.CannotCompileException;
import javassist.ClassPool;
import javassist.CtClass;
import javassist.CtConstructor;
import javassist.CtMethod;
import javassist.Modifier;
import javassist.NotFoundException;
import javassist.expr.ExprEditor;
import javassist.expr.MethodCall;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

/**
 * Here the heavy lifting happens.
 *
 * We take the all-android.jar and copy the wanted classes to the destination.
 *
 * The copied classes will be non-final/non-private and also all methods contained.
 *
 * Additionally all native methods will be changed to delegate to de.mobilej.ABridge.callXXX methods
 * for easier mocking.
 */
public class ProcessRealAndroidJar {


    private static final Logger log = LoggerFactory.getLogger(ProcessRealAndroidJar.class);

    public static void process(File allAndroidFile,
                               File tmpDir,
                               File unmockedOutputJar,
                               String[] keepClasses,
                               String[] renameClasses,
                               String[] delegateClasses,
                               Logger logger) throws Exception {

        List classesToMap = parseClassesToMap(renameClasses, logger);

        List keepClassesList = new ArrayList<>(Arrays.asList(keepClasses));
        for (ClassMapping mapping : classesToMap) {
            keepClassesList.add(mapping.from);
        }
        keepClasses = keepClassesList.toArray(new String[0]);

        delete(tmpDir);
        tmpDir.mkdirs();

        ArrayList clazzNames = findAllClazzesIn(
                allAndroidFile.getAbsolutePath());

        ClassPool pool = new ClassPool(null);
        pool.appendSystemPath();

        pool.insertClassPath(allAndroidFile.getAbsolutePath());

        createHelperClasses(tmpDir, pool);

        List clazzes = new ArrayList<>();

        for (String clazzName : clazzNames) {
            CtClass clazz = pool.get(clazzName);

            boolean keep = false;
            for (String keepClass : keepClasses) {
                if (keepClass.startsWith("-")) {
                    String pureKeepClassName = keepClass.substring(1);
                    if (clazz.getName().equals(pureKeepClassName)) {
                        keep = true;
                        break;
                    } else if (clazz.getName().startsWith(pureKeepClassName + "$")) {
                        keep = true;
                        break;
                    }


                } else {
                    if (clazz.getName().startsWith(keepClass)) {
                        keep = true;
                        break;
                    }
                }
            }

            boolean delegate = false;
            for (String delegateClazzName : delegateClasses) {
                if (clazz.getName().equals(delegateClazzName)) {
                    delegate = true;
                    break;
                } else if (clazz.getName().startsWith(delegateClazzName + "$")) {
                    delegate = true;
                    break;
                }
            }

            if (!keep && !delegate) {
                continue;
            }

            try {
                if (keep) {
                    process(clazz, classesToMap);
                } else if (delegate) {
                    processDelegate(clazz, classesToMap);
                }
            } catch (Exception e) {
                logger.error("-> unable to process", e);
            }

            clazzes.add(clazz);
        }

        // Write the files after all CtClass objects have been modified, otherwise Javassist
        // doesn't allow modifying a nested class when the outer class has been written already
        // (it freezes the outer class again).
        for (CtClass clazz : clazzes) {
            clazz.writeFile(tmpDir.getAbsolutePath());
        }

        // copy over non-classes matching "keepStartsWith" paths
        ArrayList toCopy = new ArrayList<>();
        ArrayList nonClasses = findAllNonClassFilesIn(allAndroidFile.getAbsolutePath());
        for (String keep : keepClasses) {
            if (!keep.startsWith("-")) {
                for (String file : nonClasses) {
                    if (file.startsWith(keep.replace(".", "/"))) {
                        toCopy.add(file);
                    }
                }
            }
        }
        copyFromJarToDirectory(allAndroidFile.getAbsolutePath(), toCopy, tmpDir.getAbsoluteFile());

        createJarArchive(unmockedOutputJar.getAbsolutePath(), tmpDir.getAbsolutePath());

    }

    private static List parseClassesToMap(String[] renameClasses, Logger logger) {
        ArrayList result = new ArrayList<>();

        if (renameClasses == null) {
            return result;
        }

        for (String classRenaming : renameClasses) {
            int indexOfEquals = classRenaming.indexOf("=");
            if (indexOfEquals > 0 && indexOfEquals < classRenaming.length()) {
                String from = classRenaming.substring(0, indexOfEquals);
                String to = classRenaming.substring(indexOfEquals + 1);
                result.add(new ClassMapping(from, to));

            } else {
                logger.error("Unparseable mapping:" + classRenaming);
            }
        }

        return result;
    }

    public static boolean createJarArchive(String outfile, String srcFolder) throws Exception {

        FileOutputStream dest = new FileOutputStream(new File(outfile));

        JarOutputStream out = new JarOutputStream(new BufferedOutputStream(dest));

        addToJar(out, new File(srcFolder), new File(srcFolder));

        out.flush();
        out.close();

        return true;
    }

    private static void addToJar(JarOutputStream out, File folder, File root) throws Exception {
        File[] files = folder.listFiles();

        if (files == null) {
            return;
        }

        for (File f : files) {
            if (f.isDirectory()) {
                addToJar(out, f, root);
            } else {
                addJarEntry(out, f, root);
            }
        }
    }

    private static BufferedInputStream addJarEntry(ZipOutputStream out, File f, File root)
            throws IOException {
        int BUFFER = 2048;
        byte data[] = new byte[BUFFER];

        BufferedInputStream origin;
        FileInputStream fi = new FileInputStream(f);
        origin = new BufferedInputStream(fi, BUFFER);
        String name = f.getCanonicalPath().substring(root.getCanonicalPath().length() + 1).replace('\\', '/');
        JarEntry entry = new JarEntry(name);
        out.putNextEntry(entry);
        int count;
        while ((count = origin.read(data, 0, BUFFER)) != -1) {
            out.write(data, 0, count);
            out.flush();
        }

        origin.close();

        return origin;
    }

    private static void createHelperClasses(File out, ClassPool pool)
            throws CannotCompileException, IOException {
        CtClass bridge = pool.makeClass("de.mobilej.ABridge");

        bridge.addMethod(CtMethod.make(
                "public static Object callObject(String signature, Object thiz, Object[] args){" +
                        "return (Object)null;" +
                        "}", bridge));

        bridge.addMethod(CtMethod.make(
                "public static int callInt(String signature, Object thiz, Object[] args){" +
                        "return 0;" +
                        "}", bridge));

        bridge.addMethod(CtMethod.make(
                "public static long callLong(String signature, Object thiz, Object[] args){" +
                        "return 0L;" +
                        "}", bridge));

        bridge.addMethod(CtMethod.make(
                "public static boolean callBoolean(String signature, Object thiz, Object[] args){" +
                        "return false;" +
                        "}", bridge));

        bridge.addMethod(CtMethod.make(
                "public static byte callByte(String signature, Object thiz, Object[] args){" +
                        "return 0;" +
                        "}", bridge));

        bridge.addMethod(CtMethod.make(
                "public static float callFloat(String signature, Object thiz, Object[] args){" +
                        "return 0f;" +
                        "}", bridge));

        bridge.addMethod(CtMethod.make(
                "public static double callDouble(String signature, Object thiz, Object[] args){" +
                        "return 0d;" +
                        "}", bridge));

        bridge.addMethod(CtMethod.make(
                "public static void callVoid(String signature, Object thiz, Object[] args){" +
                        "return;" +
                        "}", bridge));

        bridge.writeFile(out.getAbsolutePath());
    }

    private static ArrayList findAllClazzesIn(String file) throws IOException {
        ArrayList res = new ArrayList();

        ZipFile f = new ZipFile(file);
        Enumeration entries = f.entries();
        while (entries.hasMoreElements()) {
            ZipEntry entry = entries.nextElement();
            if (entry.getName().endsWith(".class")) {
                res.add(entry.getName().replace(".class", "").replace("/", "."));
            }

        }

        return res;
    }

    private static ArrayList findAllNonClassFilesIn(String file) throws IOException {
        ArrayList res = new ArrayList();

        ZipFile f = new ZipFile(file);
        Enumeration entries = f.entries();
        while (entries.hasMoreElements()) {
            ZipEntry entry = entries.nextElement();
            if (!entry.isDirectory() && !entry.getName().endsWith(".class")) {
                res.add(entry.getName());
            }

        }

        return res;
    }

    private static void copyFromJarToDirectory(String file, List files, File destDir) throws IOException {
        try (FileSystem fileSystem = FileSystems.newFileSystem(Paths.get(file), (ClassLoader) null)) {
            for (String toCopy : files) {
                Path source = fileSystem.getPath(toCopy);
                File dst = new File(destDir, toCopy);
                dst.getParentFile().mkdirs();
                Files.copy(source, dst.toPath(), StandardCopyOption.REPLACE_EXISTING);
            }
        }
    }

    private static void processDelegate(CtClass clazz, List classMappings) throws Exception {
        if (clazz.isInterface()) {
            return;
        }

        clazz.defrost();

        clazz.setModifiers(clazz.getModifiers() | Modifier.PUBLIC);
        clazz.setModifiers(clazz.getModifiers() & ~Modifier.FINAL);
        clazz.setModifiers(clazz.getModifiers() & ~Modifier.PRIVATE);
        clazz.setModifiers(clazz.getModifiers() & ~Modifier.PROTECTED);

        CtMethod[] methods = clazz.getDeclaredMethods();
        for (CtMethod m : methods) {
            // we delegate every method here
            delegateMethod(m);


            m.setModifiers(m.getModifiers() | Modifier.PUBLIC);
            m.setModifiers(m.getModifiers() & ~Modifier.FINAL);
            m.setModifiers(m.getModifiers() & ~Modifier.PRIVATE);
            m.setModifiers(m.getModifiers() & ~Modifier.PROTECTED);
            m.setModifiers(m.getModifiers() & ~Modifier.NATIVE);
        }

        CtConstructor[] ctors = clazz.getDeclaredConstructors();
        for (CtConstructor c : ctors) {
            // we also delegate every ctor here
            String signature = c.getLongName();
            String thiz = "$0";

            c.setBody("{ de.mobilej.ABridge.callVoid(\"" + signature + "\", " + thiz
                    + ", $args); } ");

            c.setModifiers(c.getModifiers() | Modifier.PUBLIC);
            c.setModifiers(c.getModifiers() & ~Modifier.FINAL);
            c.setModifiers(c.getModifiers() & ~Modifier.PRIVATE);
            c.setModifiers(c.getModifiers() & ~Modifier.PROTECTED);
            c.setModifiers(c.getModifiers() & ~Modifier.NATIVE);
        }

        for (ClassMapping mapping : classMappings) {
            clazz.replaceClassName(mapping.from, mapping.to);
        }
    }

    private static void delegateMethod(CtMethod m) throws NotFoundException, CannotCompileException {
        String signature = m.getLongName();
        String thiz = "$0";
        if ((m.getModifiers() & Modifier.STATIC) == Modifier.STATIC) {
            thiz = "null";
        }

        String retType = m.getReturnType().getName();

        switch (retType) {
            case "void":
                m.setBody("{ de.mobilej.ABridge.callVoid(\"" + signature + "\", " + thiz
                        + ", $args); } ");
                break;
            case "boolean":
                m.setBody(
                        "{ return de.mobilej.ABridge.callBoolean(\"" + signature + "\", "
                                + thiz
                                + ", $args); } ");
                break;
            case "int":
                m.setBody(
                        "{ return de.mobilej.ABridge.callInt(\"" + signature + "\", " + thiz
                                + ", $args); } ");
                break;
            case "long":
                m.setBody("{ return de.mobilej.ABridge.callLong(\"" + signature + "\", "
                        + thiz
                        + ", $args); } ");
                break;
            case "byte":
                m.setBody("{ return de.mobilej.ABridge.callByte(\"" + signature + "\", "
                        + thiz
                        + ", $args); } ");
                break;
            case "float":
                m.setBody("{ return de.mobilej.ABridge.callFloat(\"" + signature + "\", "
                        + thiz
                        + ", $args); } ");
                break;
            case "double":
                m.setBody("{ return de.mobilej.ABridge.callDouble(\"" + signature + "\", "
                        + thiz
                        + ", $args); } ");
                break;
            default:
                m.setBody(
                        "{ return ($r)de.mobilej.ABridge.callObject(\"" + signature + "\","
                                + thiz + ", $args); } ");
                break;
        }
    }

    private static void process(CtClass clazz, List classMappings) throws Exception {

        if (clazz.isInterface()) {
            return;
        }

        clazz.defrost();

        clazz.setModifiers(clazz.getModifiers() | Modifier.PUBLIC);
        clazz.setModifiers(clazz.getModifiers() & ~Modifier.FINAL);
        clazz.setModifiers(clazz.getModifiers() & ~Modifier.PRIVATE);
        clazz.setModifiers(clazz.getModifiers() & ~Modifier.PROTECTED);

        CtMethod[] methods = clazz.getDeclaredMethods();

        for (CtMethod m : methods) {

            // we change native to normal method but need to
            // delegate
            if ((m.getModifiers() & Modifier.NATIVE) == Modifier.NATIVE) {
                delegateMethod(m);
            } else {
                instumentMethod(m);
            }

            m.setModifiers(m.getModifiers() | Modifier.PUBLIC);
            m.setModifiers(m.getModifiers() & ~Modifier.FINAL);
            m.setModifiers(m.getModifiers() & ~Modifier.PRIVATE);
            m.setModifiers(m.getModifiers() & ~Modifier.PROTECTED);
            m.setModifiers(m.getModifiers() & ~Modifier.NATIVE);

        }


        for (ClassMapping mapping : classMappings) {
            clazz.replaceClassName(mapping.from, mapping.to);
        }
    }

    private static void instumentMethod(CtMethod m) throws CannotCompileException {
        m.instrument(new ExprEditor() {
            public void edit(MethodCall m) throws CannotCompileException {
                // special handling for System.arrraycopy and VMRuntime
                if (m.getClassName().equals("java.lang.System") && m.getMethodName().equals("arraycopy")) {
                    m.replace("{java.lang.System.arraycopy($1,$2,$3,$4,$5);}");
                } else if (m.getClassName().equals("dalvik.system.VMRuntime") && m.getMethodName().equals("newUnpaddedArray")) {
                    m.replace("{$_ = java.lang.reflect.Array.newInstance($1,$2);}");
                } else if (m.getClassName().equals("dalvik.system.VMRuntime") && m.getMethodName().equals("getRuntime")) {
                    m.replace("{$_ = null;}");
                }
            }
        });
    }

    public static boolean delete(File file) {
        File[] flist = null;

        if (file == null) {
            return false;
        }

        if (file.isFile()) {
            return file.delete();
        }

        if (!file.isDirectory()) {
            return false;
        }

        flist = file.listFiles();
        if (flist != null && flist.length > 0) {
            for (File f : flist) {
                if (!delete(f)) {
                    return false;
                }
            }
        }

        return file.delete();
    }

    public static class ClassMapping {
        public final String from;
        public final String to;

        public ClassMapping(String from, String to) {
            this.from = from;
            this.to = to;
        }
    }
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy