全局大喇叭——BroadcastReceiver
本篇文章记述了Android的四大组件之一 —— BroadcastReceiver(广播接收者)。广播的作用、广播注册的方式、自定义广播、广播的类型以及在较新的Android系统中使用BroadcastReceiver需要注意的问题。Android 应用与 Android 系统和其他 Android 应用之间可以相互收发广播消息,这与发布-订阅设计模式相似,这些广播会在所关注的事件发生时发送出去。
关于系统广播
举例来说,Android 系统会在发生各种系统事件时发送广播,例如系统启动或设备开始充电时。应用可以发送自定义广播来通知其他应用它们可能感兴趣的事件(例如,一些新数据已下载)。应用可以注册接收特定的广播。广播发出后,系统会自动将广播传送给同意接收这种广播的应用。
系统会在发生各种系统事件时自动发送广播,例如当系统进入和退出飞行模式时,系统广播会被发送给所有同意接收相关事件的应用,或者在手机低电量的时候,系统也会发出一个手机电量低的广播:
常见的系统广播:
1<!-- 开机广播 -->
2<action android:name="android.intent.action.BOOT_COMPLETED"/>
3
4<!-- 开始充电广播 -->
5<action android:name="android.intent.action.ACTION_POWER_CONNECTED"/>
6
7<!-- 低电量广播 -->
8<action android:name="android.intent.action.BATTERY_LOW"/>
9
10<!-- 应用卸载广播 -->
11<action android:name="android.intent.action.PACKAGE_REMOVED"/>
12
13<!-- 应用安装广播 -->
14<action android:name="android.intent.action.PACKAGE_ADDED"/>
15
16<!-- 声明这个数据类型才可以收到应用安装/卸载的广播 -->
17<data android:scheme="package"/>
18
19<... />
系统广播的注册
应用程序可以通过两种方式接收广播:通过清单文件声明的广播接收者和上下文注册的广播接收者。
静态注册
首先作为四大组件之一肯定是要在清单文件声明的,创建一个AppReceiver用来接收App安装和卸载的广播,此类要继承BroadcastReceiver:
1public class AppReceiver extends BroadcastReceiver {
2 private static final String TAG = "AppReceiver";
3
4 @Override
5 public void onReceive(Context context, Intent intent) {
6 // 接收广播
7 if(intent != null){
8 // 判断收到的是什么广播
9 String action = intent.getAction();
10 assert action != null;
11 switch (action){
12 case Intent.ACTION_PACKAGE_REMOVED:
13 Log.i(TAG, "onReceive: ACTION_PACKAGE_REMOVED " + "应用被卸载");
14 break;
15 case Intent.ACTION_PACKAGE_ADDED:
16 Log.i(TAG, "onReceive: ACTION_PACKAGE_ADDED " + "应用被安装");
17 break;
18 }
19 }
20 }
21}
AndroidManifest.xml
1<!-- 静态注册广播接收者 -->
2<receiver android:name=".AppReceiver"
3 android:enabled="true"
4 android:exported="true">
5 <intent-filter>
6 <!-- 应用卸载广播 -->
7 <action android:name="android.intent.action.PACKAGE_REMOVED"/>
8 <!-- 应用安装广播 -->
9 <action android:name="android.intent.action.PACKAGE_ADDED"/>
10 <!-- 声明这个数据类型才可以收到应用安装/卸载的广播 -->
11 <data android:scheme="package"/>
12 </intent-filter>
13</receiver>
在进行应用卸载和安装的时候,就可以收到对应的广播了:
动态注册
AppReceiver.java还是和上面的一样,但是现在不在AndroidManifest.xml中声明,而是使用动态注册的方式,下面的例子演示了如何在Activity创建的动态的注册广播接收者:
MainActivity.java
1public class MainActivity extends AppCompatActivity {
2
3 private BroadcastReceiver receiver;
4
5 @Override
6 protected void onCreate(Bundle savedInstanceState) {
7 super.onCreate(savedInstanceState);
8 setContentView(R.layout.activity_main);
9 // 新建一个广播接收器
10 receiver = new AppReceiver();
11
12 // 接收哪些广播
13 IntentFilter intentFilter = new IntentFilter();
14 intentFilter.addDataScheme("package");
15 intentFilter.addAction(Intent.ACTION_PACKAGE_ADDED);
16 intentFilter.addAction(Intent.ACTION_PACKAGE_REMOVED);
17
18 // 注册广播接收者
19 registerReceiver(receiver, intentFilter);
20 }
21
22 @Override
23 protected void onDestroy() {
24 super.onDestroy();
25 // 取消注册广播接收器(不取消会导致内存泄漏)
26 if(receiver != null){
27 unregisterReceiver(receiver);
28 }
29 }
30}
不过动态注册广播接收者千万别忘记在Activity销毁的时候解除之前注册的广播接收者。
静态注册需要在AndroidManifest.xml中声明,只要APP启动过一次,所静态注册的广播就会生效,无论当前的APP处于停止使用还是正在使用状态。只要相应的广播事件发生,系统就会遍历所有的清单文件,通知相应的广播接收者接收广播,然后调用广播接收者的onReceiver方法。
动态注册动态注册方式依赖于所注册的组件,当APP关闭后,组件对象都不在了动态注册的代码都不存在了,所动态注册监听的Action自然就不再生效了。静态注册的广播传播速度要远远慢于动态注册的广播。
如果即使用了动态注册,又使用了静态注册,那么动态动态注册的广播的优先级大于静态注册的广播。
广播的生命周期
1、BroadCastReceiver 的生命周期很短暂,当接收到广播的时候创建,当onReceive()方法结束后销毁
2、正因为BroadCastReceiver的声明周期很短暂,所以不要在广播接收器中去创建子线程做耗时的操作,因为广播接受者被销毁后,这个子进程就会成为空进程,很容易被杀死
3、因为BroadCastReceiver是运行在主线程的,所以不能直接在BroadCastReceiver中去做耗时的操作,否则就会出现ANR异常 ,耗时的较长的工作最好放到Service中去完成。这里不能使用子线程来解决 , 因为BroadcastReceiver的生命周期很短,子线程可能还没有结束BroadcastReceiver就先结束了,BroadcastReceiver一旦结束,此时BroadcastReceiver的所在进程很容易在系统需要内存时被优先杀死,因为它属于空进程 ( 没有任何活动组件的进程 ),如果它的宿主进程被杀死,那么正在工作的子线程也会被杀死,所以采用子线程来解决是不可靠的。
自定义Broadcast
MainActivity.java
1public class MainActivity extends AppCompatActivity {
2
3 public static final String MY_ACTION = "cn.tim.action.MY_ACTION";
4 public static final String MY_ACTION_EXTRA_KEY = "input_content";
5 private EditText etContent;
6 private CustomReceiver receiver;
7
8 @Override
9 protected void onCreate(Bundle savedInstanceState) {
10 super.onCreate(savedInstanceState);
11 setContentView(R.layout.activity_main);
12 etContent = findViewById(R.id.et_content);
13 TextView tvShow = findViewById(R.id.tv_show);
14
15 receiver = new CustomReceiver();
16 receiver.tvShow = tvShow;
17
18 IntentFilter filter = new IntentFilter();
19 filter.addAction(MY_ACTION);
20 registerReceiver(receiver, filter);
21 }
22
23 public void send(View view) {
24 // 新建广播
25 Intent intent = new Intent(MY_ACTION);
26 // 放入广播要携带的数据
27 intent.putExtra(MY_ACTION_EXTRA_KEY, etContent.getText().toString());
28 sendBroadcast(intent);
29 }
30
31 @Override
32 protected void onDestroy() {
33 super.onDestroy();
34 // 解除注册
35 if(receiver != null){
36 unregisterReceiver(receiver);
37 }
38 }
39}
CustomReceiver.java
1public class CustomReceiver extends BroadcastReceiver {
2 TextView tvShow;
3
4 @Override
5 public void onReceive(Context context, Intent intent) {
6 if(intent != null){
7 String action = intent.getAction();
8 if(MainActivity.MY_ACTION.equals(action)){
9 String inputContent = intent.getStringExtra(MainActivity.MY_ACTION_EXTRA_KEY);
10 tvShow.setText(inputContent);
11 }
12 }
13 }
14}
不同的应用间通信,也是上面同样的代码,只要写相同的ACTION,那么就OK了:
Broadcast分类
广播的发送,可以分为有序广播、无序广播、本地广播以及粘性广播。
有序广播
有序广播是一种分先后广播接收器的广播,广播接收者的优先级越高,越先接收广播。优先级高的广播先收到广播,收到广播后可以修改广播的内容,也可以拦截广播不让广播向下传递。
如果在CReceiver中终止广播,那么优先级比较低的A与B都收不到广播了。
MainActivity.java
1public class MainActivity extends AppCompatActivity {
2 public static final String MY_ACTION = "cn.tim.action.MY_ACTION";
3 public static final String KEY = "cn.tim.action.MY_ACTION";
4
5 @Override
6 protected void onCreate(Bundle savedInstanceState) {
7 super.onCreate(savedInstanceState);
8 setContentView(R.layout.activity_main);
9
10 // 新建广播
11 Intent intent = new Intent(MY_ACTION);
12 // 放入广播要携带的数据
13 Bundle bundle = new Bundle();
14 bundle.putInt(KEY, 100);
15 intent.putExtras(bundle);
16 //sendBroadcast(intent);
17
18 // 发送顺序广播,参数二:权限
19 sendOrderedBroadcast(intent, null);
20 }
21}
22
注意:如果要修改数据的话前提得是Intent发送数据得格式必须是Bundle。
1// 优先级 2
2public class CReceiver extends BroadcastReceiver {
3 @Override
4 public void onReceive(Context context, Intent intent) {
5 if(intent != null){
6 String action = intent.getAction();
7 if(MainActivity.MY_ACTION.equals(action)){
8 Bundle bundle = intent.getExtras();
9 Toast.makeText(context, "C:" + bundle.getInt(MainActivity.KEY), Toast.LENGTH_SHORT).show();
10 Bundle newBundle = new Bundle();
11 newBundle.putInt(MainActivity.KEY, 90);
12 setResultExtras(newBundle);
13 }
14 }
15 }
16}
17
18// 优先级 1
19public class AReceiver extends BroadcastReceiver {
20 @Override
21 public void onReceive(Context context, Intent intent) {
22 if(intent != null){
23 String action = intent.getAction();
24 if(MainActivity.MY_ACTION.equals(action)){
25 Bundle bundle = getResultExtras(true);
26 Toast.makeText(context, "A:" + bundle.getInt(MainActivity.KEY), Toast.LENGTH_SHORT).show();
27 Bundle newBundle = new Bundle();
28 newBundle.putInt(MainActivity.KEY, 80);
29 setResultExtras(newBundle);
30 }
31 }
32 }
33}
34
35// 优先级 0
36public class BReceiver extends BroadcastReceiver {
37 @Override
38 public void onReceive(Context context, Intent intent) {
39 if(intent != null){
40 String action = intent.getAction();
41 if(MainActivity.MY_ACTION.equals(action)){
42 Bundle bundle = getResultExtras(true);
43 Toast.makeText(context, "B:" + bundle.getInt(MainActivity.KEY), Toast.LENGTH_SHORT).show();
44 }
45 }
46 }
47}
无序广播
无序广播指所有与之匹配的广播接收者都能收到广播,没有先后顺序,直到没有广播接收者接收广播为止才会停止广播的传递。
默认情况下有广播发送时,系统会遍历全部APP的Receiver。如果想使得本APP的Receiver不被外界的广播所干扰,可以在Receiver节点添加android:exported=“false"属性,这样系统遍历全部APP清单文件的广播接收者时不会对本App的Receiver进行判断及处理。
本地广播
本地广播仅仅在APP内传播,其他的程序无法收到这个广播。这种广播保证安全性,不会传播到外界。同时由于LocalBroadcastManager不需要用到跨进程机制,因此相对 BroadcastReceiver 而言要更为高效。LocalBroadcastManager只在动态广播时使用,静态广播不能使用LocalBroadcastManager。
1implementation 'androidx.localbroadcastmanager:localbroadcastmanager:1.0.0'
MainActivity.java
1public class MainActivity extends AppCompatActivity {
2 public static final String MY_NEW_ACTION = "cn.tim.action.MY_NEW_ACTION";
3
4 private LocalReceiver localReceiver;
5 private LocalBroadcastManager localBroadcastManager;
6
7 @Override
8 protected void onCreate(Bundle savedInstanceState) {
9 super.onCreate(savedInstanceState);
10 setContentView(R.layout.activity_main);
11
12 // 获得LocalBroadcastManager对象
13 localBroadcastManager = LocalBroadcastManager.getInstance(this);
14 // 动态注册广播
15 localReceiver = new LocalReceiver();
16 IntentFilter filter = new IntentFilter();
17 filter.addAction(MY_NEW_ACTION);
18 localBroadcastManager.registerReceiver(localReceiver, filter);
19 }
20
21 public void sendLocalBroadcast(View view) {
22 // 发送本地广播
23 Intent intent = new Intent(MY_NEW_ACTION);
24 localBroadcastManager.sendBroadcast(intent);
25 }
26
27
28 static class LocalReceiver extends BroadcastReceiver {
29 @Override
30 public void onReceive(Context context, Intent intent){
31 Toast.makeText(context,"Received LocalBroadcast!",Toast.LENGTH_SHORT).show();
32 }
33 }
34
35 @Override
36 protected void onDestroy() {
37 super.onDestroy();
38 localBroadcastManager.unregisterReceiver(localReceiver);
39 }
40}
new SDK中使用广播
随着 Android 平台的发展,它会不定期地更改系统广播的行为方式。如果要在Android 7.0(API 级别 24)或更高版本的SDK使用广播,必须注意以下更改:
Android 7.0 API 24
Android 7.0(API 级别 24)及更高版本不发送以下系统广播:
此外,以 Android 7.0 及更高版本为目标平台的应用必须使用动态注册的方式,无法在清单中声明广播接收器,所以以后所有广播直接全部使用动态注册的方式吧,如果非要用静态注册的方式,可以发送显式广播,(即指定指定包名再发送,但是我们有时不知道有谁要接收广播,所以显式广播用的比较少),这个时候可以在发送广播的时候携带intent.addFlags(0x01000000); 就能让广播突破隐式广播限制,但是依旧不建议静态注册,还是动态注册比较好。
Android 9.0 API 28
从 Android 9(API 级别 28)开始,NETWORK_STATE_CHANGED_ACTION广播不再接收有关用户位置或个人身份数据的信息。通过 WLAN 接收的系统广播不包含 SSID、BSSID连接信息或扫描结果,如果要获取这些信息,可以调用 WifiManager.getConnectionInfo()。
关于广播的文档可以看这里: 《Receiving broadcasts》