[Realm/Android] DexArchiveBuilderException / Invoke-customs are only supported starting with Android O の対処法

モバイル用軽量データベース「Realm」を使ったプロジェクトを回したときに、こんな感じの４点セットのエラーが表示されてビルドが回らなくなる場合の対処法です。

java compiler: (4 errors)	
com.android.builder.dexing.DexArchiveBuilderException: Failed to process C:Users***.gradlecachestransforms-1files-1.1realm-android-library-5.8.0.aar645a5a6b1c9632c307cc325eabc44c60jarsclasses.jar	
com.android.builder.dexing.DexArchiveBuilderException: Error while dexing.	
com.android.tools.r8.CompilationFailedException: Compilation failed to complete	
com.android.tools.r8.utils.AbortException: Error: Invoke-customs are only supported starting with Android O (--min-api 26)	

RealmのライブラリでJava8の機能を使っていたことが原因

（参考にさせてもらったサイト）

Error: Invoke-customs are only supported starting with Android O · Issue #6300 · realm/realm-java

Goal Cannot build realm with 5.8.0 Actual Results Error: Invoke-customs are only supported starting with Android O (--min-api 26) Steps & Code to Reproduce Version of Realm and tooling Realm versio...

このサイトでRealmの（おそらく）中の人が言っているように、原因はRealmのバージョン5.8.0のライブラリのコードで、Java8の言語機能（ラムダ式）を使ったことによるものだそうです。

RealmのライブラリのコードはKotlinのお父さんであるJavaによって書かれています。

その中でラムダ式という機能を使っているのですが、Kotlinの場合はラムダ式は最初からあって普通に使える機能ですが、Javaでは比較的最近のバージョン「8」から出てきた機能で、かつAndroid StudioはJavaのバージョン8は標準ではサポートしていません。

ですので、Java8の言語機能を使えるようにするためには、アプリケーションレベルのbuild.gradleで設定をしてあげる必要があるということです。

Java 8 言語機能と API を使用する  |  Android Studio  |  Android Developers

利用可能な Java 8 言語機能、それを利用するためのプロジェクトの適切な設定方法、そして遭遇する可能性がある既知の問題について学びます。

android {
  ...
  // Configure only for each module that uses Java 8
  // language features (either in its source code or
  // through dependencies).
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
  }
}

（くわしくは下の動画で解説していますので、よろしければご覧下さい）