Cosa significa @hide nel codice sorgente di Android?

Per il Activitycodice sorgente , riga 3898 (vicino alla fine):

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

Cosa @hidesignifica?

Ho scoperto che public class ChildActivity extends Activity { ... }non posso usare / vedere Activity.isResumed(). È normale? Come posso accedervi?

Android ha due tipi di API che non sono accessibili tramite SDK.

Il primo si trova nel pacchetto com.android.internal. Il secondo tipo di API è una raccolta di classi e metodi contrassegnati con l' attributo @hide Javadoc .

A partire da Android 9 (livello API 28), Google introduce nuove restrizioni sull'utilizzo di interfacce non SDK , sia direttamente, tramite reflection, sia tramite JNI. Queste restrizioni vengono applicate ogni volta che un'app fa riferimento a un'interfaccia non SDK o tenta di ottenere il relativo handle utilizzando la reflection o JNI.

Ma prima del livello API 28, era ancora possibile accedere ai metodi nascosti tramite la riflessione Java. L' @hideattributo è solo una parte di Javadoc (anche droiddoc), quindi @hidesignifica semplicemente che il metodo / classe / campo è escluso dai documenti dell'API.

Ad esempio, il checkUidPermission()metodo in ActivityManager.javautilizza @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;
}

Tuttavia, possiamo chiamarlo per riflessione:

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. @hideviene utilizzato per cose che devono essere visibili per vari motivi ma non fanno parte dell'API pubblicata. Non saranno inclusi nella documentazione quando estrae automagicamente l'API dalla sorgente.

2. Hai ragione, non puoi ignorarlo. Questo è normale, in base alla progettazione, poiché è contrassegnato come final. Dovresti essere in grado di usarlo , anche se un editor potrebbe non mostrartelo come una delle scelte in qualunque senso intellettuale utilizzi perché è contrassegnato con @hide, e dovresti prendere nota del punto 3 di seguito.

3. Si dovrebbe non utilizzare affatto dal momento che non fa parte delle API e gli sviluppatori in grado di rimuovere ogni volta che lo desiderano. Sarebbero anche nei loro diritti, se fossero sadicamente inclini, a sostituirlo con una funzione che bloccasse il dispositivo su cui girava (anche se forse non in senso stretto legale).

Il @hide annotazione significa che questa interfaccia non fa parte dell'API pubblica e non deve essere utilizzata nel codice. I metodi sono solo per uso interno dell'AOSP.

Google ha effettivamente iniziato a limitare l'utilizzo di interfacce non sdk . Ciò include le interfacce contrassegnate con@hide

I metodi sono classificati in quattro elenchi:

• whitelist: l'SDK
• light-greylist: metodi / campi non SDK ancora accessibili.
• dark-greylist:
  • Per le app il cui SDK di destinazione è inferiore al livello API 28: è consentito ogni utilizzo di un'interfaccia dark greylist.
  • Per le app il cui SDK di destinazione è livello API 28 o superiore: stesso comportamento della lista nera
• blacklist: limitato indipendentemente dall'SDK di destinazione. La piattaforma si comporterà come se l'interfaccia fosse assente. Ad esempio, lancerà NoSuchMethodError / NoSuchFieldException ogni volta che l'app tenta di usarlo e non lo includerà quando l'app desidera conoscere l'elenco di campi / metodi di una particolare classe.

Gli elenchi possono essere trovati qui: https://android.googlesource.com/platform/prebuilts/runtime/+/master/appcompat