1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
|
/*
**
** Copyright 2017, 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 android.content.pm.IStagedApexObserver;
import android.content.pm.StagedApexInfo;
/**
* Parallel implementation of certain {@link PackageManager} APIs that need to
* be exposed to native code.
* <p>These APIs are a parallel definition to the APIs in PackageManager, so,
* they can technically diverge. However, it's good practice to keep these
* APIs in sync with each other.
* <p>Because these APIs are exposed to native code, it's possible they will
* be exposed to privileged components [such as UID 0]. Care should be taken
* to avoid exposing potential security holes for methods where permission
* checks are bypassed based upon UID alone.
*
* @hide
*/
interface IPackageManagerNative {
/**
* Returns a set of names for the given UIDs.
* IMPORTANT: Unlike the Java version of this API, unknown UIDs are
* not represented by 'null's. Instead, they are represented by empty
* strings.
*/
@utf8InCpp String[] getNamesForUids(in int[] uids);
/**
* Return the UID associated with the given package name.
* Note that the same package will have different UIDs under different UserHandle on
* the same device.
* @param packageName The full name (i.e. com.google.apps.contacts) of the desired package.
* @param flags Additional option flags to modify the data returned.
* @param userId The user handle identifier to look up the package under.
* @return Returns an integer UID who owns the given package name, or -1 if no such package is
* available to the caller.
*/
int getPackageUid(in @utf8InCpp String packageName, in long flags, in int userId);
/**
* Returns the name of the installer (a package) which installed the named
* package. Preloaded packages return the string "preload". Sideloaded packages
* return an empty string. Unknown or unknowable are returned as empty strings.
*/
@utf8InCpp String getInstallerForPackage(in String packageName);
/**
* Returns the version code of the named package.
* Unknown or unknowable versions are returned as 0.
*/
long getVersionCodeForPackage(in String packageName);
/**
* Return if each app, identified by its package name allows its audio to be recorded.
* Unknown packages are mapped to false.
*/
boolean[] isAudioPlaybackCaptureAllowed(in @utf8InCpp String[] packageNames);
/* ApplicationInfo.isSystemApp() == true */
const int LOCATION_SYSTEM = 0x1;
/* ApplicationInfo.isVendor() == true */
const int LOCATION_VENDOR = 0x2;
/* ApplicationInfo.isProduct() == true */
const int LOCATION_PRODUCT = 0x4;
/**
* Returns a set of bitflags about package location.
* LOCATION_SYSTEM: getApplicationInfo(packageName).isSystemApp()
* LOCATION_VENDOR: getApplicationInfo(packageName).isVendor()
* LOCATION_PRODUCT: getApplicationInfo(packageName).isProduct()
*/
int getLocationFlags(in @utf8InCpp String packageName);
/**
* Returns the target SDK version for the given package.
* Unknown packages will cause the call to fail. The caller must check the
* returned Status before using the result of this function.
*/
int getTargetSdkVersionForPackage(in String packageName);
/**
* Returns the name of module metadata package, or empty string if device doesn't have such
* package.
*/
@utf8InCpp String getModuleMetadataPackageName();
/**
* Returns true if the package has the SHA 256 version of the signing certificate.
* @see PackageManager#hasSigningCertificate(String, byte[], int), where type
* has been set to {@link PackageManager#CERT_INPUT_SHA256}.
*/
boolean hasSha256SigningCertificate(in @utf8InCpp String packageName, in byte[] certificate);
/**
* Returns the debug flag for the given package.
* Unknown packages will cause the call to fail.
*/
boolean isPackageDebuggable(in String packageName);
/**
* Check whether the given feature name and version is one of the available
* features as returned by {@link PackageManager#getSystemAvailableFeatures()}. Since
* features are defined to always be backwards compatible, this returns true
* if the available feature version is greater than or equal to the
* requested version.
*/
boolean hasSystemFeature(in String featureName, in int version);
/** Register a observer for change in set of staged APEX ready for installation */
void registerStagedApexObserver(in IStagedApexObserver observer);
/**
* Unregister an existing staged apex observer.
* This does nothing if this observer was not already registered.
*/
void unregisterStagedApexObserver(in IStagedApexObserver observer);
/**
* Get APEX module names of all APEX that are staged ready for installation
*/
@utf8InCpp String[] getStagedApexModuleNames();
/**
* Get information of APEX which is staged ready for installation.
* Returns null if no such APEX is found.
*/
@nullable StagedApexInfo getStagedApexInfo(in @utf8InCpp String moduleName);
}
|
