Android11 Notification功能解析

Posted 2023-04-07

参考技术A        我们知道，当手机有通知时，下拉通知中心中会显示所有的通知，该功能是在SystemUI中实现的，接着上篇文章 android11 SystemUI解析 ，本文对通知相关的功能逻辑进行分析，基于Android11 CarSystemUI的通知功能逻辑展开分析。
       关于通知功能逻辑，简单来说，无非就是四步，注册、发送、接收、显示，那么接下来针对以上四步进行源码详细分析。

       关于CarSystemUI启动及相关逻辑可以参考文章 Android11 SystemUI解析 ，本文就不赘述了，直接以NotificationPanelViewController类为入口进行分析：

       从构造方法来看：

       可以看到，在创建以上实例时，会通过Inject的方式来创造对应参数的实例，该功能是通过dagger2来实现，具体对应的Module为CarNotificationModule类，看一下CarNotificationListener实例创造时的实现，关于NotificationViewController后面再分析：

       可以看到，在provideCarNotificationListener()提供CarNotificationListener实例时，还执行了registerAsSystemService()方法，接下来看一下CarNotificationListener类：

       CarNotificationListener继承了NotificationListenerService类，该类继承了Service，是framework内部的组成部分，通过registerAsSystemService()来看一下该类的实现：

       该方法内部主要执行了两项操作：
       a.创建了NotificationListenerWrapper对象，该类继承了INotificationListener.Stub，主要用来接收回调，后面在显示环节进行详细分析；

       b.将以上对象作为参数通过INotificationManager的registerListener进行注册；

       通过getNotificationInterface()的是实现可以知道，registerListener()执行到了NotificationManagerService里面去了，接下来一起看一下：

       mListeners是NotificationListeners实例，是在init()中进行初始化的，NotificationListeners是其内部类，看一下具体实现：

       NotificationListeners继承了ManagedServices，registerSystemService方法是在ManagedServices里面实现的，看一下：

       根据调用关系，registerServiceImpl()方法内先将前面创建的INotificationListener(mWrapper)作为参数创建了ManagedServiceInfo实例info，然后执行linkToDeath进行死亡监测，最后将info加入mServices中进行管理，执行完后再执行onServiceAdded(info)，该方法是在NotificationListeners类内部实现的，再回去看一下该方法，最终会调用到CarNotificationListener.java里面的onListenerConnected()方法。
       以上注册过程逻辑比较绕，用一张图来总结一下：

       发送过程比较简单，按照系统提供的方法来发送即可，主要涉及NotificationChannel、Notification、NotificationManager这三个类，简单看一下：
       首先某个应用在发送通知前需要创建该应用对应的NotificationChannel，然后在通知中传入对应channel ID就可以了，创建如下：

       在创建NotificationChannel时需要传入唯一的id、name和importance，创建如下：

       创建完NotificationChannel后，再创建Notification，Notification创建采用的是Builder模式，主要涉及的内容比较多，创建如下：

       Notification涉及的内容比较多，可以根据需要进行设定；

       创建完Notification后，通过NotificationManger来进行发送就可以了：

       执行完notify后续的逻辑处理过程，在接收环节进行分析；

       发送时会调用到notify()方法：

       跟随调用关系，会调用到notifyAsUser()方法：

       在notifyAsUser()会调用到NotificationManagerService中的enqueueNotificationWithTag()方法，先看一下fixNotification()方法：

       需要注意一下：当应用targetSdkVersion大于22时，在创建Notification时需要传入smallIcon，否则会抛异常导致发送不成功；接下来看一下enqueueNotificationWithTag()方法：

       NotificationManagerService继承了SystemService，在SystemServer中会进行启动，在start()方法内部会执行publishBinderService来进行Binder注册提供服务：

       可以看到，enqueueNotificationWithTag()会调用到enqueueNotificationInternal()，该方法是真正的逻辑实现：

       该方法中主要做了以下几件事：
       1.进行各种check来确保notification的合法性；
       2.将Notification作为参数创建StatusBarNotification；
       3.获取Notification对应的channel id，根据channel id 来获取应用对应的NotificationChannel，如果为空的话，就直接返回了，因此应用在发送notification前需要先创建对应NotificationChannel；
       4.通过Handler post EnqueueNotificationRunnable来执行后续逻辑；

       在EnqueueNotificationRunnable内部会将r(NotificationRecord)加入mEnqueuedNotifications进行管理，然后判断该NotificationRecord是否已经存在过，最后执行PostNotificationRunnable；

       PostNotificationRunnable的run()中主要处理逻辑如下：
       1.从mEnqueuedNotifications中找到跟key对应的NotificationRecord；
       2.通过indexOfNotificationLocked()看mNotificationList里面是否已经包含该NotificationRecord，如果不存在，说明是新的record，需要加入mNotificationList进行管理；否则的话，将mNotificationList中index对应的NotificationRecord进行更新；
       3.将要处理的NotificationRecord放入mNotificationsByKey进行管理；
       4.执行mListeners.notifyPostedLocked(r, old)来进行通知；
       5.在finally里面将要处理的NotificationRecord从mEnqueuedNotifications里面移除；
       6.如果在加入后有取消操作，需要立刻执行取消操作，并将NotificationRecord从mDelayedCancelations中移除；

       前面讲到，在PostNotificationRunnable中会执行mListeners.notifyPostedLocked(r, old)进行通知，mListeners是NotificationListeners实例：

       跟随调用关系：

       通过getServices()来找到已经注册过的ManagedServiceInfo列表，最后执行notifyPosted()；

       在notifyPosted()内部通过info.service来找到对应的INotificationListener实例，对应NotificationListenerService内部的NotificationListenerWrapper，然后将StatusBarNotification封装成StatusBarNotificationHolder，最后执行NotificationListenerWrapper的onNotificationPosted()方法：

       最终会通过Handler来发送消息来进行处理；

       onNotificationPosted(sbn, rankingMap)是在CarNotificationListener内部实现的；

       在CarNotificationListener内部会将StatusBarNotification封装成AlertEntry，然后执行notifyNotificationPosted()：

       一步一步调用：

       先将alertEntry存入mActiveNotifications进行管理；然后执行sendNotificationEventToHandler发送NOTIFY_NOTIFICATION_POSTED消息；

       该Handler是通过setHandler来赋值的，具体是在什么地方呢？
       这个需要回到最前面NotificationPanelViewController里面了，前面说到NotificationViewController是在显示环节进行分析，轮到NotificationViewController登场了；

       NotificationViewController是在NotificationPanelViewController实例化，并执行enable()方法，先看一下构造方法：

       在构造方法内部，会传入CarNotificationView、CarNotificationListener、PreprocessingManager等实例，都是跟显示有关的核心类；
       1.CarNotificationView：负责处理通知显示；
       2.PreprocessingManager：负责管理通知，通过CarNotificationListener来获取通知；
       3.CarNotificationListener：跟NotificationManagerService间接交互的类；

       可以看到Handler是在NotificationViewController里面实现的，当有消息到来时，如果CarNotificationView显示时执行updateNotifications()来直接显示通知；不显示时执行resetNotifications()来对通知进行管理；

       以上就是Notification的整个工作过程，最后用一张流程图来总结一下：

Android开发系列（二十四）：Notification的功能与使用方法

关于消息的提示有两种：一种是Toast，一种就是Notification。前者维持的时间比較短暂，后者维持的时间比較长。

并且我们寻常手机的应用比方网易、贴吧等等都有非常多的推送消息。就是用Notification实现的。

Notification是显示在手机状态栏的通知—手机状态栏位于手机屏幕的上方。程序一般通过NotificationManager服务来发送Notification通知

Notification的一些方法。接下来我们都可以用到：

setDefaults()：设置通知LED等、音乐、震动等等。

setAutoCancel()：设置点击通知后。状态栏自己主动删除通知。

setContentTitle()：设置通知的标题

setContentText()：设置通知的内容

setTicker()：设置通知的提示信息

setSmallIcon()：为通知设置图标（注意这种方法第三个是i的大写。不是L的小写）

发送Notification的步骤：

1、调用getSystemService(NOTIFICATION_SERVICE)方法获取系统的Notification Manager服务

2、通过构造器创建一个Notification对象。

3、为Notification设置各种属性。

4、通过NotificationManager发送Notification。

在这里，我们要注意一点要在AndroidManifest.xml文件里加入几个权限：

<!-- 加入操作闪光灯的权限 -->
<uses-permission android:name="android.permission.FLASHLIGHT" />
<!-- 加入操作振动器的权限 -->
<uses-permission android:name="android.permission.VIBRATE" />

接下来，我们通过详细的代码来说明。

main.xml:

<span style="font-size:14px;"><?xml version="1.0" encoding="utf-8"?
>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
	android:orientation="horizontal"
	android:layout_width="fill_parent"
	android:layout_height="fill_parent"
	android:gravity="center_horizontal"
	>
<Button
	android:layout_width="wrap_content" 
	android:layout_height="wrap_content" 
	android:text="发送Notification"
	android:onClick="send"
	/>

</LinearLayout>
</span>

这里设置了一个button。点击会发送通知

然后。我们看下NotificationTest.java的代码：

<span style="font-size:14px;">package cn.notificationtest.com;

import cn.notificationtest.com.R;

import android.app.Activity;
import android.app.Notification;
import android.app.NotificationManager;
import android.app.PendingIntent;
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
import android.view.View;


public class NotificationTest extends Activity
{
	static final int NOTIFICATION_ID = 0x123;
	NotificationManager nm;

	@Override
	public void onCreate(Bundle savedInstanceState)
	{
		super.onCreate(savedInstanceState);
		setContentView(R.layout.main);
		// 获取系统的NotificationManager服务
		nm = (NotificationManager) 
			getSystemService(NOTIFICATION_SERVICE);
	}

	// 为发送通知的button的点击事件定义事件处理方法
	public void send(View source)
	{
		// 创建一个启动其它Activity的Intent
		Intent intent = new Intent(NotificationTest.this
			, OtherActivity.class);
		PendingIntent pi = PendingIntent.getActivity(
			NotificationTest.this, 0, intent, 0);
		Notification notify = new Notification.Builder(this)
			// 设置打开该通知。该通知自己主动消失
			.setAutoCancel(true)
			// 设置显示在状态栏的通知提示信息
			.setTicker("网易新闻")
			// 设置通知的图标
			.setSmallIcon(R.drawable.notify)
			// 设置通知内容的标题
			.setContentTitle("这是新闻标题")
			// 设置通知内容
			.setContentText("这是新闻的内容：*************")
			// // 设置使用系统默认的声音、默认LED灯
			// .setDefaults(Notification.DEFAULT_SOUND
			// |Notification.DEFAULT_LIGHTS)
			// 设置通知的自己定义声音
			.setSound(Uri.parse("android.resource://cn.notificationtest.com/"+R.raw.msg))
			.setWhen(System.currentTimeMillis())
			// 设改通知将要启动程序的Intent
			.setContentIntent(pi).getNotification();
		// 发送通知
		nm.notify(NOTIFICATION_ID, notify);
	}
}</span>

在这个java文件里，我们通过构造器创建了一个Notification对象。然后为Notification设置各种属性。最后通过NotificationManager发送Notification。

（这里须要注意的一点是，我们定义的声音，图标什么的都是个人创建）


通过上边的java代码，我们创建了一个Intent对象，能够通过这条通知。切换到另外的一个Activity界面：OtherActivity

<span style="font-size:14px;">/**
 *
 */
package cn.notificationtest.com;

import cn.notificationtest.com.R;

import android.app.Activity;
import android.os.Bundle;

public class OtherActivity extends Activity
{
	@Override
	public void onCreate(Bundle savedInstanceState)
	{
		super.onCreate(savedInstanceState);
		//设置该Activity显示的页面
		setContentView(R.layout.other);
	}
}
</span>

效果图例如以下所看到的：