baksmali.java revision 343df2f456f38c305ee7d6742f6601d9bde09715
1/* 2 * [The "BSD licence"] 3 * Copyright (c) 2010 Ben Gruver (JesusFreke) 4 * All rights reserved. 5 * 6 * Redistribution and use in source and binary forms, with or without 7 * modification, are permitted provided that the following conditions 8 * are met: 9 * 1. Redistributions of source code must retain the above copyright 10 * notice, this list of conditions and the following disclaimer. 11 * 2. Redistributions in binary form must reproduce the above copyright 12 * notice, this list of conditions and the following disclaimer in the 13 * documentation and/or other materials provided with the distribution. 14 * 3. The name of the author may not be used to endorse or promote products 15 * derived from this software without specific prior written permission. 16 * 17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 18 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 19 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 20 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 22 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 25 * INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 27 */ 28 29package org.jf.baksmali; 30 31import org.jf.baksmali.Adaptors.ClassDefinition; 32import org.jf.dexlib.ClassDefItem; 33import org.jf.dexlib.Code.Analysis.*; 34import org.jf.dexlib.DexFile; 35import org.jf.util.ClassFileNameHandler; 36import org.jf.util.IndentingWriter; 37 38import java.io.*; 39import java.util.ArrayList; 40import java.util.Collections; 41import java.util.Comparator; 42import java.util.regex.Matcher; 43import java.util.regex.Pattern; 44 45public class baksmali { 46 public static boolean noParameterRegisters = false; 47 public static boolean useLocalsDirective = false; 48 public static boolean useSequentialLabels = false; 49 public static boolean outputDebugInfo = true; 50 public static boolean addCodeOffsets = false; 51 public static boolean noAccessorComments = false; 52 public static boolean deodex = false; 53 public static boolean verify = false; 54 public static InlineMethodResolver inlineResolver = null; 55 public static int registerInfo = 0; 56 public static String bootClassPath; 57 58 public static SyntheticAccessorResolver syntheticAccessorResolver = null; 59 60 public static void disassembleDexFile(String dexFilePath, DexFile dexFile, boolean deodex, String outputDirectory, 61 String[] classPathDirs, String bootClassPath, String extraBootClassPath, 62 boolean noParameterRegisters, boolean useLocalsDirective, 63 boolean useSequentialLabels, boolean outputDebugInfo, boolean addCodeOffsets, 64 boolean noAccessorComments, int registerInfo, boolean verify, 65 boolean ignoreErrors, String inlineTable) 66 { 67 baksmali.noParameterRegisters = noParameterRegisters; 68 baksmali.useLocalsDirective = useLocalsDirective; 69 baksmali.useSequentialLabels = useSequentialLabels; 70 baksmali.outputDebugInfo = outputDebugInfo; 71 baksmali.addCodeOffsets = addCodeOffsets; 72 baksmali.noAccessorComments = noAccessorComments; 73 baksmali.deodex = deodex; 74 baksmali.registerInfo = registerInfo; 75 baksmali.bootClassPath = bootClassPath; 76 baksmali.verify = verify; 77 78 if (registerInfo != 0 || deodex || verify) { 79 try { 80 String[] extraBootClassPathArray = null; 81 if (extraBootClassPath != null && extraBootClassPath.length() > 0) { 82 assert extraBootClassPath.charAt(0) == ':'; 83 extraBootClassPathArray = extraBootClassPath.substring(1).split(":"); 84 } 85 86 if (dexFile.isOdex() && bootClassPath == null) { 87 //ext.jar is a special case - it is typically the 2nd jar in the boot class path, but it also 88 //depends on classes in framework.jar (typically the 3rd jar in the BCP). If the user didn't 89 //specify a -c option, we should add framework.jar to the boot class path by default, so that it 90 //"just works" 91 if (extraBootClassPathArray == null && isExtJar(dexFilePath)) { 92 extraBootClassPathArray = new String[] {"framework.jar"}; 93 } 94 ClassPath.InitializeClassPathFromOdex(classPathDirs, extraBootClassPathArray, dexFilePath, dexFile); 95 } else { 96 String[] bootClassPathArray = null; 97 if (bootClassPath != null) { 98 bootClassPathArray = bootClassPath.split(":"); 99 } 100 ClassPath.InitializeClassPath(classPathDirs, bootClassPathArray, extraBootClassPathArray, 101 dexFilePath, dexFile); 102 } 103 104 if (inlineTable != null) { 105 inlineResolver = new CustomInlineMethodResolver(inlineTable); 106 } 107 } catch (Exception ex) { 108 System.err.println("\n\nError occured while loading boot class path files. Aborting."); 109 ex.printStackTrace(System.err); 110 System.exit(1); 111 } 112 } 113 114 File outputDirectoryFile = new File(outputDirectory); 115 if (!outputDirectoryFile.exists()) { 116 if (!outputDirectoryFile.mkdirs()) { 117 System.err.println("Can't create the output directory " + outputDirectory); 118 System.exit(1); 119 } 120 } 121 122 if (!noAccessorComments) { 123 syntheticAccessorResolver = new SyntheticAccessorResolver(dexFile); 124 } 125 126 //sort the classes, so that if we're on a case-insensitive file system and need to handle classes with file 127 //name collisions, then we'll use the same name for each class, if the dex file goes through multiple 128 //baksmali/smali cycles for some reason. If a class with a colliding name is added or removed, the filenames 129 //may still change of course 130 ArrayList<ClassDefItem> classDefItems = new ArrayList<ClassDefItem>(dexFile.ClassDefsSection.getItems()); 131 Collections.sort(classDefItems, new Comparator<ClassDefItem>() { 132 public int compare(ClassDefItem classDefItem1, ClassDefItem classDefItem2) { 133 return classDefItem1.getClassType().getTypeDescriptor().compareTo(classDefItem1.getClassType().getTypeDescriptor()); 134 } 135 }); 136 137 ClassFileNameHandler fileNameHandler = new ClassFileNameHandler(outputDirectoryFile, ".smali"); 138 139 for (ClassDefItem classDefItem: classDefItems) { 140 /** 141 * The path for the disassembly file is based on the package name 142 * The class descriptor will look something like: 143 * Ljava/lang/Object; 144 * Where the there is leading 'L' and a trailing ';', and the parts of the 145 * package name are separated by '/' 146 */ 147 148 String classDescriptor = classDefItem.getClassType().getTypeDescriptor(); 149 150 //validate that the descriptor is formatted like we expect 151 if (classDescriptor.charAt(0) != 'L' || 152 classDescriptor.charAt(classDescriptor.length()-1) != ';') { 153 System.err.println("Unrecognized class descriptor - " + classDescriptor + " - skipping class"); 154 continue; 155 } 156 157 File smaliFile = fileNameHandler.getUniqueFilenameForClass(classDescriptor); 158 159 //create and initialize the top level string template 160 ClassDefinition classDefinition = new ClassDefinition(classDefItem); 161 162 //write the disassembly 163 Writer writer = null; 164 try 165 { 166 File smaliParent = smaliFile.getParentFile(); 167 if (!smaliParent.exists()) { 168 if (!smaliParent.mkdirs()) { 169 System.err.println("Unable to create directory " + smaliParent.toString() + " - skipping class"); 170 continue; 171 } 172 } 173 174 if (!smaliFile.exists()){ 175 if (!smaliFile.createNewFile()) { 176 System.err.println("Unable to create file " + smaliFile.toString() + " - skipping class"); 177 continue; 178 } 179 } 180 181 BufferedWriter bufWriter = new BufferedWriter(new OutputStreamWriter( 182 new FileOutputStream(smaliFile), "UTF8")); 183 184 writer = new IndentingWriter(bufWriter); 185 classDefinition.writeTo((IndentingWriter)writer); 186 } catch (Exception ex) { 187 System.err.println("\n\nError occured while disassembling class " + classDescriptor.replace('/', '.') + " - skipping class"); 188 ex.printStackTrace(); 189 smaliFile.delete(); 190 } 191 finally 192 { 193 if (writer != null) { 194 try { 195 writer.close(); 196 } catch (Throwable ex) { 197 System.err.println("\n\nError occured while closing file " + smaliFile.toString()); 198 ex.printStackTrace(); 199 } 200 } 201 } 202 203 if (!ignoreErrors && classDefinition.hadValidationErrors()) { 204 System.exit(1); 205 } 206 } 207 } 208 209 private static final Pattern extJarPattern = Pattern.compile("(?:^|\\\\|/)ext.(?:jar|odex)$"); 210 private static boolean isExtJar(String dexFilePath) { 211 Matcher m = extJarPattern.matcher(dexFilePath); 212 return m.find(); 213 } 214} 215