萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 監聽應用安裝/更新/卸載廣播:PackageInstallReceiver 完整實作與 Android 11+ 適配

核心廣播動作對照表

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+)**自身** 被卸載 (極少見,通常無法執行代碼)—僅自身

Manifest 靜態註冊 (適用所有版本)

<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+ 不會分發此類廣播給靜態接收器。

動態註冊 (Context.registerReceiver)

// 在 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);

BroadcastReceiver 實作

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+ (API 30+) 重大變更:套件可見性

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 刷新
安全/殺毒:掃描新安裝 AppADDED啟動掃描 Service、檢查簽名/權限/惡意行為
自動更新 SDK:檢測自身更新MY_PACKAGE_REPLACED啟動新版本、遷移數據、上報更新成功指標
插件化/熱修復框架ADDED/REPLACED/REMOVED同步插件索引、清理失效 Dex/So
家長控制/MDM:阻止特定 AppADDED對比黑名單、啟用 `DevicePolicyManager` 禁用/隱藏

常見坑點

  • 自身安裝/卸載不收到 ADDED/REMOVED:必須用 `MY_PACKAGE_REPLACED` 監聽自身更新。
  • 靜態接收器無 scheme 失效:Android 8.0+ 強制要求 ``。
  • Android 12+ exported 強制:靜態接收器必須顯式 `android:exported="true"`。
  • 動態註冊 RECEIVER_NOT_EXPORTED/EXPORTED:Android 13+ (API 33) 動態註冊**必須**指定旗標,否則 Crash。
  • 廣播有序 vs 普通**:套件廣播為**無序廣播**,無法攔截/修改結果,`onReceive` 執行時間限制 **10 秒** (前台) / **60 秒** (後台),耗時操作必須拋給 Service/WorkManager。

總結

掌握 **`PACKAGE_ADDED/REPLACED/REMOVED` + `data scheme=package` + `exported=true`** 靜態註冊模式,配合 **`MY_PACKAGE_REPLACED`** 監聽自身更新,並注意 **Android 11+ 套件可見性**、**Android 12+ exported 強制**、**Android 13+ 動態註冊旗標**,即可可靠實現應用安裝/更新/卸載監聽。業務邏輯務必在 `onReceive` 快速完成或轉交後台組件,避免 ANR。

copyright © 萬盛學電腦網 all rights reserved