Bug 1620395 - [1.0] Deprecate GeckoView Snapshot Telemetry API. r=geckoview-reviewers,snorp,agi

Differential Revision: https://phabricator.services.mozilla.com/D66077

--HG--
extra : moz-landing-system : lando

mobile/android/geckoview/api.txt

@@ -1368,7 +1368,7 @@ package org.mozilla.geckoview {
   }
 
   public final class RuntimeTelemetry {
-    method @AnyThread @NonNull public GeckoResult<JSONObject> getSnapshots(boolean);
+    method @Deprecated @AnyThread @NonNull public GeckoResult<JSONObject> getSnapshots(boolean);
   }
 
   public static interface RuntimeTelemetry.Delegate {

mobile/android/geckoview/src/androidTest/java/org/mozilla/geckoview/test/NavigationDelegateTest.kt

@@ -677,6 +677,7 @@ class NavigationDelegateTest : BaseSessionTest() {
                 innerWidth, closeTo(mobileInnerWidth, 0.1))
     }
 
+    @Suppress("deprecation")
     @Ignore // This test needs to set RuntimeSettings, TODO: Bug 1572245
     @Test fun telemetrySnapshots() {
         sessionRule.session.loadTestPath(HELLO_HTML_PATH)

mobile/android/geckoview/src/main/java/org/mozilla/geckoview/RuntimeTelemetry.java

@@ -40,7 +40,10 @@ public final class RuntimeTelemetry {
      *
      * @param clear Whether the retrieved snapshots should be cleared.
      * @return A {@link GeckoResult} with the GeckoBundle snapshot results.
+     *
+     * @deprecated Use Glean instead. Planned removal in 79 (bug 1620656).
      */
+    @Deprecated
     @AnyThread
     public @NonNull GeckoResult<JSONObject> getSnapshots(final boolean clear) {
         final GeckoBundle msg = new GeckoBundle(1);

mobile/android/geckoview/src/main/java/org/mozilla/geckoview/doc-files/CHANGELOG.md

@@ -15,6 +15,9 @@ exclude: true
 
 ## v76
 - Added [`GeckoSession.PermissionDelegate.PERMISSION_MEDIA_KEY_SYSTEM_ACCESS`][76.1] to control EME media key access.
+- [`RuntimeTelemetry#getSnapshots`][68.10] is deprecated and will be removed
+  in 79. Use Glean to handle Gecko telemetry.
+  ([bug 1620395]({{bugzilla}}1620395))
 
 [76.1]: {{javadoc_uri}}/GeckoSession.PermissionDelegate.html#PERMISSION_MEDIA_KEY_SYSTEM_ACCESS
 
@@ -658,4 +661,4 @@ exclude: true
 [65.24]: {{javadoc_uri}}/CrashReporter.html#sendCrashReport-android.content.Context-android.os.Bundle-java.lang.String-
 [65.25]: {{javadoc_uri}}/GeckoResult.html
 
-[api-version]: 3ccce953759d39a8b9b0b1b01dcc75c8ad6654aa
+[api-version]: 62cfb90bd471769c2e7366f8f4957fb7fa4edc4e