src.com.android.server.pm.pkg.parsing.ParsingPackageRead Maven / Gradle / Ivy
/*
* Copyright (C) 2022 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 com.android.server.pm.pkg.parsing;
import android.annotation.NonNull;
import android.annotation.Nullable;
import android.content.Intent;
import android.content.pm.ApplicationInfo;
import android.content.pm.PackageManager.Property;
import android.content.pm.SigningDetails;
import android.os.Bundle;
import android.util.ArraySet;
import android.util.Pair;
import android.util.SparseIntArray;
import com.android.server.pm.pkg.component.ParsedApexSystemService;
import com.android.server.pm.pkg.component.ParsedAttribution;
import com.android.server.pm.pkg.component.ParsedIntentInfo;
import com.android.server.pm.pkg.component.ParsedPermissionGroup;
import com.android.server.pm.pkg.component.ParsedProcess;
import com.android.server.pm.pkg.component.ParsedUsesPermission;
import java.security.PublicKey;
import java.util.List;
import java.util.Map;
import java.util.Set;
/**
* Everything written by {@link ParsingPackage} and readable back.
*
* @hide
*/
public interface ParsingPackageRead extends PkgWithoutStateAppInfo, PkgWithoutStatePackageInfo,
ParsingPackageInternal {
/**
* The names of packages to adopt ownership of permissions from, parsed under {@link
* ParsingPackageUtils#TAG_ADOPT_PERMISSIONS}.
*
* @see R.styleable#AndroidManifestOriginalPackage_name
*/
@NonNull
List getAdoptPermissions();
/**
* @see R.styleable#AndroidManifestApexSystemService
*/
@NonNull
List getApexSystemServices();
@NonNull
List getAttributions();
/**
* Permissions requested but not in the manifest. These may have been split or migrated from
* previous versions/definitions.
*/
@NonNull
List getImplicitPermissions();
@NonNull
List getUsesPermissions();
/**
* For use with {@link com.android.server.pm.KeySetManagerService}. Parsed in {@link
* ParsingPackageUtils#TAG_KEY_SETS}.
*
* @see R.styleable#AndroidManifestKeySet
* @see R.styleable#AndroidManifestPublicKey
*/
@NonNull
Map> getKeySetMapping();
/**
* Library names this package is declared as, for use by other packages with "uses-library".
*
* @see R.styleable#AndroidManifestLibrary
*/
@NonNull
List getLibraryNames();
/**
* TODO(b/135203078): Make all the Bundles immutable (and non-null by shared empty reference?)
*/
@Nullable
Bundle getMetaData();
@Nullable
Set getMimeGroups();
/**
* @see R.styleable#AndroidManifestExtensionSdk
*/
@Nullable
SparseIntArray getMinExtensionVersions();
/**
* For system use to migrate from an old package name to a new one, moving over data if
* available.
*
* @see R.styleable#AndroidManifestOriginalPackage}
*/
@NonNull
List getOriginalPackages();
/**
* Map of overlayable name to actor name.
*/
@NonNull
Map getOverlayables();
/**
* @see android.content.pm.PermissionGroupInfo
*/
@NonNull
List getPermissionGroups();
/**
* Used to determine the default preferred handler of an {@link Intent}.
*
* Map of component className to intent info inside that component. TODO(b/135203078): Is this
* actually used/working?
*/
@NonNull
List> getPreferredActivityFilters();
/**
* @see android.content.pm.ProcessInfo
*/
@NonNull
Map getProcesses();
/**
* System protected broadcasts.
*
* @see R.styleable#AndroidManifestProtectedBroadcast
*/
@NonNull
List getProtectedBroadcasts();
/**
* Intents that this package may query or require and thus requires visibility into.
*
* @see R.styleable#AndroidManifestQueriesIntent
*/
@NonNull
List getQueriesIntents();
/**
* Other packages that this package may query or require and thus requires visibility into.
*
* @see R.styleable#AndroidManifestQueriesPackage
*/
@NonNull
List getQueriesPackages();
/**
* Authorities that this package may query or require and thus requires visibility into.
*
* @see R.styleable#AndroidManifestQueriesProvider
*/
@NonNull
Set getQueriesProviders();
/**
* SHA-512 hash of the only APK that can be used to update a system package.
*
* @see R.styleable#AndroidManifestRestrictUpdate
*/
@Nullable
byte[] getRestrictUpdateHash();
/**
* The signature data of all APKs in this package, which must be exactly the same across the
* base and splits.
*/
SigningDetails getSigningDetails();
/**
* Returns the properties set on the application
*/
@NonNull
Map getProperties();
/**
* Flags of any split APKs; ordered by parsed splitName
*/
@Nullable
int[] getSplitFlags();
/**
* @see R.styleable#AndroidManifestSdkLibrary_name
*/
@Nullable
String getSdkLibName();
/**
* @see R.styleable#AndroidManifestSdkLibrary_versionMajor
*/
int getSdkLibVersionMajor();
/**
* @see R.styleable#AndroidManifestStaticLibrary_name
*/
@Nullable
String getStaticSharedLibName();
/**
* @see R.styleable#AndroidManifestStaticLibrary_version
*/
long getStaticSharedLibVersion();
/**
* For use with {@link com.android.server.pm.KeySetManagerService}. Parsed in {@link
* ParsingPackageUtils#TAG_KEY_SETS}.
*
* @see R.styleable#AndroidManifestUpgradeKeySet
*/
@NonNull
Set getUpgradeKeySets();
/**
* @see R.styleable#AndroidManifestUsesLibrary
*/
@NonNull
List getUsesLibraries();
/**
* @see R.styleable#AndroidManifestUsesNativeLibrary
*/
@NonNull
List getUsesNativeLibraries();
/**
* Like {@link #getUsesLibraries()}, but marked optional by setting {@link
* R.styleable#AndroidManifestUsesLibrary_required} to false . Application is expected to handle
* absence manually.
*
* @see R.styleable#AndroidManifestUsesLibrary
*/
@NonNull
List getUsesOptionalLibraries();
/**
* Like {@link #getUsesNativeLibraries()}, but marked optional by setting {@link
* R.styleable#AndroidManifestUsesNativeLibrary_required} to false . Application is expected to
* handle absence manually.
*
* @see R.styleable#AndroidManifestUsesNativeLibrary
*/
@NonNull
List getUsesOptionalNativeLibraries();
/**
* TODO(b/135203078): Move static library stuff to an inner data class
*
* @see R.styleable#AndroidManifestUsesStaticLibrary
*/
@NonNull
List getUsesStaticLibraries();
/**
* @see R.styleable#AndroidManifestUsesStaticLibrary_certDigest
*/
@Nullable
String[][] getUsesStaticLibrariesCertDigests();
/**
* @see R.styleable#AndroidManifestUsesStaticLibrary_version
*/
@Nullable
long[] getUsesStaticLibrariesVersions();
/**
* TODO(b/135203078): Move SDK library stuff to an inner data class
*
* @see R.styleable#AndroidManifestUsesSdkLibrary
*/
@NonNull
List getUsesSdkLibraries();
/**
* @see R.styleable#AndroidManifestUsesSdkLibrary_certDigest
*/
@Nullable
String[][] getUsesSdkLibrariesCertDigests();
/**
* @see R.styleable#AndroidManifestUsesSdkLibrary_versionMajor
*/
@Nullable
long[] getUsesSdkLibrariesVersionsMajor();
boolean hasPreserveLegacyExternalStorage();
/**
* @see R.styleable#AndroidManifestApplication_forceQueryable
*/
boolean isForceQueryable();
/**
* @see ApplicationInfo#FLAG_IS_GAME
*/
@Deprecated
boolean isGame();
/**
* The install time abi override to choose 32bit abi's when multiple abi's are present. This is
* only meaningful for multiarch applications. The use32bitAbi attribute is ignored if
* cpuAbiOverride is also set.
*
* @see R.attr#use32bitAbi
*/
boolean isUse32BitAbi();
/**
* Set if the any of components are visible to instant applications.
*
* @see R.styleable#AndroidManifestActivity_visibleToInstantApps
* @see R.styleable#AndroidManifestProvider_visibleToInstantApps
* @see R.styleable#AndroidManifestService_visibleToInstantApps
*/
boolean isVisibleToInstantApps();
/**
* Whether the enabled settings of components in the application should be reset to the default,
* when the application's user data is cleared.
*
* @see R.styleable#AndroidManifestApplication_resetEnabledSettingsOnAppDataCleared
*/
boolean isResetEnabledSettingsOnAppDataCleared();
/**
* The resource ID used to provide the application's locales configuration.
*
* @see R.styleable#AndroidManifestApplication_localeConfig
*/
int getLocaleConfigRes();
/**
* @see R.styleable.AndroidManifestApplication_enableOnBackInvokedCallback
*/
boolean isOnBackInvokedCallbackEnabled();
/**
* Returns true if R.styleable#AndroidManifest_sharedUserMaxSdkVersion is set to a value
* smaller than the current SDK version.
* @see R.styleable#AndroidManifest_sharedUserMaxSdkVersion
*/
boolean isLeavingSharedUid();
}