com.android.dex

Class Dex

java.lang.Object

com.android.dex.Dex

public final class Dex
extends java.lang.Object

The bytes of a dex file in memory for reading and writing. All int offsets are unsigned.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	Dex.Section

Constructor Summary

Constructors

Constructor and Description
Dex(byte[] data) Creates a new dex that reads from data.
Dex(java.io.File file) Creates a new dex buffer from the dex file file.
Dex(java.io.InputStream in) Creates a new dex buffer of the dex in in, and closes in.
Dex(int byteCount) Creates a new empty dex of the specified size.

Method Summary

Modifier and Type	Method and Description
Dex.Section	appendSection(int maxByteCount, java.lang.String name)
java.lang.Iterable<ClassDef>	classDefs()
int	computeChecksum() Returns the checksum of all but the first 12 bytes of dex.
byte[]	computeSignature() Returns the signature of all but the first 32 bytes of this dex.
int	descriptorIndexFromTypeIndex(int typeIndex) Look up a descriptor index from a type index.
java.util.List<FieldId>	fieldIds()
byte[]	getBytes() Returns a copy of the the bytes of this dex.
int	getLength()
int	getNextSectionStart()
TableOfContents	getTableOfContents()
java.util.List<MethodId>	methodIds()
Dex.Section	open(int position)
java.util.List<ProtoId>	protoIds()
ClassData	readClassData(ClassDef classDef)
Code	readCode(ClassData.Method method)
TypeList	readTypeList(int offset)
java.util.List<java.lang.String>	strings()
java.util.List<java.lang.Integer>	typeIds()
java.util.List<java.lang.String>	typeNames()
void	writeHashes() Generates the signature and checksum of the dex file out and writes them to the file.
void	writeTo(java.io.File dexOut)
void	writeTo(java.io.OutputStream out)

Methods inherited from class java.lang.Object

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

Constructor Detail

Dex

public Dex(byte[] data)
    throws java.io.IOException

Creates a new dex that reads from data. It is an error to modify data after using it to create a dex buffer.

Throws:

java.io.IOException

Dex

public Dex(int byteCount)
    throws java.io.IOException

Creates a new empty dex of the specified size.

Throws:

java.io.IOException

Dex

public Dex(java.io.InputStream in)
    throws java.io.IOException

Creates a new dex buffer of the dex in in, and closes in.

Throws:

java.io.IOException

Dex

public Dex(java.io.File file)
    throws java.io.IOException

Creates a new dex buffer from the dex file file.

Throws:

java.io.IOException

Method Detail

writeTo

public void writeTo(java.io.OutputStream out)
             throws java.io.IOException

Throws:

java.io.IOException

writeTo

public void writeTo(java.io.File dexOut)
             throws java.io.IOException

Throws:

java.io.IOException

getTableOfContents

public TableOfContents getTableOfContents()

open

public Dex.Section open(int position)

appendSection

public Dex.Section appendSection(int maxByteCount,
                                 java.lang.String name)

getLength

public int getLength()

getNextSectionStart

public int getNextSectionStart()

getBytes

public byte[] getBytes()

Returns a copy of the the bytes of this dex.

strings

public java.util.List<java.lang.String> strings()

typeIds

public java.util.List<java.lang.Integer> typeIds()

typeNames

public java.util.List<java.lang.String> typeNames()

protoIds

public java.util.List<ProtoId> protoIds()

fieldIds

public java.util.List<FieldId> fieldIds()

methodIds

public java.util.List<MethodId> methodIds()

classDefs

public java.lang.Iterable<ClassDef> classDefs()

readTypeList

public TypeList readTypeList(int offset)

readClassData

public ClassData readClassData(ClassDef classDef)

readCode

public Code readCode(ClassData.Method method)

computeSignature

public byte[] computeSignature()
                        throws java.io.IOException

Returns the signature of all but the first 32 bytes of this dex. The first 32 bytes of dex files are not specified to be included in the signature.

Throws:

java.io.IOException

computeChecksum

public int computeChecksum()
                    throws java.io.IOException

Returns the checksum of all but the first 12 bytes of dex.

Throws:

java.io.IOException

writeHashes

public void writeHashes()
                 throws java.io.IOException

Generates the signature and checksum of the dex file out and writes them to the file.

Throws:

java.io.IOException

descriptorIndexFromTypeIndex

public int descriptorIndexFromTypeIndex(int typeIndex)

Look up a descriptor index from a type index. Cheaper than: open(tableOfContents.typeIds.off + (index * SizeOf.TYPE_ID_ITEM)).readInt();