Clarify javadoc on RequiresDevice.

Attempt to clarify its current limitations and reasons for deprecation.

PiperOrigin-RevId: 587706240

Author: brettchabot

runner/android_junit_runner/CHANGELOG.md

@@ -5,6 +5,7 @@
 `androidx.test:runner:{version}` is released.
 
 **Bug Fixes**
+* Attempt to clarify limitations and deprecation reasons in RequiresDevice documentation
 
 **New Features**
 

runner/android_junit_runner/java/androidx/test/filters/RequiresDevice.java

@@ -23,11 +23,11 @@
 /**
  * Indicates that a specific test should not be run on emulator.
  *
- * <p>It will be executed only if the test is running on the physical android device.
+ * <p>The test will be skipped if its executed on one of the recognized Android emulator types
+ * (currently ones with Build.HARDWARE equal to 'goldfish', 'ranchu' and 'gce_x86')
  *
- * @deprecated modern emulators have high fidelity, and this annotation should provide limited
- *     benefit. Use a more specific filtering mechanism to tie tests to a specific environment if
- *     needed
+ * @deprecated This annotation should provide limited benefit. Use a more specific filtering
+ *     mechanism to tie tests to a specific environment if needed.
  */
 @Retention(RetentionPolicy.RUNTIME)
 @Target({ElementType.TYPE, ElementType.METHOD})