Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit b4c1e628 authored by Joanne Chung's avatar Joanne Chung
Browse files

Update Javadoc for PackageListObserver 

PackageListObserver is created to resolve the broadcast delay for
the system service. It is migrated off the broadcast to use callback.
The in-process binder calls are just direct method calls. This change
update the PackageListObserver javadoc to avoid new user using it.

Bug: 290955674
Test: build pass. No code logic change just javadoc update.
Change-Id: I1f83d749d9b2f660580c3987ee45d285f4f744e7
parent 0283bc86

services/core/java/android/content/pm/PackageManagerInternal.java

+18 −1
Original line number Diff line number Diff line
@@ -112,7 +112,14 @@ public abstract class PackageManagerInternal { 
     */

    public static final int INTEGRITY_VERIFICATION_REJECT = 0;



    /** Observer called whenever the list of packages changes */

    /**

     * Observer called whenever the list of packages changes.

     *

     * @deprecated please use {@link com.android.internal.content.PackageMonitor} instead.

     * PackageMonitor covers more installation and uninstallation corner cases than

     * PackageListObserver.

     */

    @Deprecated

    public interface PackageListObserver {

        /** A package was added to the system. */

        default void onPackageAdded(@NonNull String packageName, int uid) {}
@@ -723,7 +730,12 @@ public abstract class PackageManagerInternal { 
     * notified if a package is updated.

     * <p>The package list will not be updated automatically as packages are

     * installed / uninstalled. Any changes must be handled within the observer.

     *

     * @deprecated please use {@link com.android.internal.content.PackageMonitor} instead.

     * PackageMonitor covers more installation and uninstallation corner cases than

     * PackageListObserver.

     */

    @Deprecated

    public abstract @NonNull PackageList getPackageList(@Nullable PackageListObserver observer);



    /**
@@ -733,7 +745,12 @@ public abstract class PackageManagerInternal { 
     * <p>Does nothing if the observer isn't currently registered.

     * <p>Observers are notified asynchronously and it's possible for an observer to be

     * invoked after its been removed.

     *

     * @deprecated please use {@link com.android.internal.content.PackageMonitor} instead.

     * PackageMonitor covers more installation and uninstallation corner cases than

     * PackageListObserver.

     */

    @Deprecated

    public abstract void removePackageListObserver(@NonNull PackageListObserver observer);



    /**