Java tutorial
/* * Copyright (C) 2012 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package android.content.pm; import static android.content.pm.PackageManager.COMPONENT_ENABLED_STATE_DEFAULT; import static android.content.pm.PackageManager.COMPONENT_ENABLED_STATE_DISABLED; import static android.content.pm.PackageManager.COMPONENT_ENABLED_STATE_DISABLED_UNTIL_USED; import static android.content.pm.PackageManager.COMPONENT_ENABLED_STATE_DISABLED_USER; import static android.content.pm.PackageManager.COMPONENT_ENABLED_STATE_ENABLED; import static android.content.pm.PackageManager.MATCH_DIRECT_BOOT_AWARE; import static android.content.pm.PackageManager.MATCH_DIRECT_BOOT_UNAWARE; import static android.content.pm.PackageManager.MATCH_DISABLED_COMPONENTS; import static android.content.pm.PackageManager.MATCH_DISABLED_UNTIL_USED_COMPONENTS; import static android.content.pm.PackageManager.MATCH_SYSTEM_ONLY; import android.annotation.UnsupportedAppUsage; import android.os.BaseBundle; import android.os.PersistableBundle; import android.util.ArraySet; import com.android.internal.util.ArrayUtils; import java.util.Arrays; import java.util.Objects; /** * Per-user state information about a package. * @hide */ public class PackageUserState { public long ceDataInode; public boolean installed; public boolean stopped; public boolean notLaunched; public boolean hidden; // Is the app restricted by owner / admin public boolean suspended; public String suspendingPackage; public String dialogMessage; // Message to show when a suspended package launch attempt is made public PersistableBundle suspendedAppExtras; public PersistableBundle suspendedLauncherExtras; public boolean instantApp; public boolean virtualPreload; public int enabled; public String lastDisableAppCaller; public int domainVerificationStatus; public int appLinkGeneration; public int categoryHint = ApplicationInfo.CATEGORY_UNDEFINED; public int installReason; public String harmfulAppWarning; public ArraySet<String> disabledComponents; public ArraySet<String> enabledComponents; public String[] overlayPaths; @UnsupportedAppUsage public PackageUserState() { installed = true; hidden = false; suspended = false; enabled = COMPONENT_ENABLED_STATE_DEFAULT; domainVerificationStatus = PackageManager.INTENT_FILTER_DOMAIN_VERIFICATION_STATUS_UNDEFINED; installReason = PackageManager.INSTALL_REASON_UNKNOWN; } public PackageUserState(PackageUserState o) { ceDataInode = o.ceDataInode; installed = o.installed; stopped = o.stopped; notLaunched = o.notLaunched; hidden = o.hidden; suspended = o.suspended; suspendingPackage = o.suspendingPackage; dialogMessage = o.dialogMessage; suspendedAppExtras = o.suspendedAppExtras; suspendedLauncherExtras = o.suspendedLauncherExtras; instantApp = o.instantApp; virtualPreload = o.virtualPreload; enabled = o.enabled; lastDisableAppCaller = o.lastDisableAppCaller; domainVerificationStatus = o.domainVerificationStatus; appLinkGeneration = o.appLinkGeneration; categoryHint = o.categoryHint; installReason = o.installReason; disabledComponents = ArrayUtils.cloneOrNull(o.disabledComponents); enabledComponents = ArrayUtils.cloneOrNull(o.enabledComponents); overlayPaths = o.overlayPaths == null ? null : Arrays.copyOf(o.overlayPaths, o.overlayPaths.length); harmfulAppWarning = o.harmfulAppWarning; } /** * Test if this package is installed. */ public boolean isAvailable(int flags) { // True if it is installed for this user and it is not hidden. If it is hidden, // still return true if the caller requested MATCH_UNINSTALLED_PACKAGES final boolean matchAnyUser = (flags & PackageManager.MATCH_ANY_USER) != 0; final boolean matchUninstalled = (flags & PackageManager.MATCH_UNINSTALLED_PACKAGES) != 0; return matchAnyUser || (this.installed && (!this.hidden || matchUninstalled)); } /** * Test if the given component is considered installed, enabled and a match * for the given flags. * * <p> * Expects at least one of {@link PackageManager#MATCH_DIRECT_BOOT_AWARE} and * {@link PackageManager#MATCH_DIRECT_BOOT_UNAWARE} are specified in {@code flags}. * </p> */ public boolean isMatch(ComponentInfo componentInfo, int flags) { final boolean isSystemApp = componentInfo.applicationInfo.isSystemApp(); final boolean matchUninstalled = (flags & PackageManager.MATCH_KNOWN_PACKAGES) != 0; if (!isAvailable(flags) && !(isSystemApp && matchUninstalled)) return false; if (!isEnabled(componentInfo, flags)) return false; if ((flags & MATCH_SYSTEM_ONLY) != 0) { if (!isSystemApp) { return false; } } final boolean matchesUnaware = ((flags & MATCH_DIRECT_BOOT_UNAWARE) != 0) && !componentInfo.directBootAware; final boolean matchesAware = ((flags & MATCH_DIRECT_BOOT_AWARE) != 0) && componentInfo.directBootAware; return matchesUnaware || matchesAware; } /** * Test if the given component is considered enabled. */ public boolean isEnabled(ComponentInfo componentInfo, int flags) { if ((flags & MATCH_DISABLED_COMPONENTS) != 0) { return true; } // First check if the overall package is disabled; if the package is // enabled then fall through to check specific component switch (this.enabled) { case COMPONENT_ENABLED_STATE_DISABLED: case COMPONENT_ENABLED_STATE_DISABLED_USER: return false; case COMPONENT_ENABLED_STATE_DISABLED_UNTIL_USED: if ((flags & MATCH_DISABLED_UNTIL_USED_COMPONENTS) == 0) { return false; } case COMPONENT_ENABLED_STATE_DEFAULT: if (!componentInfo.applicationInfo.enabled) { return false; } case COMPONENT_ENABLED_STATE_ENABLED: break; } // Check if component has explicit state before falling through to // the manifest default if (ArrayUtils.contains(this.enabledComponents, componentInfo.name)) { return true; } if (ArrayUtils.contains(this.disabledComponents, componentInfo.name)) { return false; } return componentInfo.enabled; } @Override final public boolean equals(Object obj) { if (!(obj instanceof PackageUserState)) { return false; } final PackageUserState oldState = (PackageUserState) obj; if (ceDataInode != oldState.ceDataInode) { return false; } if (installed != oldState.installed) { return false; } if (stopped != oldState.stopped) { return false; } if (notLaunched != oldState.notLaunched) { return false; } if (hidden != oldState.hidden) { return false; } if (suspended != oldState.suspended) { return false; } if (suspended) { if (suspendingPackage == null || !suspendingPackage.equals(oldState.suspendingPackage)) { return false; } if (!Objects.equals(dialogMessage, oldState.dialogMessage)) { return false; } if (!BaseBundle.kindofEquals(suspendedAppExtras, oldState.suspendedAppExtras)) { return false; } if (!BaseBundle.kindofEquals(suspendedLauncherExtras, oldState.suspendedLauncherExtras)) { return false; } } if (instantApp != oldState.instantApp) { return false; } if (virtualPreload != oldState.virtualPreload) { return false; } if (enabled != oldState.enabled) { return false; } if ((lastDisableAppCaller == null && oldState.lastDisableAppCaller != null) || (lastDisableAppCaller != null && !lastDisableAppCaller.equals(oldState.lastDisableAppCaller))) { return false; } if (domainVerificationStatus != oldState.domainVerificationStatus) { return false; } if (appLinkGeneration != oldState.appLinkGeneration) { return false; } if (categoryHint != oldState.categoryHint) { return false; } if (installReason != oldState.installReason) { return false; } if ((disabledComponents == null && oldState.disabledComponents != null) || (disabledComponents != null && oldState.disabledComponents == null)) { return false; } if (disabledComponents != null) { if (disabledComponents.size() != oldState.disabledComponents.size()) { return false; } for (int i = disabledComponents.size() - 1; i >= 0; --i) { if (!oldState.disabledComponents.contains(disabledComponents.valueAt(i))) { return false; } } } if ((enabledComponents == null && oldState.enabledComponents != null) || (enabledComponents != null && oldState.enabledComponents == null)) { return false; } if (enabledComponents != null) { if (enabledComponents.size() != oldState.enabledComponents.size()) { return false; } for (int i = enabledComponents.size() - 1; i >= 0; --i) { if (!oldState.enabledComponents.contains(enabledComponents.valueAt(i))) { return false; } } } if (harmfulAppWarning == null && oldState.harmfulAppWarning != null || (harmfulAppWarning != null && !harmfulAppWarning.equals(oldState.harmfulAppWarning))) { return false; } return true; } }