¿Qué significa @hide en el código fuente de Android?

Para el Activitycódigo fuente , línea 3898 (cerca de la parte inferior):

/**
 * @hide
 */
public final boolean isResumed() {
    return mResumed;
}

¿Qué @hidesignifica?

Encontré que public class ChildActivity extends Activity { ... }no puedo usar / ver Activity.isResumed(). ¿Esto es normal? ¿Cómo puedo acceder a ella?

Android tiene dos tipos de API a las que no se puede acceder a través del SDK.

El primero se encuentra en el paquete com.android.internal. El segundo tipo de API es una colección de clases y métodos que están marcados con el atributo @hide Javadoc .

A partir de Android 9 (nivel de API 28), Google introduce nuevas restricciones sobre el uso de interfaces que no pertenecen al SDK , ya sea directamente, mediante reflexión o mediante JNI. Estas restricciones se aplican cada vez que una aplicación hace referencia a una interfaz que no es SDK o intenta obtener su identificador mediante la reflexión o JNI.

Pero antes del nivel de API 28, todavía se podía acceder a los métodos ocultos a través de la reflexión de Java. El @hideatributo es solo parte de Javadoc (droiddoc también), por lo que @hidesimplemente significa que el método / clase / campo está excluido de los documentos API.

Por ejemplo, el checkUidPermission()método en ActivityManager.javausos @hide:

/** @hide */
public static int checkUidPermission(String permission, int uid) {
    try {
        return AppGlobals.getPackageManager()
                .checkUidPermission(permission, uid);
    } catch (RemoteException e) {
        // Should never happen, but if it does... deny!
        Slog.e(TAG, "PackageManager is dead?!?", e);
    }
    return PackageManager.PERMISSION_DENIED;
}

Sin embargo, podemos llamarlo por reflexión:

Class c;
c = Class.forName("android.app.ActivityManager");
Method m = c.getMethod("checkUidPermission", new Class[] {String.class, int.class});
Object o = m.invoke(null, new Object[]{"android.permission.READ_CONTACTS", 10010});

1. @hidese utiliza para elementos que deben ser visibles por diversas razones, pero que no forman parte de la API publicada. No se incluirán en la documentación cuando extraiga automáticamente la API de la fuente.

2. Tienes razón, no puedes anularlo. Esto es normal, eso es por diseño, ya que está marcado como final. Debería poder usarlo , aunque es posible que un editor no se lo muestre como una de las opciones en cualquier intellisense que use porque está marcado con @hide, y debe tomar nota del punto 3 a continuación.

3. Usted debe no utilizarla en absoluto, ya que no es parte de la API y los desarrolladores lo puede quitar siempre que lo deseen. Incluso estarían dentro de sus derechos, si tuvieran una inclinación sádica, reemplazarlo con una función que bloqueara el dispositivo en el que se ejecuta (aunque tal vez no en un sentido legal estricto).

La @hideanotación significa que esta interfaz no es parte de la API pública y no debe usarse en su código. Los métodos son solo para uso interno del AOSP.

Google ha comenzado a restringir el uso de interfaces que no son SDK . Esto incluye interfaces marcadas con@hide

Los métodos se clasifican en cuatro listas:

• lista blanca: el SDK
• light-greylist: métodos / campos no SDK que aún son accesibles.
• lista gris oscura:
  • Para aplicaciones cuyo SDK de destino está por debajo del nivel de API 28: se permite cada uso de una interfaz de lista gris oscura.
  • Para aplicaciones cuyo SDK de destino es API nivel 28 o superior: el mismo comportamiento que la lista negra
• lista negra: restringida independientemente del SDK de destino. La plataforma se comportará como si la interfaz estuviera ausente. Por ejemplo, arrojará NoSuchMethodError / NoSuchFieldException siempre que la aplicación intente usarlo, y no lo incluirá cuando la aplicación quiera conocer la lista de campos / métodos de una clase en particular.

Las listas se pueden encontrar aquí: https://android.googlesource.com/platform/prebuilts/runtime/+/master/appcompat