PackageMonitor.java revision c72fc674a33b8d17585764d09d3bb6c77d7d947e
1/* 2 * Copyright (C) 2010 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 17package com.android.internal.content; 18 19import android.app.Activity; 20import android.content.Context; 21import android.content.Intent; 22import android.content.IntentFilter; 23import android.net.Uri; 24import android.os.Handler; 25import android.os.HandlerThread; 26import android.os.Looper; 27import android.os.UserHandle; 28 29import java.util.HashSet; 30 31/** 32 * Helper class for monitoring the state of packages: adding, removing, 33 * updating, and disappearing and reappearing on the SD card. 34 */ 35public abstract class PackageMonitor extends android.content.BroadcastReceiver { 36 static final IntentFilter sPackageFilt = new IntentFilter(); 37 static final IntentFilter sNonDataFilt = new IntentFilter(); 38 static final IntentFilter sExternalFilt = new IntentFilter(); 39 40 static final Object sLock = new Object(); 41 static HandlerThread sBackgroundThread; 42 static Handler sBackgroundHandler; 43 44 static { 45 sPackageFilt.addAction(Intent.ACTION_PACKAGE_ADDED); 46 sPackageFilt.addAction(Intent.ACTION_PACKAGE_REMOVED); 47 sPackageFilt.addAction(Intent.ACTION_PACKAGE_CHANGED); 48 sPackageFilt.addAction(Intent.ACTION_QUERY_PACKAGE_RESTART); 49 sPackageFilt.addAction(Intent.ACTION_PACKAGE_RESTARTED); 50 sPackageFilt.addAction(Intent.ACTION_UID_REMOVED); 51 sPackageFilt.addDataScheme("package"); 52 sNonDataFilt.addAction(Intent.ACTION_UID_REMOVED); 53 sNonDataFilt.addAction(Intent.ACTION_USER_STOPPED); 54 sExternalFilt.addAction(Intent.ACTION_EXTERNAL_APPLICATIONS_AVAILABLE); 55 sExternalFilt.addAction(Intent.ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE); 56 } 57 58 final HashSet<String> mUpdatingPackages = new HashSet<String>(); 59 60 Context mRegisteredContext; 61 Handler mRegisteredHandler; 62 String[] mDisappearingPackages; 63 String[] mAppearingPackages; 64 String[] mModifiedPackages; 65 int mChangeType; 66 int mChangeUserId = UserHandle.USER_NULL; 67 boolean mSomePackagesChanged; 68 69 String[] mTempArray = new String[1]; 70 71 public void register(Context context, Looper thread, boolean externalStorage) { 72 register(context, thread, null, externalStorage); 73 } 74 75 public void register(Context context, Looper thread, UserHandle user, 76 boolean externalStorage) { 77 if (mRegisteredContext != null) { 78 throw new IllegalStateException("Already registered"); 79 } 80 mRegisteredContext = context; 81 if (thread == null) { 82 synchronized (sLock) { 83 if (sBackgroundThread == null) { 84 sBackgroundThread = new HandlerThread("PackageMonitor", 85 android.os.Process.THREAD_PRIORITY_BACKGROUND); 86 sBackgroundThread.start(); 87 sBackgroundHandler = new Handler(sBackgroundThread.getLooper()); 88 } 89 mRegisteredHandler = sBackgroundHandler; 90 } 91 } else { 92 mRegisteredHandler = new Handler(thread); 93 } 94 if (user != null) { 95 context.registerReceiverAsUser(this, user, sPackageFilt, null, mRegisteredHandler); 96 context.registerReceiverAsUser(this, user, sNonDataFilt, null, mRegisteredHandler); 97 if (externalStorage) { 98 context.registerReceiverAsUser(this, user, sExternalFilt, null, 99 mRegisteredHandler); 100 } 101 } else { 102 context.registerReceiver(this, sPackageFilt, null, mRegisteredHandler); 103 context.registerReceiver(this, sNonDataFilt, null, mRegisteredHandler); 104 if (externalStorage) { 105 context.registerReceiver(this, sExternalFilt, null, mRegisteredHandler); 106 } 107 } 108 } 109 110 public Handler getRegisteredHandler() { 111 return mRegisteredHandler; 112 } 113 114 public void unregister() { 115 if (mRegisteredContext == null) { 116 throw new IllegalStateException("Not registered"); 117 } 118 mRegisteredContext.unregisterReceiver(this); 119 mRegisteredContext = null; 120 } 121 122 //not yet implemented 123 boolean isPackageUpdating(String packageName) { 124 synchronized (mUpdatingPackages) { 125 return mUpdatingPackages.contains(packageName); 126 } 127 } 128 129 public void onBeginPackageChanges() { 130 } 131 132 /** 133 * Called when a package is really added (and not replaced). 134 */ 135 public void onPackageAdded(String packageName, int uid) { 136 } 137 138 /** 139 * Called when a package is really removed (and not replaced). 140 */ 141 public void onPackageRemoved(String packageName, int uid) { 142 } 143 144 /** 145 * Called when a package is really removed (and not replaced) for 146 * all users on the device. 147 */ 148 public void onPackageRemovedAllUsers(String packageName, int uid) { 149 } 150 151 public void onPackageUpdateStarted(String packageName, int uid) { 152 } 153 154 public void onPackageUpdateFinished(String packageName, int uid) { 155 } 156 157 public void onPackageChanged(String packageName, int uid, String[] components) { 158 } 159 160 public boolean onHandleForceStop(Intent intent, String[] packages, int uid, boolean doit) { 161 return false; 162 } 163 164 public void onHandleUserStop(Intent intent, int userHandle) { 165 } 166 167 public void onUidRemoved(int uid) { 168 } 169 170 public void onPackagesAvailable(String[] packages) { 171 } 172 173 public void onPackagesUnavailable(String[] packages) { 174 } 175 176 public static final int PACKAGE_UNCHANGED = 0; 177 public static final int PACKAGE_UPDATING = 1; 178 public static final int PACKAGE_TEMPORARY_CHANGE = 2; 179 public static final int PACKAGE_PERMANENT_CHANGE = 3; 180 181 /** 182 * Called when a package disappears for any reason. 183 */ 184 public void onPackageDisappeared(String packageName, int reason) { 185 } 186 187 /** 188 * Called when a package appears for any reason. 189 */ 190 public void onPackageAppeared(String packageName, int reason) { 191 } 192 193 public void onPackageModified(String packageName) { 194 } 195 196 public boolean didSomePackagesChange() { 197 return mSomePackagesChanged; 198 } 199 200 public int isPackageAppearing(String packageName) { 201 if (mAppearingPackages != null) { 202 for (int i=mAppearingPackages.length-1; i>=0; i--) { 203 if (packageName.equals(mAppearingPackages[i])) { 204 return mChangeType; 205 } 206 } 207 } 208 return PACKAGE_UNCHANGED; 209 } 210 211 public boolean anyPackagesAppearing() { 212 return mAppearingPackages != null; 213 } 214 215 public int isPackageDisappearing(String packageName) { 216 if (mDisappearingPackages != null) { 217 for (int i=mDisappearingPackages.length-1; i>=0; i--) { 218 if (packageName.equals(mDisappearingPackages[i])) { 219 return mChangeType; 220 } 221 } 222 } 223 return PACKAGE_UNCHANGED; 224 } 225 226 public boolean anyPackagesDisappearing() { 227 return mDisappearingPackages != null; 228 } 229 230 public boolean isPackageModified(String packageName) { 231 if (mModifiedPackages != null) { 232 for (int i=mModifiedPackages.length-1; i>=0; i--) { 233 if (packageName.equals(mModifiedPackages[i])) { 234 return true; 235 } 236 } 237 } 238 return false; 239 } 240 241 public void onSomePackagesChanged() { 242 } 243 244 public void onFinishPackageChanges() { 245 } 246 247 public int getChangingUserId() { 248 return mChangeUserId; 249 } 250 251 String getPackageName(Intent intent) { 252 Uri uri = intent.getData(); 253 String pkg = uri != null ? uri.getSchemeSpecificPart() : null; 254 return pkg; 255 } 256 257 @Override 258 public void onReceive(Context context, Intent intent) { 259 mChangeUserId = intent.getIntExtra(Intent.EXTRA_USER_HANDLE, 260 UserHandle.USER_NULL); 261 if (mChangeUserId == UserHandle.USER_NULL) { 262 throw new IllegalArgumentException( 263 "Intent broadcast does not contain user handle: " + intent); 264 } 265 onBeginPackageChanges(); 266 267 mDisappearingPackages = mAppearingPackages = null; 268 mSomePackagesChanged = false; 269 270 String action = intent.getAction(); 271 if (Intent.ACTION_PACKAGE_ADDED.equals(action)) { 272 String pkg = getPackageName(intent); 273 int uid = intent.getIntExtra(Intent.EXTRA_UID, 0); 274 // We consider something to have changed regardless of whether 275 // this is just an update, because the update is now finished 276 // and the contents of the package may have changed. 277 mSomePackagesChanged = true; 278 if (pkg != null) { 279 mAppearingPackages = mTempArray; 280 mTempArray[0] = pkg; 281 if (intent.getBooleanExtra(Intent.EXTRA_REPLACING, false)) { 282 mModifiedPackages = mTempArray; 283 mChangeType = PACKAGE_UPDATING; 284 onPackageUpdateFinished(pkg, uid); 285 onPackageModified(pkg); 286 } else { 287 mChangeType = PACKAGE_PERMANENT_CHANGE; 288 onPackageAdded(pkg, uid); 289 } 290 onPackageAppeared(pkg, mChangeType); 291 if (mChangeType == PACKAGE_UPDATING) { 292 synchronized (mUpdatingPackages) { 293 mUpdatingPackages.remove(pkg); 294 } 295 } 296 } 297 } else if (Intent.ACTION_PACKAGE_REMOVED.equals(action)) { 298 String pkg = getPackageName(intent); 299 int uid = intent.getIntExtra(Intent.EXTRA_UID, 0); 300 if (pkg != null) { 301 mDisappearingPackages = mTempArray; 302 mTempArray[0] = pkg; 303 if (intent.getBooleanExtra(Intent.EXTRA_REPLACING, false)) { 304 mChangeType = PACKAGE_UPDATING; 305 synchronized (mUpdatingPackages) { 306 //not used for now 307 //mUpdatingPackages.add(pkg); 308 } 309 onPackageUpdateStarted(pkg, uid); 310 } else { 311 mChangeType = PACKAGE_PERMANENT_CHANGE; 312 // We only consider something to have changed if this is 313 // not a replace; for a replace, we just need to consider 314 // it when it is re-added. 315 mSomePackagesChanged = true; 316 onPackageRemoved(pkg, uid); 317 if (intent.getBooleanExtra(Intent.EXTRA_REMOVED_FOR_ALL_USERS, false)) { 318 onPackageRemovedAllUsers(pkg, uid); 319 } 320 } 321 onPackageDisappeared(pkg, mChangeType); 322 } 323 } else if (Intent.ACTION_PACKAGE_CHANGED.equals(action)) { 324 String pkg = getPackageName(intent); 325 int uid = intent.getIntExtra(Intent.EXTRA_UID, 0); 326 String[] components = intent.getStringArrayExtra( 327 Intent.EXTRA_CHANGED_COMPONENT_NAME_LIST); 328 if (pkg != null) { 329 mModifiedPackages = mTempArray; 330 mTempArray[0] = pkg; 331 onPackageChanged(pkg, uid, components); 332 // XXX Don't want this to always cause mSomePackagesChanged, 333 // since it can happen a fair amount. 334 onPackageModified(pkg); 335 } 336 } else if (Intent.ACTION_QUERY_PACKAGE_RESTART.equals(action)) { 337 mDisappearingPackages = intent.getStringArrayExtra(Intent.EXTRA_PACKAGES); 338 mChangeType = PACKAGE_TEMPORARY_CHANGE; 339 boolean canRestart = onHandleForceStop(intent, 340 mDisappearingPackages, 341 intent.getIntExtra(Intent.EXTRA_UID, 0), false); 342 if (canRestart) setResultCode(Activity.RESULT_OK); 343 } else if (Intent.ACTION_PACKAGE_RESTARTED.equals(action)) { 344 mDisappearingPackages = new String[] {getPackageName(intent)}; 345 mChangeType = PACKAGE_TEMPORARY_CHANGE; 346 onHandleForceStop(intent, mDisappearingPackages, 347 intent.getIntExtra(Intent.EXTRA_UID, 0), true); 348 } else if (Intent.ACTION_UID_REMOVED.equals(action)) { 349 onUidRemoved(intent.getIntExtra(Intent.EXTRA_UID, 0)); 350 } else if (Intent.ACTION_USER_STOPPED.equals(action)) { 351 if (intent.hasExtra(Intent.EXTRA_USER_HANDLE)) { 352 onHandleUserStop(intent, intent.getIntExtra(Intent.EXTRA_USER_HANDLE, 0)); 353 } 354 } else if (Intent.ACTION_EXTERNAL_APPLICATIONS_AVAILABLE.equals(action)) { 355 String[] pkgList = intent.getStringArrayExtra(Intent.EXTRA_CHANGED_PACKAGE_LIST); 356 mAppearingPackages = pkgList; 357 mChangeType = PACKAGE_TEMPORARY_CHANGE; 358 mSomePackagesChanged = true; 359 if (pkgList != null) { 360 onPackagesAvailable(pkgList); 361 for (int i=0; i<pkgList.length; i++) { 362 onPackageAppeared(pkgList[i], PACKAGE_TEMPORARY_CHANGE); 363 } 364 } 365 } else if (Intent.ACTION_EXTERNAL_APPLICATIONS_UNAVAILABLE.equals(action)) { 366 String[] pkgList = intent.getStringArrayExtra(Intent.EXTRA_CHANGED_PACKAGE_LIST); 367 mDisappearingPackages = pkgList; 368 mChangeType = PACKAGE_TEMPORARY_CHANGE; 369 mSomePackagesChanged = true; 370 if (pkgList != null) { 371 onPackagesUnavailable(pkgList); 372 for (int i=0; i<pkgList.length; i++) { 373 onPackageDisappeared(pkgList[i], PACKAGE_TEMPORARY_CHANGE); 374 } 375 } 376 } 377 378 if (mSomePackagesChanged) { 379 onSomePackagesChanged(); 380 } 381 382 onFinishPackageChanges(); 383 mChangeUserId = UserHandle.USER_NULL; 384 } 385} 386