萬盛學電腦網

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

Android 系統廣播接收完整指南:註冊、權限與最佳實踐

Android 廣播機制核心概念

BroadcastReceiver (廣播接收器) 是 Android 四大組件之一,用於接收系統或應用發送的廣播訊息。採用發布-訂閱模式,支援跨進程通訊。系統廣播由系統服務發送,如開機完成、網路變化、電池狀態、通話狀態等。

兩種註冊方式對比

特性靜態註冊 (Manifest)動態註冊 (程式碼)
生命週期應用安裝後常駐,即使應用未啟動也能接收隨註冊元件 (Activity/Service/Application) 生命週期
啟動延遲可能延遲 (系統需先啟動應用進程)即時,進程已運行
適用場景開機啟動、套件安裝/移除、系統級事件UI 相關、網路狀態、暫時性監聽
Android 8+ 限制大多數隱式廣播禁止靜態註冊不受限制
權限控制android:permission 屬性registerReceiver 參數指定

靜態註冊完整範例 (開機自啟)

<!-- AndroidManifest.xml -->
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="com.example.bootreceiver">
    
    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
    <!-- Android 10+ 需額外權限 -->
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
    
    <application ...>
        <receiver
            android:name=".BootCompleteReceiver"
            android:enabled="true"
            android:exported="true">  <!-- API 31+ 必須指定 exported -->
            <intent-filter>
                <action android:name="android.intent.action.BOOT_COMPLETED" />
                <!-- Android 8+ 需額外指定 -->
                <action android:name="android.intent.action.QUICKBOOT_POWERON" />
                <action android:name="com.htc.intent.action.QUICKBOOT_POWERON" /> <!-- HTC -->
            </intent-filter>
        </receiver>
        
        <!-- 若需在開機後啟動 Service,建議使用 JobScheduler/WorkManager -->
        <service
            android:name=".BootService"
            android:exported="false"
            android:foregroundServiceType="dataSync" />
    </application>
</manifest>
public class BootCompleteReceiver extends BroadcastReceiver {
    private static final String TAG = "BootCompleteReceiver";

    @Override
    public void onReceive(Context context, Intent intent) {
        String action = intent.getAction();
        Log.d(TAG, "Received: " + action);
        
        if (Intent.ACTION_BOOT_COMPLETED.equals(action) 
            || "android.intent.action.QUICKBOOT_POWERON".equals(action)) {
            
            // ⚠ 注意:onReceive 執行於主執行緒,限時 10 秒 (前台) / 60 秒 (背景)
            // 耗時操作必須啟動 Service 或 WorkManager
            
            // 方案一:啟動 Foreground Service (Android 8+ 必須)
            Intent serviceIntent = new Intent(context, BootService.class);
            ContextCompat.startForegroundService(context, serviceIntent);
            
            // 方案二:使用 WorkManager (推薦,延遲可接受)
            // WorkManager.getInstance(context).enqueue(new OneTimeWorkRequest.Builder(BootWork.class).build());
            
            // 方案三:安排 AlarmManager 精確鬧鐘
            // scheduleExactAlarm(context);
        }
    }
}

動態註冊完整範例 (網路狀態監聽)

public class NetworkMonitor {
    private static final String TAG = "NetworkMonitor";
    private final Context context;
    private final ConnectivityManager connectivityManager;
    private final NetworkCallback networkCallback;
    private boolean registered = false;

    public NetworkMonitor(Context context, OnNetworkChangeListener listener) {
        this.context = context.getApplicationContext();
        this.connectivityManager = (ConnectivityManager) context.getSystemService(Context.CONNECTIVITY_SERVICE);
        this.networkCallback = new NetworkCallback(listener);
    }

    /** 開始監聽 (在 onStart/onResume 呼叫) */
    public void start() {
        if (registered) return;
        
        NetworkRequest request = new NetworkRequest.Builder()
            .addCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
            .addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
            .addTransportType(NetworkCapabilities.TRANSPORT_CELLULAR)
            .addTransportType(NetworkCapabilities.TRANSPORT_ETHERNET)
            .build();
        
        connectivityManager.registerNetworkCallback(request, networkCallback);
        registered = true;
        Log.d(TAG, "Network monitoring started");
    }

    /** 停止監聽 (在 onStop/onPause 呼叫) */
    public void stop() {
        if (!registered) return;
        connectivityManager.unregisterNetworkCallback(networkCallback);
        registered = false;
        Log.d(TAG, "Network monitoring stopped");
    }

    private static class NetworkCallback extends ConnectivityManager.NetworkCallback {
        private final OnNetworkChangeListener listener;
        NetworkCallback(OnNetworkChangeListener listener) { this.listener = listener; }
        
        @Override
        public void onAvailable(@NonNull Network network) {
            Log.d(TAG, "Network available: " + network);
            if (listener != null) listener.onNetworkAvailable(network);
        }
        
        @Override
        public void onLost(@NonNull Network network) {
            Log.d(TAG, "Network lost: " + network);
            if (listener != null) listener.onNetworkLost(network);
        }
        
        @Override
        public void onCapabilitiesChanged(@NonNull Network network, @NonNull NetworkCapabilities capabilities) {
            boolean hasInternet = capabilities.hasCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET);
            boolean isWifi = capabilities.hasTransport(NetworkCapabilities.TRANSPORT_WIFI);
            boolean isCellular = capabilities.hasTransport(NetworkCapabilities.TRANSPORT_CELLULAR);
            if (listener != null) {
                listener.onCapabilitiesChanged(network, hasInternet, isWifi, isCellular);
            }
        }
    }

    public interface OnNetworkChangeListener {
        void onNetworkAvailable(Network network);
        void onNetworkLost(Network network);
        void onCapabilitiesChanged(Network network, boolean hasInternet, boolean isWifi, boolean isCellular);
    }
}

// 在 Activity/Fragment 中使用
public class MainActivity extends AppCompatActivity {
    private NetworkMonitor networkMonitor;
    private TextView statusText;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        statusText = findViewById(R.id.status_text);
        networkMonitor = new NetworkMonitor(this, new NetworkMonitor.OnNetworkChangeListener() {
            @Override
            public void onNetworkAvailable(Network network) {
                runOnUiThread(() -> statusText.setText("網路已連線"));
            }
            @Override
            public void onNetworkLost(Network network) {
                runOnUiThread(() -> statusText.setText("網路已斷開"));
            }
            @Override
            public void onCapabilitiesChanged(Network network, boolean hasInternet, boolean isWifi, boolean isCellular) {
                runOnUiThread(() -> {
                    String type = isWifi ? "Wi-Fi" : (isCellular ? "行動網路" : "其他");
                    statusText.setText("網路: " + type + (hasInternet ? " (有網際網路)" : " (無網際網路)"));
                });
            }
        });
    }

    @Override
    protected void onStart() {
        super.onStart();
        networkMonitor.start();
    }

    @Override
    protected void onStop() {
        super.onStop();
        networkMonitor.stop();
    }
}

常用系統廣播動作清單

Action 常數觸發時機靜態註冊限制 (Android 8+)關鍵 Extra
ACTION_BOOT_COMPLETED開機完成允許無
ACTION_POWER_CONNECTED/DISCONNECTED充電器連接/斷開禁止無
ACTION_BATTERY_LOW/OKAY電量低/恢復禁止level, scale, plugged
ACTION_BATTERY_CHANGED電池狀態變化 (黏性廣播)僅動態註冊level, scale, status, health, technology, temperature, voltage
CONNECTIVITY_ACTION (棄用)網路連線變化禁止networkInfo, bFailover
ACTION_AIRPLANE_MODE_CHANGED飛航模式切換允許state (boolean)
TelephonyManager.ACTION_PHONE_STATE_CHANGED通話狀態變化允許 (需 READ_PHONE_STATE)state, incoming_number
ACTION_NEW_OUTGOING_CALL撥出電話允許 (需 PROCESS_OUTGOING_CALLS)EXTRA_PHONE_NUMBER
ACTION_SCREEN_ON/OFF螢幕開啟/關閉僅動態註冊無
ACTION_USER_PRESENT使用者解鎖允許無
ACTION_TIME_CHANGED/TICK時間變更/每分鐘允許/僅動態無
ACTION_LOCALE_CHANGED語言/地區變更允許無
ACTION_CONFIGURATION_CHANGED配置變更 (旋轉、字體等)禁止無
MediaStore.ACTION_MEDIA_MOUNTED/UNMOUNTED外部儲存掛載/卸載允許data (URI)
ACTION_PACKAGE_ADDED/REMOVED/REPLACED應用安裝/移除/更新允許data (package:...), EXTRA_UID, EXTRA_REPLACING

Android 8.0+ (API 26) 隱式廣播限制應對策略

Android 8.0 限制應用在 Manifest 中靜態註冊隱式廣播 (無明確指定目標套件/元件的廣播)。例外清單:

  • ACTION_BOOT_COMPLETED
  • ACTION_LOCKED_BOOT_COMPLETED
  • ACTION_MY_PACKAGE_REPLACED
  • ACTION_PACKAGE_ADDED/REMOVED (僅針對自身套件)
  • ACTION_TIMEZONE_CHANGED
  • ACTION_LOCALE_CHANGED
  • 完整清單參考 官方文件

替代方案

  1. 動態註冊:在 Service/Application/Activity 中 registerReceiver
  2. JobScheduler / WorkManager:網路、充電、閒置條件觸發
  3. Foreground Service + startForeground:長期運行監聽
  4. CompanionDeviceManager:配對裝置監聽

發送自訂廣播

// 發送有序廣播 (有序執行,可攔截、修改、中止)
Intent intent = new Intent("com.example.CUSTOM_ACTION");
intent.putExtra("data", "custom data");
sendOrderedBroadcast(intent, Manifest.permission.MY_CUSTOM_PERMISSION, 
    new BroadcastReceiver() {
        @Override
        public void onReceive(Context context, Intent intent) {
            // 最終接收者,可獲取結果
            Log.d("CustomBroadcast", "Final result: " + getResultData());
        }
    }, null, Activity.RESULT_OK, "initial data", null);

// 發送黏性廣播 (已棄用 API 21+,改用持久化儲存)
// sendStickyBroadcast(intent);

// 本地廣播 (進程內,效能高、安全) - LocalBroadcastManager 已棄用,建議用 LiveData/Flow/EventBus
// LocalBroadcastManager.getInstance(context).sendBroadcast(localIntent);

安全性最佳實踐

  1. android:exported="false":不需跨應用接收的 Receiver 設為 false
  2. android:permission:要求發送者持有特定權限 (如 android.permission.SEND_SMS)
  3. Intent.setPackage():發送時限定目標套件,避免洩漏
  4. 驗證發送者:onReceive 中檢查 intent.getAction()、intent.getPackage()、權限
  5. 本地通訊用 LocalBroadcastManager/LiveData/Flow:不離開進程,零 IPC 開銷

總結

Android 廣播機制強大但需注意版本限制。核心原則:

  • 靜態註冊僅用於開機、套件變更等系統級白名單廣播
  • 動態註冊配合元件生命週期,避免洩漏
  • 網路/電池/螢幕狀態改用 ConnectivityManager.NetworkCallback、BatteryManager、PowerManager 現代 API
  • 應用內通訊優先使用 LiveData、Flow、EventBus
  • 發送廣播明確指定目標或權限,保護資料安全
copyright © 萬盛學電腦網 all rights reserved