xref: /aosp_15_r20/dalvik/tools/dexdeps/README.txt (revision 055d459012065f78d96b68be8421640240ddf631)
1*055d4590SKeyi Guidexdeps -- DEX external dependency dump
2*055d4590SKeyi Gui
3*055d4590SKeyi Gui
4*055d4590SKeyi GuiThis tool dumps a list of fields and methods that a DEX file uses but does
5*055d4590SKeyi Guinot define.  When combined with a list of public APIs, it can be used to
6*055d4590SKeyi Guidetermine whether an APK is accessing fields and calling methods that it
7*055d4590SKeyi Guishouldn't be.  It may also be useful in determining whether an application
8*055d4590SKeyi Guirequires a certain minimum API level to execute.
9*055d4590SKeyi Gui
10*055d4590SKeyi GuiBasic usage:
11*055d4590SKeyi Gui
12*055d4590SKeyi Gui  dexdeps [options] <file.{dex,apk,jar}> ...
13*055d4590SKeyi Gui
14*055d4590SKeyi GuiFor zip archives (including .jar and .apk), dexdeps will look for a
15*055d4590SKeyi Gui"classes.dex" entry.
16*055d4590SKeyi Gui
17*055d4590SKeyi GuiSupported options are:
18*055d4590SKeyi Gui
19*055d4590SKeyi Gui  --format={brief,xml}
20*055d4590SKeyi Gui
21*055d4590SKeyi Gui    Specifies the output format.
22*055d4590SKeyi Gui
23*055d4590SKeyi Gui    "brief" produces one line of output for each field and method.  Field
24*055d4590SKeyi Gui    and argument types are shown as descriptor strings.
25*055d4590SKeyi Gui
26*055d4590SKeyi Gui    "xml" produces a larger output file, readable with an XML browser.  Types
27*055d4590SKeyi Gui    are shown in a more human-readable form (e.g. "[I" becomes "int[]").
28*055d4590SKeyi Gui
29*055d4590SKeyi Gui  --just-classes
30*055d4590SKeyi Gui
31*055d4590SKeyi Gui    Indicates that output should only include a list of classes, as
32*055d4590SKeyi Gui    opposed to also listing fields and methods.
33