From e60263fae565654673e1f971da81955c46722ac1 Mon Sep 17 00:00:00 2001
From: Soonil Nagarkar <sooniln@google.com>
Date: Tue, 21 Jun 2022 16:23:37 -0700
Subject: Add javadocs update on Android R crash

Bug: 233111834
Test: na
Change-Id: I017113a22295106bbca3844761a512cd6ae057e1
---
 location/java/android/location/LocationManager.java | 7 +++++++
 1 file changed, 7 insertions(+)

(limited to 'location/java')

diff --git a/location/java/android/location/LocationManager.java b/location/java/android/location/LocationManager.java
index fd0c8948c321..861725fc986b 100644
--- a/location/java/android/location/LocationManager.java
+++ b/location/java/android/location/LocationManager.java
@@ -2667,6 +2667,13 @@ public class LocationManager {
      *
      * <p>Not all GNSS chipsets support measurements updates, see {@link #getGnssCapabilities()}.
      *
+     * <p class="caution">On Android R devices that have not yet upgraded to Android R QPR1, using
+     * this API will cause unavoidable crashes in the client application when GNSS measurements
+     * are received. If a client needs to receive GNSS measurements on Android R devices that have
+     * not been upgraded to QPR1, clients are instead encouraged to use
+     * <a href="https://developer.android.com/reference/androidx/core/location/LocationManagerCompat#registerGnssMeasurementsCallback(android.location.LocationManager,java.util.concurrent.Executor,android.location.GnssMeasurementsEvent.Callback)">LocationManagerCompat.registerGnssMeasurementsCallback()</a>
+     * from the compat libraries instead to avoid this crash.
+     *
      * @param executor the executor that the callback runs on
      * @param callback the callback to register
      * @return {@code true} always
-- 
cgit v1.2.3-59-g8ed1b