O que significa @hide no código fonte do Android?

Para o Activitycódigo fonte , linha 3898 (próxima à parte inferior):

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

O que @hidesignifica isso ?

Eu encontrei o meu public class ChildActivity extends Activity { ... }não pode usar / ver Activity.isResumed(). Isso é normal? Como posso acessá-lo?

O Android tem dois tipos de APIs que não são acessíveis via SDK.

O primeiro está localizado no pacote com.android.internal. O segundo tipo de API é uma coleção de classes e métodos marcados com o atributo @hide Javadoc .

A partir do Android 9 (API nível 28), o Google introduz novas restrições ao uso de interfaces não SDK , seja diretamente, via reflexão ou via JNI. Essas restrições são aplicadas sempre que um aplicativo faz referência a uma interface não SDK ou tenta obter seu identificador usando reflexão ou JNI.

Porém, antes do nível 28 da API, os métodos ocultos ainda podiam ser acessados ​​via reflexão de Java. O @hideatributo é apenas parte do Javadoc (droiddoc também), portanto, @hidesignifica simplesmente que o método / classe / campo é excluído dos documentos da API.

Por exemplo, o checkUidPermission()método em ActivityManager.javausa @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;
}

No entanto, podemos chamá-lo por reflexão:

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. @hideé usado para itens que precisam estar visíveis por vários motivos, mas não fazem parte da API publicada. Eles não serão incluídos na documentação quando extrair automaticamente a API da fonte.

2. Você está certo, você não pode substituí-lo. Isso é normal, é por design, pois está marcado como final. Você deve poder usá- lo, embora um editor não o mostre como uma das opções em qualquer intelecto que ele usa porque está marcado com @hide, e você deve tomar nota do ponto 3 abaixo.

3. Você não deve usá-lo, pois não faz parte da API e os desenvolvedores podem removê-la sempre que desejarem. Eles estariam dentro dos seus direitos, se eles estivessem sadicamente inclinados, para substituí-lo por uma função que bloqueava o dispositivo em que ele era executado (embora talvez não em um sentido legal estrito).

A @hideanotação significa que essa interface não faz parte da API pública e não deve ser usada no seu código. Os métodos são apenas para uso interno do AOSP.

O Google começou a restringir o uso de interfaces não sdk . Isso inclui interfaces marcadas com@hide

Os métodos são classificados em quatro listas:

• lista branca: o SDK
• light-greylist: métodos / campos não SDK que ainda estão acessíveis.
• greylist escuro:
  • Para aplicativos cujo SDK de destino está abaixo do nível 28 da API: é permitido o uso de uma interface de lista cinza escura.
  • Para aplicativos cujo SDK de destino é API nível 28 ou superior: mesmo comportamento da lista negra
• lista negra: restrita, independentemente do SDK de destino. A plataforma se comportará como se a interface estivesse ausente. Por exemplo, ele lançará NoSuchMethodError / NoSuchFieldException sempre que o aplicativo estiver tentando usá-lo e não o incluirá quando o aplicativo quiser conhecer a lista de campos / métodos de uma classe específica.

As listas podem ser encontradas aqui: https://android.googlesource.com/platform/prebuilts/runtime/+/master/appcompat