com.android.builder.core

Class JackToolchain

java.lang.Object

com.android.builder.core.JackToolchain

public class JackToolchain
extends java.lang.Object

Features exposed by the Jack toolchain. This is used for invoking Jack to convert inputs (source code, jars etc.) to Jack library format, or .dex. Besides Jack, one is also able to use Jill to convert Java libraries (.jar) to Jack library format. Both Jack and Jill support conversions in the current, or the separate process.

Jack is used for processing java libraries that are packaged in the final apk, and also for the source compilation. It can produce Jack library format or .dex files.

Jill is used for processing classpath libraries (these are not in the final apk). It accepts .jar file as input, and produces Jack library format as output. E.g. we are using Jill to convert android.jar to android.jack. This .jack library is later on added to the classpath when compiling the sources.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JackToolchain.ToolchainException Jack toolchain exception.

Constructor Summary

Constructors

Constructor and Description
JackToolchain(com.android.sdklib.BuildToolInfo buildToolInfo, com.android.utils.ILogger logger, ErrorReporter errorReporter)

Method Summary

Modifier and Type	Method and Description
void	convert(JackProcessOptions options, com.android.ide.common.process.JavaProcessExecutor javaProcessExecutor, boolean isInProcess) Converts Java source code or Java byte code into android byte code or Jack library format using the Jack toolchain.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JackToolchain

public JackToolchain(@NonNull
                     com.android.sdklib.BuildToolInfo buildToolInfo,
                     @NonNull
                     com.android.utils.ILogger logger,
                     @NonNull
                     ErrorReporter errorReporter)

Method Detail

convert

public void convert(@NonNull
                    JackProcessOptions options,
                    @NonNull
                    com.android.ide.common.process.JavaProcessExecutor javaProcessExecutor,
                    boolean isInProcess)
             throws JackToolchain.ToolchainException,
                    com.android.ide.common.process.ProcessException,
                    java.lang.ClassNotFoundException,
                    java.io.IOException

Converts Java source code or Java byte code into android byte code or Jack library format using the Jack toolchain. It accepts source files, .jar or .jack as inputs, and produces .jack or .dex files as outputs.

Parameters:

options - options for configuring Jack.

javaProcessExecutor - java executor to be used for out of process execution

isInProcess - whether to run Jack in memory or spawn another Java process.

Throws:

JackToolchain.ToolchainException - if there is an exception related to running Jack toolchain

com.android.ide.common.process.ProcessException - if a process in which the conversion is run fails

java.lang.ClassNotFoundException - if running in process, and unable to load the classes required for the conversion

java.io.IOException