Multi-dex reading and writing.
Optional management of the content of the main dex file when writing multi-dex.
Simplified read/write access to multi-dex containers as plain-old dexlib2 DexFile objects, making it trivial to add multi-dex support to existing non-multi-dex-aware dexlib2 clients.
Faster dex reads than plain dexlib2.
Optional multi-threaded multi-dex writes that deliver greatly increased write performance.
Automatic management of dex version, dex opcodes, and API level.
Configurable naming of multi-dex member files.
Progress logging to a client-provided logger.

Limitations:

Only supports dex files. (Does not support odex/oat files.)
Only writes dex files to directories. (Does not write into zip files.)

DISTRIBUTION

Releases of multidexlib2 are distributed with coordinates com.github.lanchon.dexpatcher:multidexlib2 through the Maven Central Repository, with version numbers starting at 2.2.0 and matching the version of dexlib2 they were built against. Release changelog is available here.

USAGE

Interface:

MultiDexIO: read and write potentially multi-dex containers.
- readDexFile(): read potentially multi-dex container and return a single, merged DexFile.
- readMultiDexContainer(): read potentially multi-dex container and return a MultiDexContainer.
- writeDexFile(): write potentially multi-dex container from a single DexFile.
RawDexIO: read and write single dex files (supersedes invoking dexlib2 directly).

Parameters:

boolean multiDex: true to enable multi-dex support.
File file: file or directory to read or write.
DexFileNamer namer: set to new BasicDexFileNamer().
Opcodes opcodes: null to auto-detect.
int maxDexPoolSize: set to DexIO.DEFAULT_MAX_DEX_POOL_SIZE.
int threadCount: thread count for multi-threaded multi-dex writes.
- 1 to force single-threaded writes.
- 0 to auto-detect optimum thread count.
int minMainDexClassCount, boolean minimalMainDex: main dex file content management.
- 0, false to disable main dex management.
DexIO.Logger logger: null to disable logging.

Sample:

DexPatcher's file processor is a simple yet production-quality client of multidexlib2.