Usage of dx --dex

Usage of dx --dex

USAGE

    dx --dex [ OPTIONS]  FILES...


OVERVIEW

    Convert Java class files into Dalvik dex format.


OPTIONS

     --

        Stops parsing options. Arguments after this are regarded as  FILES
        even if they start with "-". Note that parsing options is stopped
        also when an argument that does not start with "-" is found.

     --debug

    --verbose

    --verbose-dump

    --no-files

        Ignores input files. If this option is given,  FILES specified on
        the command line are ignored. To put it another way, if this
        option is not given,  FILES must be specified on the command line.

     --no-optimize

        Skips optimization on methods. The resultant dex file is not
        optimized but is generated speedily. See --optimize-list option.

     --no-strict

        Skips the following checks.

          1. Whether the format version of input class files are in the
             range which this dx command can handle.

          2. Whether path names of input class files match the declared
             package/class names.

     --core-library

        Allows classes under the following packages to be contained as
        input files. Note that javax sub packages that are not listed below
        can be contained without this option except classes which directly
        belong to javax package (e.g. javax.MyClass).

          java
          javax.accessibility
          javax.crypto
          javax.imageio
          javax.management
          javax.naming
          javax.net
          javax.print
          javax.rmi
          javax.security
          javax.sound
          javax.sql
          javax.swing
          javax.transaction
          javax.xml

     --statistics

    --optimize-list= FILE

        Specifies a file which contains a newline-separated list of method
        names. Methods listed in the file are optimized. Note that if this
        option is given, methods which are not explicitly listed are not
        optimized.

        This option and --no-optimize-list option are mutually exclusive.
        If neither of this option nor --no-optimize-list option is given,
        all methods are optimized by default unless --no-optimize option
        is given.

     --no-optimize-list= FILE

        Specifies a file which contains a newline-separated list of method
        names. Methods listed in the file are not optimized. Note that if
        this option is given, methods which are not explicitly listed are
        optimized.

        This option and --optimize-list option are mutually exclusive. If
        neither of this option nor --optimize-list option is given, all
        methods are optimized by default unless --no-optimize option is
        given.

     --keep-classes

        Adds input class files into the output dex file. Output files
        generated with this option contain both classes.dex file and
        .class files, so the size is larger than ones generated without
        this option, but such files can be used both on Dalvik VM and
        Java Standard Edition VM.

     --output= FILE

        Specifies the name of the output file. The extension of  FILE must
        be one of the following: ".zip", ".jar", ".apk" and ".dex". "-" is
        also allowed as  FILE and if it is specified, the output goes to the
        standard output.

     --dump-to= FILE

        Specifies where human-readable output should go. If --dump-method
        option is not given, the default value used when this option is
        not explicitly specified is "-" which means that human-readable
        output is written to the standard output.

     --dump-width= N

        Specifies the maximum width of the human-oriented output.  N must
        be equal to or greater than 40.

     --dump-method= METHOD

        Dumps information about a specified method in human-readable format.
        If this option is given, the normal dex output is not generated.

         METHOD is a fully-qualified method name. The last letter of  METHOD
        can be '*', and in such a case, '*' is regareded as a wildcard and
        all methods that match the pattern are dumped.

     --positions= POSITION

        Specifies how much position information should be preserved.
        Possible values of  POSTION and their meanings are as follows.
        The default value is "lines".

          "none"         No position information is preserved.

          "lines"        Line number information is preserved.

          "important"    Important position information is preserved.
                         This contains block starts and instructions
                         that might throw.

     --no-locals

        Discards information about local variables.


FILES

    Class files, jar files or directories which contain class files.