desugar

Standalone version of Android's desugar tool that works for both Android and JRE

Notes

To allow for easier updates, the command line arguments are preserved from the original tool. This means the --min_sdk_version argument expects an Android version. Please see the following table for the corresponding JRE versions.

Usage

.\bin\desugar.bat
bin/desugar

  --[no]allow_empty_bootclasspath (a boolean; default: "false")
  --[no]best_effort_tolerate_missing_deps (a boolean; default: "true")
    Whether to tolerate missing dependencies on the classpath in some cases.
    You should strive to set this flag to false.
  --bootclasspath_entry (a valid filesystem path; may be used multiple times)
    Bootclasspath that was used to compile the --input Jar with, like javac's -
    bootclasspath flag (required).
  --classpath_entry (a valid filesystem path; may be used multiple times)
    Ordered classpath (Jar or directory) to resolve symbols in the --input Jar,
    like javac's -cp flag.
  --[no]copy_bridges_from_classpath (a boolean; default: "false")
    Copy bridges from classpath to desugared classes.
  --[no]core_library (a boolean; default: "false")
    Enables rewriting to desugar java.* classes.
  --[no]desugar_interface_method_bodies_if_needed (a boolean; default: "true")
    Rewrites default and static methods in interfaces if --min_sdk_version <
    24. This only works correctly if subclasses of rewritten interfaces as well
    as uses of static interface methods are run through this tool as well.
  --[no]desugar_supported_core_libs (a boolean; default: "false")
    Enable core library desugaring, which requires configuration with related
    flags.
  --[no]desugar_try_with_resources_if_needed (a boolean; default: "true")
    Rewrites try-with-resources statements if --min_sdk_version < 19.
  --[no]desugar_try_with_resources_omit_runtime_classes (a boolean; default: "false")
    Omits the runtime classes necessary to support try-with-resources from the
    output. This property has effect only if --
    desugar_try_with_resources_if_needed is used.
  --dont_rewrite_core_library_invocation (a string; may be used multiple times)
    Method invocations not to rewrite, given as "class/Name#method".
  --[no]emit_dependency_metadata_as_needed (a boolean; default: "false")
    Whether to emit META-INF/desugar_deps as needed for later consistency
    checking.
  --emulate_core_library_interface (a string; may be used multiple times)
    Assume the given java.* interfaces are emulated.
  --input [-i] (a valid filesystem path; may be used multiple times)
    Input Jar or directory with classes to desugar (required, the n-th input is
    paired withthe n-th output).
  --[no]legacy_jacoco_fix (a boolean; default: "false")
    Consider setting this flag if you're using JaCoCo versions prior to 0.7.9
    to work around issues with coverage instrumentation in default and static
    interface methods. This flag may be removed when no longer needed.
  --min_sdk_version (an integer; default: "19")
    Minimum targeted sdk version.  If >= 24, enables default methods in
    interfaces.
  --[no]only_desugar_javac9_for_lint (a boolean; default: "false")
    A temporary flag specifically for android lint, subject to removal anytime
    (DO NOT USE)
  --output [-o] (a valid filesystem path; may be used multiple times)
    Output Jar or directory to write desugared classes into (required, the n-th
    output is paired with the n-th input, output must be a Jar if input is a
    Jar).
  --retarget_core_library_member (a string; may be used multiple times)
    Method invocations to retarget, given as "class/Name#member-
    >new/class/Name".  The new owner is blindly assumed to exist.
  --[no]rewrite_calls_to_long_compare (a boolean; default: "false")
    Rewrite calls to Long.compare(long, long) to the JVM instruction lcmp
    regardless of --min_sdk_version.
  --rewrite_core_library_prefix (a string; may be used multiple times)
    Assume the given java.* prefixes are desugared.
  --[no]verbose [-v] (a boolean; default: "false")
    Enables verbose debugging output.

As Dependency

Gradle

compile "com.viridiansoftware:desugar:1.0.0"

Maven

<dependency>
    <groupId>com.viridiansoftware</groupId>
    <artifactId>desugar</artifactId>
    <version>1.0.0</version>
</dependency>