com.android.dex

Class DexFormat

java.lang.Object

com.android.dex.DexFormat

public final class DexFormat
extends java.lang.Object

Constants that show up in and are otherwise related to .dex files, and helper methods for same.

Field Summary

Fields

Modifier and Type	Field and Description
static int	API_CONST_METHOD_HANDLE API level to target in order to generate const-method-handle and const-method-type
static int	API_CURRENT API level to target in order to produce the most modern file format
static int	API_DEFINE_INTERFACE_METHODS API level to target in order to define default and static interface methods
static int	API_INVOKE_INTERFACE_METHODS API level to target in order to invoke default and static interface methods
static int	API_INVOKE_STATIC_INTERFACE_METHODS API level at which the invocation of static interface methods is permitted by dx.
static int	API_METHOD_HANDLES API level to target in order to generate invoke-polymorphic and invoke-custom
static int	API_NO_EXTENDED_OPCODES API level to target in order to suppress extended opcode usage
static int	API_SPACES_IN_SIMPLE_NAME API level to target in order to allow spaces in SimpleName
static java.lang.String	DEX_IN_JAR_NAME file name of the primary .dex file inside an application or library .jar file
static int	ENDIAN_TAG value used to indicate endianness of file contents
static java.lang.String	MAGIC_PREFIX common prefix for all dex file "magic numbers"
static java.lang.String	MAGIC_SUFFIX common suffix for all dex file "magic numbers"
static int	MAX_MEMBER_IDX Maximum addressable field or method index.
static int	MAX_TYPE_IDX Maximum addressable type index.
static java.lang.String	VERSION_CURRENT Dex file version number for dalvik.
static java.lang.String	VERSION_FOR_API_10000 dex file version number for API level 10000 and earlier
static java.lang.String	VERSION_FOR_API_13 dex file version number for API level 13 and earlier
static java.lang.String	VERSION_FOR_API_24 dex file version number for API level 24 and earlier
static java.lang.String	VERSION_FOR_API_26 dex file version number for API level 26 and earlier
static java.lang.String	VERSION_FOR_API_28 dex file version number for API level 28 and earlier

Method Summary

Modifier and Type	Method and Description
static java.lang.String	apiToMagic(int targetApiLevel) Returns the magic number corresponding to the given target API level.
static boolean	isSupportedDexMagic(byte[] magic) Checks whether a DEX file magic string is supported.
static int	magicToApi(byte[] magic) Returns the API level corresponding to the given magic number, or -1 if the given array is not a well-formed dex file magic number.

Methods inherited from class java.lang.Object

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

Field Detail

API_SPACES_IN_SIMPLE_NAME

public static final int API_SPACES_IN_SIMPLE_NAME

API level to target in order to allow spaces in SimpleName

See Also:

Constant Field Values

API_CONST_METHOD_HANDLE

public static final int API_CONST_METHOD_HANDLE

API level to target in order to generate const-method-handle and const-method-type

See Also:

Constant Field Values

API_METHOD_HANDLES

public static final int API_METHOD_HANDLES

API level to target in order to generate invoke-polymorphic and invoke-custom

See Also:

Constant Field Values

API_DEFINE_INTERFACE_METHODS

public static final int API_DEFINE_INTERFACE_METHODS

API level to target in order to define default and static interface methods

See Also:

Constant Field Values

API_INVOKE_INTERFACE_METHODS

public static final int API_INVOKE_INTERFACE_METHODS

API level to target in order to invoke default and static interface methods

See Also:

Constant Field Values

API_INVOKE_STATIC_INTERFACE_METHODS

public static final int API_INVOKE_STATIC_INTERFACE_METHODS

API level at which the invocation of static interface methods is permitted by dx. This value has been determined experimentally by testing on different VM versions.

See Also:

Constant Field Values

API_NO_EXTENDED_OPCODES

public static final int API_NO_EXTENDED_OPCODES

API level to target in order to suppress extended opcode usage

See Also:

Constant Field Values

API_CURRENT

public static final int API_CURRENT

API level to target in order to produce the most modern file format

See Also:

Constant Field Values

VERSION_FOR_API_10000

public static final java.lang.String VERSION_FOR_API_10000

dex file version number for API level 10000 and earlier

See Also:

Constant Field Values

VERSION_FOR_API_28

public static final java.lang.String VERSION_FOR_API_28

dex file version number for API level 28 and earlier

See Also:

Constant Field Values

VERSION_FOR_API_26

public static final java.lang.String VERSION_FOR_API_26

dex file version number for API level 26 and earlier

See Also:

Constant Field Values

VERSION_FOR_API_24

public static final java.lang.String VERSION_FOR_API_24

dex file version number for API level 24 and earlier

See Also:

Constant Field Values

VERSION_FOR_API_13

public static final java.lang.String VERSION_FOR_API_13

dex file version number for API level 13 and earlier

See Also:

Constant Field Values

VERSION_CURRENT

public static final java.lang.String VERSION_CURRENT

Dex file version number for dalvik.

Note: Dex version 36 was loadable in some versions of Dalvik but was never fully supported or completed and is not considered a valid dex file format.

See Also:

Constant Field Values

DEX_IN_JAR_NAME

public static final java.lang.String DEX_IN_JAR_NAME

file name of the primary .dex file inside an application or library .jar file

See Also:

Constant Field Values

MAGIC_PREFIX

public static final java.lang.String MAGIC_PREFIX

common prefix for all dex file "magic numbers"

See Also:

Constant Field Values

MAGIC_SUFFIX

public static final java.lang.String MAGIC_SUFFIX

common suffix for all dex file "magic numbers"

See Also:

Constant Field Values

ENDIAN_TAG

public static final int ENDIAN_TAG

value used to indicate endianness of file contents

See Also:

Constant Field Values

MAX_MEMBER_IDX

public static final int MAX_MEMBER_IDX

Maximum addressable field or method index. The largest addressable member is 0xffff, in the "instruction formats" spec as field@CCCC or meth@CCCC.

See Also:

Constant Field Values

MAX_TYPE_IDX

public static final int MAX_TYPE_IDX

Maximum addressable type index. The largest addressable type is 0xffff, in the "instruction formats" spec as type@CCCC.

See Also:

Constant Field Values

Method Detail

magicToApi

public static int magicToApi(byte[] magic)

Returns the API level corresponding to the given magic number, or -1 if the given array is not a well-formed dex file magic number.

Parameters:

magic - array of bytes containing DEX file magic string

Returns:

API level corresponding to magic string if valid, -1 otherwise.

apiToMagic

public static java.lang.String apiToMagic(int targetApiLevel)

Returns the magic number corresponding to the given target API level.

Parameters:

targetApiLevel - level of API (minimum supported value 13).

Returns:

Magic string corresponding to API level supplied.

isSupportedDexMagic

public static boolean isSupportedDexMagic(byte[] magic)

Checks whether a DEX file magic string is supported.

Parameters:

magic - string from DEX file

Returns: