@Hide có nghĩa là gì trong mã nguồn Android?

Đối với Activitymã nguồn , dòng 3898 (gần dưới cùng):

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

Nghĩa @hidelà gì?

Tôi thấy tôi public class ChildActivity extends Activity { ... }không thể sử dụng / xem Activity.isResumed(). Điều này có bình thường không? Làm thế nào tôi có thể truy cập nó?

Android có hai loại API không thể truy cập thông qua SDK.

Cái đầu tiên nằm trong gói com.android.internal. Loại API thứ hai là một tập hợp các lớp và phương thức được đánh dấu bằng thuộc tính @hide Javadoc .

Bắt đầu từ Android 9 (API cấp 28), Google đưa ra các hạn chế mới đối với việc sử dụng các giao diện không phải SDK , dù là trực tiếp, qua phản chiếu hay qua JNI. Những hạn chế này được áp dụng bất cứ khi nào một ứng dụng tham chiếu đến giao diện không phải SDK hoặc cố gắng lấy tay cầm của nó bằng cách sử dụng phản chiếu hoặc JNI.

Nhưng trước API cấp 28, các phương thức ẩn vẫn có thể được truy cập thông qua phản chiếu Java. Các @hidethuộc tính chỉ là một phần của Javadoc (droiddoc cũng), do đó @hidechỉ đơn giản có nghĩa là phương pháp / lớp / trường được loại trừ khỏi các tài liệu API.

Ví dụ, checkUidPermission()phương thức được ActivityManager.javasử dụng @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;
}

Tuy nhiên, chúng ta có thể gọi nó bằng cách phản ánh:

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được sử dụng cho những thứ cần hiển thị vì nhiều lý do nhưng không phải là một phần của API đã xuất bản. Chúng sẽ không được đưa vào tài liệu khi nó tự động trích xuất API từ nguồn.

2. Bạn nói đúng, bạn không thể ghi đè nó. Điều này là bình thường, đó là do thiết kế, vì nó được đánh dấu là final. Bạn sẽ có thể sử dụng nó, mặc dù một trình soạn thảo có thể không hiển thị nó cho bạn như một trong những lựa chọn trong bất kỳ nội dung nào mà nó sử dụng vì nó được đánh dấu bằng @hidevà bạn nên lưu ý điểm 3 bên dưới.

3. Bạn hoàn toàn không nên sử dụng nó vì nó không phải là một phần của API và các nhà phát triển có thể xóa nó bất cứ khi nào họ muốn. Họ thậm chí sẽ được trong phạm vi quyền của họ, nếu họ có khuynh hướng tàn bạo, thay thế nó bằng một chức năng làm hỏng thiết bị mà nó chạy (mặc dù có thể không theo nghĩa pháp lý chặt chẽ).

Các @hidechú thích có nghĩa là giao diện này không phải là một phần của API công cộng và không nên được sử dụng trong mã của bạn. Các phương pháp này chỉ dành cho mục đích sử dụng nội bộ của AOSP.

Google đã thực sự bắt đầu hạn chế việc sử dụng các giao diện không phải sdk . Điều này bao gồm các giao diện được đánh dấu bằng@hide

Các phương pháp được phân loại thành bốn danh sách:

• danh sách trắng: SDK
• light-greylist: các trường / phương thức không phải SDK vẫn có thể truy cập được.
• dark-greylist:
  • Đối với các ứng dụng có SDK mục tiêu dưới API cấp 28: cho phép mỗi lần sử dụng giao diện danh sách màu xám tối.
  • Đối với các ứng dụng có SDK mục tiêu là API cấp 28 trở lên: hành vi tương tự như danh sách đen
• danh sách đen: bị hạn chế bất kể SDK mục tiêu. Nền tảng sẽ hoạt động như thể không có giao diện. Ví dụ: nó sẽ ném NoSuchMethodError / NoSuchFieldException bất cứ khi nào ứng dụng cố gắng sử dụng nó và sẽ không bao gồm nó khi ứng dụng muốn biết danh sách các trường / phương thức của một lớp cụ thể.

Danh sách có thể được tìm thấy tại đây: https://android.googlesource.com/platform/prebuilts/runtime/+/master/appcompat