deprecate Android announcement events and add deprecation warning. (#165195)

Due to this [Android
deprecation](https://developer.android.com/reference/android/view/View#announceForAccessibility(java.lang.CharSequence))
Flutter needs to show deprecation warnings to developers when using
announce on Android.

Unfortunately testing this log statement is impossible since robolectric
currently does not support API >=36.
https://github.com/flutter/flutter/issues/165220 will add the test code
in once robolectric supports 36.

## Pre-launch Checklist

- [x] I read the [Contributor Guide] and followed the process outlined
there for submitting PRs.
- [x] I read the [Tree Hygiene] wiki page, which explains my
responsibilities.
- [x] I read and followed the [Flutter Style Guide], including [Features
we expect every widget to implement].
- [x] I signed the [CLA].
- [x] I listed at least one issue that this PR fixes in the description
above.
- [x] I updated/added relevant documentation (doc comments with `///`).
- [x] I added new tests to check the change I am making, or this PR is
[test-exempt].
- [x] I followed the [breaking change policy] and added [Data Driven
Fixes] where supported.
- [x] All existing and new tests are passing.

If you need help, consider asking for advice on the #hackers-new channel
on [Discord].

<!-- Links -->
[Contributor Guide]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#overview
[Tree Hygiene]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md
[test-exempt]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#tests
[Flutter Style Guide]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md
[Features we expect every widget to implement]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Style-guide-for-Flutter-repo.md#features-we-expect-every-widget-to-implement
[CLA]: https://cla.developers.google.com/
[flutter/tests]: https://github.com/flutter/tests
[breaking change policy]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#handling-breaking-changes
[Discord]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Chat.md
[Data Driven Fixes]:
https://github.com/flutter/flutter/blob/main/docs/contributing/Data-driven-Fixes.md

engine/src/flutter/shell/platform/android/io/flutter/Build.java

@@ -11,20 +11,37 @@ public class Build {
   /** For use in place of the Android Build.VERSION_CODES class. */
   public static class API_LEVELS {
     @VisibleForTesting public static final int FLUTTER_MIN = 21;
+    /** Android 5.0 (Lollipop) */
     public static final int API_21 = 21;
+    /** Android 5.1 (Lollipop MR1) */
     public static final int API_22 = 22;
+    /** Android 6.0 (Marshmallow) */
     public static final int API_23 = 23;
+    /** Android 7.0 (Nougat) */
     public static final int API_24 = 24;
+    /** Android 7.1 (Nougat MR1) */
     public static final int API_25 = 25;
+    /** Android 8.0 (Oreo) */
     public static final int API_26 = 26;
+    /** Android 8.1 (Oreo MR1) */
     public static final int API_27 = 27;
+    /** Android 9 (Pie) */
     public static final int API_28 = 28;
+    /** Android 10 (Q) */
     public static final int API_29 = 29;
+    /** Android 11 (R) */
     public static final int API_30 = 30;
+    /** Android 12 (S) */
     public static final int API_31 = 31;
+    /** Android 12L (Sv2) */
     public static final int API_32 = 32;
+    /** Android 13 (Tiramisu) */
     public static final int API_33 = 33;
+    /** Android 14 (Upside Down Cake) */
     public static final int API_34 = 34;
+    /** Android 15 (Vanilla Ice Cream) */
     public static final int API_35 = 35;
+    /** Android 16 */
+    public static final int API_36 = 36;
   }
 }

engine/src/flutter/shell/platform/android/io/flutter/embedding/engine/systemchannels/AccessibilityChannel.java

@@ -24,6 +24,7 @@ public class AccessibilityChannel {
   @NonNull public final FlutterJNI flutterJNI;
   @Nullable private AccessibilityMessageHandler handler;
 
+  @SuppressWarnings("deprecation")
   public final BasicMessageChannel.MessageHandler<Object> parsingMessageHandler =
       new BasicMessageChannel.MessageHandler<Object>() {
         @Override
@@ -181,7 +182,16 @@ public class AccessibilityChannel {
    * {@link AccessibilityChannel#setAccessibilityMessageHandler(AccessibilityMessageHandler)}.
    */
   public interface AccessibilityMessageHandler extends FlutterJNI.AccessibilityDelegate {
-    /** The Dart application would like the given {@code message} to be announced. */
+    /**
+     * The Dart application would like the given {@code message} to be announced.
+     *
+     * <p>Using AnnounceSemanticsEvent for accessibility is deprecated on Android. Migrate to using
+     * semantic properties for a more robust and accessible user experience.
+     *
+     * @see <a
+     *     href="https://developer.android.com/reference/android/view/View#announceForAccessibility(java.lang.CharSequence)">announceForAccessibility</a>"
+     */
+    @Deprecated(since = "Android API level 36")
     void announce(@NonNull String message);
 
     /** The user has tapped on the semantics node with the given {@code nodeId}. */

engine/src/flutter/shell/platform/android/io/flutter/view/AccessibilityBridge.java

@@ -303,6 +303,13 @@ public class AccessibilityBridge extends AccessibilityNodeProvider {
         /** The Dart application would like the given {@code message} to be announced. */
         @Override
         public void announce(@NonNull String message) {
+          if (Build.VERSION.SDK_INT >= API_LEVELS.API_36) {
+            Log.w(
+                TAG,
+                "Using AnnounceSemanticsEvent for accessibility is deprecated on Android. "
+                    + "Migrate to using semantic properties for a more robust and accessible "
+                    + "user experience. See https://developer.android.com/reference/android/view/View#announceForAccessibility(java.lang.CharSequence)");
+          }
           rootAccessibilityView.announceForAccessibility(message);
         }