古めのAndroidバージョンをサポートしたままJava 8+ APIを使う方法

今さらcore library desugaring知った話

Android Kotlin Java Gradle java.time

Created at 2021-02-08 00:30

AndroidのAPIレベルとJavaバージョン

Androidの最小APIレベルを低めに設定している場合、そのままでは Java 8 言語機能を利用できず、Java 7 言語機能を使用するために使用できる言語機能に制限がかかる場合がある。

たとえば、日時情報を扱うjava.timeに含まれるLocalDateTimeとかZonedDateTimeとかのクラスは最小APIレベル26以上に設定しなければそのままでは使用できない。

この場合 ThreeTen Android Backport などのバックポートライブラリを使用するなどして対応することができるが、用途をAndroidに限らないライブラリを作って使いたい場合などに話がややこしくなる。

じゃあAndroid専用ではない ThreeTen backport を使用すればいいかというと、これはこれでAndroid上で動かす場合にタイムゾーン情報の扱いに関して極めて非効率なところがあるという¹。

Android Gradle プラグイン 4 以上での解決方法

Android Gradle プラグイン 4.0.0以上を使用している場合、次のようにbuild.gradle(appレベル)を記述することで最小APIレベルが小さくても Java 8 の言語機能を使用することができるようになる。

android {
    ~~ 他省略 ~~

    defaultConfig {
        // minSdkVersionが20以下なら必要
        multiDexEnabled true
    }

    compileOptions {
        // Flag to enable support for the new language APIs
        coreLibraryDesugaringEnabled true

        // Sets Java compatibility to Java 8
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

dependencies {
    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:1.1.1'

    ~~ 他省略 ~~
}

Java 8 言語機能と API を使用する | Android デベロッパー | Android Developers

desugar で使用可能な Java 8+ API | Android デベロッパー | Android Developers

Android Gradle プラグイン 4.0.0がリリースされたのが2020年4月なので、ほぼ一年気づいていなかったというアンテナの低さを露呈しているわけだが。

余談 kotlinx-datetime

さらにKotlin使っていてJVMに限らないマルチプラットフォーム対応で日時情報を扱いたい場合、Kotlin 1.4.0以降なら次のようなライブラリが開発されているらしい。
これもminSDKVersionが小さいAndroidアプリに組み込む場合先述のcore library desugaringが必要となる。

JSやNativeを考慮せず単にJVM上で動けばいいだけのものなら中身はただjava.timeっぽいので、特別何か嬉しいことがある訳ではなさそうだが、一応。