IssueTracker

There's multiple declarations in the public API of the Android Gradle plugin that changed as of version 4.1.0-alpha09 in a way that source compatibility is broken.

The common issue that these declarations have is being both a mutable collection (e.g. MutableList or MutableMap), and being exposed as a var.

(Note that this issue is similar to that one that has a fix that should be released in AGP 4.1.0-alpha10, and it is possible that this issue got fixed in the way.)

Previously, they were declared as a java collection, so assigning a non mutable collection was possible was possible as shown below:

android {
    defaultConfig {
        javaCompileOptions {
            annotationProcessorOptions {
                arguments = mapOf("someKey" to "someValue") // Ok in AGP 3.6.x
            }
        }
    }
}

On AGP 4.1.0-alpha09, this fails because you're assigning a non mutable collection instance to a mutable collection type.

Instinctively, you add a + sign before the assignment operator (=), but that fails too as the declaration is both variable and mutable, which is also dangerous in case multiple parts in code want to change it.

It seems breaking no one is impossible there, so a choice needs to be made.

Here are 2 solutions:

1. Make the collections mutable but the declaration read-only (val)
2. Make the collections immutable, and keep the declaration variable (var)

The option 1 is slightly safer because you can add without unintentionally clear content previously added. The option 2 can allow adding without removing any previous content if += is used instead of =, and is maybe more likely to break less users as the snippet shown above would keep working, and similar code in Groovy DSL would work as well.

I think I'd vote more for option 2, but please, pick one of these so we can use +=.

Tip: You can perform a "Find in Path" (ctrl/cmd + shift + F) in the IDE in the com.android.build.api package, looking for Mutable, display them in a tool window, and fix them all to option 1 or 2.