2 files changed, 15 insertions, 3 deletions
diff --git a/tests/testables/src/android/testing/TestableLooper.java b/tests/testables/src/android/testing/TestableLooper.java
index be5c84c0353c..3ee6dc48bfa3 100644
--- a/tests/testables/src/android/testing/TestableLooper.java
+++ b/tests/testables/src/android/testing/TestableLooper.java
@@ -42,6 +42,12 @@ import java.util.concurrent.atomic.AtomicBoolean;
  * and provide an easy annotation for use with tests.
  *
  * @see TestableLooperTest TestableLooperTest for examples.
+ *
+ * @deprecated Use {@link android.os.TestLooperManager} or {@link
+ *     org.robolectric.shadows.ShadowLooper} instead.
+ *     This class is not actively maintained.
+ *     Both of the recommended alternatives allow fine control of execution.
+ *     The Robolectric class also allows advancing time.
  */
 public class TestableLooper {
 
diff --git a/tests/utils/testutils/java/android/os/test/TestLooper.java b/tests/utils/testutils/java/android/os/test/TestLooper.java
index 56b0a25ed2dd..83d22d923c78 100644
--- a/tests/utils/testutils/java/android/os/test/TestLooper.java
+++ b/tests/utils/testutils/java/android/os/test/TestLooper.java
@@ -33,9 +33,15 @@ import java.lang.reflect.Method;
 import java.util.concurrent.Executor;
 
 /**
- * Creates a looper whose message queue can be manipulated
- * This allows testing code that uses a looper to dispatch messages in a deterministic manner
- * Creating a TestLooper will also install it as the looper for the current thread
+ * Creates a looper whose message queue can be manipulated This allows testing code that uses a
+ * looper to dispatch messages in a deterministic manner Creating a TestLooper will also install it
+ * as the looper for the current thread
+ *
+ * @deprecated Use {@link android.os.TestLooperManager} or {@link
+ *     org.robolectric.shadows.ShadowLooper} instead.
+ *     This class is not actively maintained.
+ *     Both of the recommended alternatives allow fine control of execution.
+ *     The Robolectric class also allows advancing time.
  */
 public class TestLooper {
     protected final Looper mLooper;