1 /* 2 * Copyright (C) 2007 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 package android.content.pm; 18 19 import android.annotation.IntDef; 20 import android.os.Parcel; 21 import android.os.Parcelable; 22 import android.util.Printer; 23 24 import java.lang.annotation.Retention; 25 import java.lang.annotation.RetentionPolicy; 26 27 /** 28 * Information you can retrieve about a particular application 29 * service. This corresponds to information collected from the 30 * AndroidManifest.xml's <service> tags. 31 */ 32 public class ServiceInfo extends ComponentInfo 33 implements Parcelable { 34 /** 35 * Optional name of a permission required to be able to access this 36 * Service. From the "permission" attribute. 37 */ 38 public String permission; 39 40 /** 41 * Bit in {@link #flags}: If set, the service will automatically be 42 * stopped by the system if the user removes a task that is rooted 43 * in one of the application's activities. Set from the 44 * {@link android.R.attr#stopWithTask} attribute. 45 */ 46 public static final int FLAG_STOP_WITH_TASK = 0x0001; 47 48 /** 49 * Bit in {@link #flags}: If set, the service will run in its own 50 * isolated process. Set from the 51 * {@link android.R.attr#isolatedProcess} attribute. 52 */ 53 public static final int FLAG_ISOLATED_PROCESS = 0x0002; 54 55 /** 56 * Bit in {@link #flags}: If set, the service can be bound and run in the 57 * calling application's package, rather than the package in which it is 58 * declared. Set from {@link android.R.attr#externalService} attribute. 59 */ 60 public static final int FLAG_EXTERNAL_SERVICE = 0x0004; 61 62 /** 63 * Bit in {@link #flags}: If set, the service (which must be isolated) 64 * will be spawned from an Application Zygote, instead of the regular Zygote. 65 * The Application Zygote will pre-initialize the application's class loader, 66 * and call a static callback into the application to allow it to perform 67 * application-specific preloads (such as loading a shared library). Therefore, 68 * spawning from the Application Zygote will typically reduce the service 69 * launch time and reduce its memory usage. The downside of using this flag 70 * is that you will have an additional process (the app zygote itself) that 71 * is taking up memory. Whether actual memory usage is improved therefore 72 * strongly depends on the number of isolated services that an application 73 * starts, and how much memory those services save by preloading. Therefore, 74 * it is recommended to measure memory usage under typical workloads to 75 * determine whether it makes sense to use this flag. 76 */ 77 public static final int FLAG_USE_APP_ZYGOTE = 0x0008; 78 79 /** 80 * Bit in {@link #flags} indicating if the service is visible to ephemeral applications. 81 * @hide 82 */ 83 public static final int FLAG_VISIBLE_TO_INSTANT_APP = 0x100000; 84 85 /** 86 * Bit in {@link #flags}: If set, a single instance of the service will 87 * run for all users on the device. Set from the 88 * {@link android.R.attr#singleUser} attribute. 89 */ 90 public static final int FLAG_SINGLE_USER = 0x40000000; 91 92 /** 93 * Options that have been set in the service declaration in the 94 * manifest. 95 * These include: 96 * {@link #FLAG_STOP_WITH_TASK}, {@link #FLAG_ISOLATED_PROCESS}, 97 * {@link #FLAG_SINGLE_USER}. 98 */ 99 public int flags; 100 101 /** 102 * The default foreground service type if not been set in manifest file. 103 */ 104 public static final int FOREGROUND_SERVICE_TYPE_NONE = 0; 105 106 /** 107 * Constant corresponding to <code>dataSync</code> in 108 * the {@link android.R.attr#foregroundServiceType} attribute. 109 * Data(photo, file, account) upload/download, backup/restore, import/export, fetch, 110 * transfer over network between device and cloud. 111 */ 112 public static final int FOREGROUND_SERVICE_TYPE_DATA_SYNC = 1 << 0; 113 114 /** 115 * Constant corresponding to <code>mediaPlayback</code> in 116 * the {@link android.R.attr#foregroundServiceType} attribute. 117 * Music, video, news or other media playback. 118 */ 119 public static final int FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK = 1 << 1; 120 121 /** 122 * Constant corresponding to <code>phoneCall</code> in 123 * the {@link android.R.attr#foregroundServiceType} attribute. 124 * Ongoing phone call or video conference. 125 */ 126 public static final int FOREGROUND_SERVICE_TYPE_PHONE_CALL = 1 << 2; 127 128 /** 129 * Constant corresponding to <code>location</code> in 130 * the {@link android.R.attr#foregroundServiceType} attribute. 131 * GPS, map, navigation location update. 132 */ 133 public static final int FOREGROUND_SERVICE_TYPE_LOCATION = 1 << 3; 134 135 /** 136 * Constant corresponding to <code>connectedDevice</code> in 137 * the {@link android.R.attr#foregroundServiceType} attribute. 138 * Auto, bluetooth, TV or other devices connection, monitoring and interaction. 139 */ 140 public static final int FOREGROUND_SERVICE_TYPE_CONNECTED_DEVICE = 1 << 4; 141 142 /** 143 * Constant corresponding to {@code mediaProjection} in 144 * the {@link android.R.attr#foregroundServiceType} attribute. 145 * Managing a media projection session, e.g for screen recording or taking screenshots. 146 */ 147 public static final int FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION = 1 << 5; 148 149 /** 150 * Constant corresponding to {@code camera} in 151 * the {@link android.R.attr#foregroundServiceType} attribute. 152 * Use the camera device or record video. 153 * For apps with <code>targetSdkVersion</code> {@link android.os.Build.VERSION_CODES#R} and 154 * above, a foreground service will not be able to access the camera if this type is not 155 * specified in the manifest and in 156 * {@link android.app.Service#startForeground(int, android.app.Notification, int)}. 157 */ 158 public static final int FOREGROUND_SERVICE_TYPE_CAMERA = 1 << 6; 159 160 /** 161 * Constant corresponding to {@code microphone} in 162 * the {@link android.R.attr#foregroundServiceType} attribute. 163 * Use the microphone device or record audio. 164 * For apps with <code>targetSdkVersion</code> {@link android.os.Build.VERSION_CODES#R} and 165 * above, a foreground service will not be able to access the microphone if this type is not 166 * specified in the manifest and in 167 * {@link android.app.Service#startForeground(int, android.app.Notification, int)}. 168 */ 169 public static final int FOREGROUND_SERVICE_TYPE_MICROPHONE = 1 << 7; 170 171 /** 172 * A special value indicates to use all types set in manifest file. 173 */ 174 public static final int FOREGROUND_SERVICE_TYPE_MANIFEST = -1; 175 176 /** 177 * The set of flags for foreground service type. 178 * The foreground service type is set in {@link android.R.attr#foregroundServiceType} 179 * attribute. 180 * @hide 181 */ 182 @IntDef(flag = true, prefix = { "FOREGROUND_SERVICE_TYPE_" }, value = { 183 FOREGROUND_SERVICE_TYPE_MANIFEST, 184 FOREGROUND_SERVICE_TYPE_NONE, 185 FOREGROUND_SERVICE_TYPE_DATA_SYNC, 186 FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK, 187 FOREGROUND_SERVICE_TYPE_PHONE_CALL, 188 FOREGROUND_SERVICE_TYPE_LOCATION, 189 FOREGROUND_SERVICE_TYPE_CONNECTED_DEVICE, 190 FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION, 191 FOREGROUND_SERVICE_TYPE_CAMERA, 192 FOREGROUND_SERVICE_TYPE_MICROPHONE 193 }) 194 @Retention(RetentionPolicy.SOURCE) 195 public @interface ForegroundServiceType {} 196 197 /** 198 * The type of foreground service, set in 199 * {@link android.R.attr#foregroundServiceType} attribute by ORing flags in 200 * {@link ForegroundServiceType} 201 * @hide 202 */ 203 public @ForegroundServiceType int mForegroundServiceType = FOREGROUND_SERVICE_TYPE_NONE; 204 ServiceInfo()205 public ServiceInfo() { 206 } 207 ServiceInfo(ServiceInfo orig)208 public ServiceInfo(ServiceInfo orig) { 209 super(orig); 210 permission = orig.permission; 211 flags = orig.flags; 212 mForegroundServiceType = orig.mForegroundServiceType; 213 } 214 215 /** 216 * Return foreground service type specified in the manifest.. 217 * @return foreground service type specified in the manifest. 218 */ getForegroundServiceType()219 public @ForegroundServiceType int getForegroundServiceType() { 220 return mForegroundServiceType; 221 } 222 dump(Printer pw, String prefix)223 public void dump(Printer pw, String prefix) { 224 dump(pw, prefix, DUMP_FLAG_ALL); 225 } 226 227 /** @hide */ dump(Printer pw, String prefix, int dumpFlags)228 void dump(Printer pw, String prefix, int dumpFlags) { 229 super.dumpFront(pw, prefix); 230 pw.println(prefix + "permission=" + permission); 231 pw.println(prefix + "flags=0x" + Integer.toHexString(flags)); 232 super.dumpBack(pw, prefix, dumpFlags); 233 } 234 toString()235 public String toString() { 236 return "ServiceInfo{" 237 + Integer.toHexString(System.identityHashCode(this)) 238 + " " + name + "}"; 239 } 240 describeContents()241 public int describeContents() { 242 return 0; 243 } 244 writeToParcel(Parcel dest, int parcelableFlags)245 public void writeToParcel(Parcel dest, int parcelableFlags) { 246 super.writeToParcel(dest, parcelableFlags); 247 dest.writeString8(permission); 248 dest.writeInt(flags); 249 dest.writeInt(mForegroundServiceType); 250 } 251 252 public static final @android.annotation.NonNull Creator<ServiceInfo> CREATOR = 253 new Creator<ServiceInfo>() { 254 public ServiceInfo createFromParcel(Parcel source) { 255 return new ServiceInfo(source); 256 } 257 public ServiceInfo[] newArray(int size) { 258 return new ServiceInfo[size]; 259 } 260 }; 261 ServiceInfo(Parcel source)262 private ServiceInfo(Parcel source) { 263 super(source); 264 permission = source.readString8(); 265 flags = source.readInt(); 266 mForegroundServiceType = source.readInt(); 267 } 268 } 269