add breaking change for FlutterMain.setIsRunningInRobolectricTest removal

Author: xster

src/docs/release/breaking-changes/android-setIsRunningInRobolectricTest-removed.md

@@ -0,0 +1,60 @@
+---
+title: FlutterMain.setIsRunningInRobolectricTest on Android removed
+description: The test-only FlutterMain.setIsRunningInRobolectricTest API on
+the Android engine is consolidated into the FlutterInjector.
+---
+
+## Summary
+
+If you write Java JUnit tests (such as Robolectric tests) against the Flutter
+engine's Java embedding and used the
+`FlutterMain.setIsRunningInRobolectricTest(true)` API, replace it with
+`FlutterInjector.setInstance(new FlutterInjector.Builder().setShouldLoadNative(false).build())`.
+
+This should be very uncommon.
+
+## Context
+
+The `FlutterMain` class itself is being deprecated and replaced with the
+`FlutterInjector` class. The `FlutterMain` class itself used a number of
+static variables and functions than make it difficult to test. The
+`FlutterMain.setIsRunningInRobolectricTest()` is one ad-hoc static
+mechanism to allow tests to run on the host machine on JVM without
+loading the libflutter.so native library (which can't be done on the host
+machine).
+
+Rather than one-off solutions, all dependency injections needed for tests
+in Flutter's Android/Java engine embedding are now moved to the
+[`FlutterInjector`](https://cs.opensource.google/flutter/engine/+/master:shell/platform/android/io/flutter/FlutterInjector.java)
+class.
+
+Within the `FlutterInjector` class, the `setShouldLoadNative()` Builder
+function allows for control of whether to load the native library.
+
+## Description of change
+
+https://github.com/flutter/engine/commit/15f5696c4139a21e1fc54014ce17d01f6ad1737c#diff-599e1d64442183ead768757cca6805c3L154
+removes the `FlutterMain.setIsRunningInRobolectricTest()` testing function.
+
+https://github.com/flutter/engine/commit/15f5696c4139a21e1fc54014ce17d01f6ad1737c#diff-f928557f2d60773a8435366400fa42ed
+adds a `FlutterInjector` class to assist testing.
+
+## Migration guide
+
+Code before migration:
+
+<!-- skip -->
+```java
+FlutterMain.setIsRunningInRobolectricTest(true);
+```
+
+Code after migration:
+
+```java
+FlutterInjector.setInstance(new FlutterInjector.Builder().setShouldLoadNative(false).build());
+```
+
+## Timeline
+
+Landed in version: 1.22.0-2.0.pre.133<br>
+In stable release: not yet

src/docs/release/breaking-changes/index.md

@@ -16,11 +16,13 @@ release, and listed in alphabetical order:
 * [Material Chip button semantics][]
 * [Network Policy on iOS and Android][]
 * [The new Form, FormField auto-validation API][]
+* [Android FlutterMain.setIsRunningInRobolectricTest testing API removed][]
 
 [Android v1 embedding app and plugin creation deprecation]: /docs/release/breaking-changes/android-v1-embedding-create-deprecation
 [Material Chip button semantics]: /docs/release/breaking-changes/material-chip-button-semantics
 [Network Policy on iOS and Android]: /docs/release/breaking-changes/network-policy-ios-android
 [The new Form, FormField auto-validation API]: /docs/release/breaking-changes/form-field-autovalidation-api
+[Android FlutterMain.setIsRunningInRobolectricTest testing API removed]: /docs/release/breaking-change/android-setIsRunningInRobolectricTest-removed
 
 ### Released in Flutter 1.20