| Action | 觸發時機 | 攜帶資料 | 接收者限制 |
|---|---|---|---|
| `PACKAGE_ADDED` | 新應用安裝完成 | `package` scheme Uri (含包名)、`EXTRA_UID`、 `EXTRA_REPLACING` (boolean, 是否替換) | **被安裝的 App 自身不會收到** |
| `PACKAGE_REPLACED` | 應用更新 (版本號升高) 完成 | 同上,`EXTRA_REPLACING=true` | **舊版本 App 會收到** (在新版本啟動前) |
| `PACKAGE_REMOVED` | 應用卸載 | 同上,`EXTRA_REPLACING=false` (純卸載)、`true` (更新後移除舊版) | **被卸載的 App 自身不會收到** |
| `PACKAGE_CHANGED` | 應用組件啟用/停用、權限變更 | 包名 Uri | 所有相關 App |
| `PACKAGE_FIRST_LAUNCH` (API 30+) | 應用首次啟動 | 包名 Uri | 僅該 App |
| `MY_PACKAGE_REPLACED` | **自身** 被更新 | 無額外資料 | **僅自身接收**,無需權限,最安全 |
| `MY_PACKAGE_REMOVED` (API 31+) | **自身** 被卸載 (極少見,通常無法執行代碼) | — | 僅自身 |
<receiver
android:name=".AppInstallReceiver"
android:exported="true"> <!-- Android 12+ 必須顯式聲明 -->
<intent-filter>
<action android:name="android.intent.action.PACKAGE_ADDED" />
<action android:name="android.intent.action.PACKAGE_REPLACED" />
<action android:name="android.intent.action.PACKAGE_REMOVED" />
<!-- 必須指定 data scheme -->
<data android:scheme="package" />
</intent-filter>
</receiver>
關鍵點:android:exported="true" (Android 12+ 強制)、**必須包含 ``**,否則 Android 8.0+ 不會分發此類廣播給靜態接收器。
// 在 Service/Application/長期存活組件中
IntentFilter filter = new IntentFilter();
filter.addAction(Intent.ACTION_PACKAGE_ADDED);
filter.addAction(Intent.ACTION_PACKAGE_REPLACED);
filter.addAction(Intent.ACTION_PACKAGE_REMOVED);
filter.addDataScheme("package"); // 必須
context.registerReceiver(receiver, filter, Context.RECEIVER_NOT_EXPORTED); // Android 13+ 安全旗標
// 針對自身更新的專用廣播 (無需 scheme、無需導出)
IntentFilter selfFilter = new IntentFilter(Intent.ACTION_MY_PACKAGE_REPLACED);
context.registerReceiver(selfReceiver, selfFilter, Context.RECEIVER_NOT_EXPORTED);
public class AppInstallReceiver extends BroadcastReceiver {
private static final String TAG = "AppInstallReceiver";
@Override
public void onReceive(Context context, Intent intent) {
String action = intent.getAction();
String packageName = intent.getData().getSchemeSpecificPart(); // 從 package:com.xxx 取得包名
int uid = intent.getIntExtra(Intent.EXTRA_UID, -1);
boolean replacing = intent.getBooleanExtra(Intent.EXTRA_REPLACING, false);
switch (action) {
case Intent.ACTION_PACKAGE_ADDED:
Log.i(TAG, "Installed: " + packageName + " uid=" + uid);
// 如:更新本地安裝列表、推送「新應用安裝」事件
break;
case Intent.ACTION_PACKAGE_REPLACED:
Log.i(TAG, "Replaced: " + packageName + " replacing=" + replacing);
if (replacing) {
// 應用更新:清理舊版緩存、遷移數據、通知用戶重啟
}
break;
case Intent.ACTION_PACKAGE_REMOVED:
Log.i(TAG, "Removed: " + packageName + " replacing=" + replacing);
if (!replacing) {
// 純卸載:清理殘留數據、撤銷權限、停止相關服務
}
break;
}
}
}
Android 11 限制應用查詢其他套件資訊。接收 `PACKAGE_ADDED/REMOVED` 廣播**不受影響** (系統主動分發),但若在 `onReceive` 中呼叫 `PackageManager.getPackageInfo()` 查詢詳情,需在 Manifest 聲明查詢權限:
<manifest ...>
<queries>
<!-- 查詢所有已安裝應用 (審核嚴格,慎用) -->
<package android:name="*" />
<!-- 或針對特定包名/意圖 -->
<intent>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent>
</queries>
</manifest>
| 場景 | 監聽廣播 | 處理邏輯 |
|---|---|---|
| 應用商店/管理器:刷新列表 | ADDED/REPLACED/REMOVED | 更新本地緩存列表、通知 UI 刷新 |
| 安全/殺毒:掃描新安裝 App | ADDED | 啟動掃描 Service、檢查簽名/權限/惡意行為 |
| 自動更新 SDK:檢測自身更新 | MY_PACKAGE_REPLACED | 啟動新版本、遷移數據、上報更新成功指標 |
| 插件化/熱修復框架 | ADDED/REPLACED/REMOVED | 同步插件索引、清理失效 Dex/So |
| 家長控制/MDM:阻止特定 App | ADDED | 對比黑名單、啟用 `DevicePolicyManager` 禁用/隱藏 |
掌握 **`PACKAGE_ADDED/REPLACED/REMOVED` + `data scheme=package` + `exported=true`** 靜態註冊模式,配合 **`MY_PACKAGE_REPLACED`** 監聽自身更新,並注意 **Android 11+ 套件可見性**、**Android 12+ exported 強制**、**Android 13+ 動態註冊旗標**,即可可靠實現應用安裝/更新/卸載監聽。業務邏輯務必在 `onReceive` 快速完成或轉交後台組件,避免 ANR。