com.android.builder.dexing

Class DexArchiveBuilder

java.lang.Object

com.android.builder.dexing.DexArchiveBuilder

public abstract class DexArchiveBuilder
extends java.lang.Object

An abstract dex archive builder that converts input class files to dex files that are written to dex archive. This class contains the logic for reading the class files from the input, ClassFileInput, and writing the output to a DexArchive. Implementation of conversion from the class files to dex files is left to the sub-classes. To trigger the conversion, create an instance of this class, and invoke convert(Stream, Path, boolean).

Constructor Summary

Constructors

Constructor and Description
DexArchiveBuilder()

Method Summary

Modifier and Type	Method and Description
abstract void	convert(java.util.stream.Stream<ClassFileEntry> input, java.nio.file.Path output, boolean isIncremental) Converts the specified input, and writes it to the output dex archive.
static DexArchiveBuilder	createD8DexBuilder(int minSdkVersion, boolean isDebug, java.util.List<java.nio.file.Path> bootClasspath, java.util.List<java.nio.file.Path> classpath, ClassFileProviderFactory providerFactory, boolean desugaring, com.android.ide.common.blame.MessageReceiver messageReceiver) Creates an instance that is using d8 to convert class files to dex files.
static DexArchiveBuilder	createDxDexBuilder(DexArchiveBuilderConfig config) Creates an instance that is using dx to convert class files to dex files.

Methods inherited from class java.lang.Object

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

Constructor Detail

DexArchiveBuilder

public DexArchiveBuilder()

Method Detail

createDxDexBuilder

@NonNull
public static DexArchiveBuilder createDxDexBuilder(@NonNull
                                                            DexArchiveBuilderConfig config)

Creates an instance that is using dx to convert class files to dex files.

createD8DexBuilder

@NonNull
public static DexArchiveBuilder createD8DexBuilder(int minSdkVersion,
                                                            boolean isDebug,
                                                            @NonNull
                                                            java.util.List<java.nio.file.Path> bootClasspath,
                                                            @NonNull
                                                            java.util.List<java.nio.file.Path> classpath,
                                                            @Nonnull
                                                            ClassFileProviderFactory providerFactory,
                                                            boolean desugaring,
                                                            @NonNull
                                                            com.android.ide.common.blame.MessageReceiver messageReceiver)

Creates an instance that is using d8 to convert class files to dex files.

convert

public abstract void convert(@NonNull
                             java.util.stream.Stream<ClassFileEntry> input,
                             @NonNull
                             java.nio.file.Path output,
                             boolean isIncremental)
                      throws DexArchiveBuilderException

Converts the specified input, and writes it to the output dex archive. If dex archive does not exist, it will be created. If it exists, entries will be added or replaced.

Throws:

DexArchiveBuilderException