soot.toDex

Class DexPrinter

java.lang.Object

soot.toDex.DexPrinter

public class DexPrinter
extends Object

Creates apk or jar file with compiled dex classes. Main entry point for the "dex" output format.

Use add(SootClass) to add classes that should be printed as dex output and print() to finally print the classes.

If the printer has found the original APK of an added class (via SourceLocator.dexClassIndex()), the files in the APK are copied to a new one, replacing it's classes.dex and excluding the signature files. Note that you have to sign and align the APK yourself, with jarsigner and zipalign, respectively.

If Options.output_jar flag is set, the printer produces JAR file.

If there is no original APK and Options.output_jar flag is not set the printer just emits a classes.dex.

See Also:

jarsigner documentation, zipalign documentation

Field Summary

Fields

Modifier and Type	Field and Description
protected MultiDexBuilder	dexBuilder
protected File	originalApk
static Pattern	SIGNATURE_FILE_PATTERN

Constructor Summary

Constructors

Constructor and Description
DexPrinter()

Method Summary

Modifier and Type	Method and Description
void	add(SootClass c)
protected StmtVisitor	buildStmtVisitor(SootMethod belongingMethod, DexArrayInitDetector arrayInitDetector) Creates a statement visitor to build code for each statement.
protected MultiDexBuilder	createDexBuilder() Creates the MultiDexBuilder that shall be used for creating potentially multiple dex files.
void	print()
protected static org.jf.dexlib2.iface.reference.FieldReference	toFieldReference(SootField f)
protected static org.jf.dexlib2.iface.reference.FieldReference	toFieldReference(SootFieldRef ref)
protected static org.jf.dexlib2.iface.reference.MethodReference	toMethodReference(SootMethodRef m)
static org.jf.dexlib2.iface.reference.TypeReference	toTypeReference(Type t)
protected void	writeMemberClasses(SootClass c, Set<String> skipList, Set<org.jf.dexlib2.iface.Annotation> annotations)
protected void	writeTagsForStatement(org.jf.dexlib2.builder.MethodImplementationBuilder builder, Stmt stmt) Writes out the information stored in the tags associated with the given statement

Methods inherited from class java.lang.Object

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

Field Detail

SIGNATURE_FILE_PATTERN

public static final Pattern SIGNATURE_FILE_PATTERN

dexBuilder

protected MultiDexBuilder dexBuilder

originalApk

protected File originalApk

Constructor Detail

DexPrinter

public DexPrinter()

Method Detail

createDexBuilder

protected MultiDexBuilder createDexBuilder()

Creates the MultiDexBuilder that shall be used for creating potentially multiple dex files. This method makes sure that users of Soot can overwrite the MultiDexBuilder with custom strategies.

Returns:

The new MultiDexBuilder

toFieldReference

protected static org.jf.dexlib2.iface.reference.FieldReference toFieldReference(SootField f)

toFieldReference

protected static org.jf.dexlib2.iface.reference.FieldReference toFieldReference(SootFieldRef ref)

toMethodReference

protected static org.jf.dexlib2.iface.reference.MethodReference toMethodReference(SootMethodRef m)

toTypeReference

public static org.jf.dexlib2.iface.reference.TypeReference toTypeReference(Type t)

writeMemberClasses

protected void writeMemberClasses(SootClass c,
                                  Set<String> skipList,
                                  Set<org.jf.dexlib2.iface.Annotation> annotations)

buildStmtVisitor

protected StmtVisitor buildStmtVisitor(SootMethod belongingMethod,
                                       DexArrayInitDetector arrayInitDetector)

Creates a statement visitor to build code for each statement. Allows subclasses to use own implementations

Parameters:

belongingMethod - the method

arrayInitDetector - auxilliary class for detecting array initializations

Returns:

the statement visitor

writeTagsForStatement

protected void writeTagsForStatement(org.jf.dexlib2.builder.MethodImplementationBuilder builder,
                                     Stmt stmt)

Writes out the information stored in the tags associated with the given statement

Parameters:

builder - The builder used to generate the Dalvik method implementation

stmt - The statement for which to write out the tags

add

public void add(SootClass c)

print

public void print()