Androidのソースコードで@hideはどういう意味ですか？

以下のためのActivityソースコード、行3898（底に近いです）。

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

どういう@hide意味ですか？

をpublic class ChildActivity extends Activity { ... }使用できない、または参照できないことがわかりましたActivity.isResumed()。これは正常ですか？どうすればアクセスできますか？

Androidには、SDKを介してアクセスできない2種類のAPIがあります。

最初のものはパッケージにありますcom.android.internal。2番目のAPIタイプは、@ hide Javadoc属性でマークされたクラスとメソッドのコレクションです。

Android 9（APIレベル28）以降、Googleは、直接、リフレクション経由、またはJNI経由のいずれでも、非SDKインターフェースの使用に新しい制限を導入しています。これらの制限は、アプリが非SDKインターフェースを参照する場合、またはリフレクションまたはJNIを使​​用してハンドルを取得しようとする場合に適用されます。

ただし、APIレベル28より前は、Javaリフレクションを介して非表示メソッドにアクセスできました。この@hide属性はJavadoc（droiddocも）の一部に@hideすぎないため、単にメソッド/クラス/フィールドがAPIドキュメントから除外されていることを意味します。

たとえば、checkUidPermission()メソッドのActivityManager.java用途は@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;
}

ただし、リフレクションで呼び出すことができます。

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さまざまな理由で表示される必要があるものの、公開されたAPIの一部ではないものに使用されます。ソースからAPIを自動的に抽出する場合、それらはドキュメントに含まれません。

2. あなたは正しい、あなたはそれを上書きすることはできません。としてマークされてfinalいるため、これは仕様によるものです。あなたはそれを使用できるはずですが、エディターはそれがでマークされているため、使用するインテリセンスの選択肢の1つとして表示しない場合があり@hideます。また、以下の3の点に注意してください。

3. APIの一部ではないため、使用しないでください。開発者はいつでも削除できます。彼らがサディスティックに傾けていたとしても、それを実行しているデバイスをブロックする機能に置き換えることは、彼らの権利の範囲内でさえあります（ただし、厳密な法的意味ではないかもしれません）。

@hide注釈は、このインターフェースは、パブリックAPIの一部ではなく、あなたのコードでは使用すべきではないということを意味します。これらのメソッドは、AOSPの内部使用のみを目的としています。

Googleは実際には非SDKインターフェースの使用を制限し始めています。これには、@hide

メソッドは4つのリストに分類されます。

• ホワイトリスト：SDK
• light-greylist：まだアクセス可能なSDK以外のメソッド/フィールド。
• ダークグレイリスト：
  • ターゲットSDKがAPIレベル28未満のアプリの場合：ダークグレーリストインターフェースの使用はそれぞれ許可されます。
  • ターゲットSDKがAPIレベル28以上のアプリの場合：ブラックリストと同じ動作
• ブラックリスト：ターゲットSDKに関係なく制限されます。プラットフォームは、インターフェースが存在しないかのように動作します。たとえば、アプリがそれを使用しようとするたびにNoSuchMethodError / NoSuchFieldExceptionがスローされ、アプリが特定のクラスのフィールド/メソッドのリストを知りたい場合は含まれません。

リストはここにあります：https : //android.googlesource.com/platform/prebuilts/runtime/+/master/appcompat