从零开始--系统深入学习android(实践-让我们开始写代码-Android框架学习-7.通知)
通知
一个通知是一条消息他是显示于你应用程序之外的一个界面中。当你告诉系统要发布一个通知时,它首先作为一个icon出现在通知区域。为了看见通知的细节,用户可以点击通知区域展开一个新的界面。下面让我们来看一下图7-1和图7-2:
图7-1 通知出现在通知区域
图7-2 通知展开后的效果(drawer)
注意:除非特别注明外,本章指的都是NotificationCompat.Builder,它在v4 Support Library中有,正式添加于API Level 15。但有了v4 Support Library低版本系统也能用。另外Notification.Builder添加于android3.0。
7.1 通知显示元素
通知有两种可视化风格,它取决于版本和drawer的状态:
标准view
在drawer中标准的通知view
大型view
一个比较大的view。这个view是通知扩展的一个部分,这个功能被添加于android 4.1。
7.1.1正常view
一个标准view一般高位64dp。即使你创建一个大的view风格,直到它展开之前他仍然出现在标准view中。如图7-3:
图7-3 在标准view下的通知
以下是每个部分的说明:
1. 内容标题
2. 大型icon
3. 内容text
4. 内容info
5. 小型icon
6. 发布通知的时间。你能使用setWhen()设置一个明确的值。
7.1.2大型view
当通知被展开时,大型view才会出现并显示,一般由用户使用展开手势,通知drawer会被展开。展开的通知在android 4.1上才可用。如图7-4所示:
图7-4 在大型view下的通知
注意大型View大部分的视觉元素与正常的视图共享。仅仅不同的地方是编号为数字7的地方,这个细节区域。各大View风格设置有些不同。可用的风格有:
Big picture style
细节区域包含一个256dp高度的bitmap在它的细节部分。
Big text style
在细节部分显示一个大型文本块。
Inbox style
在细节部分显示文本行数。
下面是大型view可用,但标准view不可用的风格:
Big content title
允许你覆盖标准view的内容标题,使之出现在展开view中
Summary text
允许你在细节区域添加文本行数。
7.2 创建一个通知
你想在NotificationCompat.Builder对象中为通知指定UI信息和动作,就必须先使用NotificationCompat.Builder.build()来创建通知,这个方法会返回一个Notification对象,为了发布通知,你可以通过调用NotificationManager.notify()来传递Notification对象到系统中。
7.2.1必须的通知内容
一个Notification对象必须包含以下内容:
通过setSmallIcon()设置一个小的icon
通过setContentTitle()来设置一个标题
通过setContentText()来设置细节文本
7.2.2可选的通知的内容和设置
所有其他通知设置和内容都是可选的,具体可参考API NotificationCompat.Builder类
7.2.3通知动作(action)
虽然它们是可选的,你应该至少添加一个动作到你的通知中。一个动作允许用户直接从通知到一个你应用程序的Activity中。一个通知能提供多个动作。你应该总是定义一个动作,当用户点击通知时,触发它。通常这个动作打开一个你应用程序中的Activity。你也能添加按钮到通知中(Android 4.1中加入的新功能),用来执行额外的动作,如一个警告或即时响应的文本消息。如果你使用附加的动作按钮,你必须让他们的功能在一个Activity中可用。在通知里面,这个动作通过PendingIntent来定义,请使用NotificationCompat.Builder中合适的方法来创建。例如,当用户在Drawer中点击通知文本的时候,你想要启动Activity,你就可以通过调用setContentIntent()来添加一个PendingIntent。用户点击通知启动一个Activity是最常见的情况。请记住在Androird4.1或更高版本中,你才能从一个动作按钮中启动一个Activity。
7.2.4 创建一个简单的通知
以下代码片段是一个简单的例子,当一个用户点击通知时会打开一个activity。注意此段代码创建一个TaskStackBuilder对象并使用它创建一个PendingIntent。如代码清单7-1所示:
NotificationCompat.Builder mBuilder = new NotificationCompat.Builder(this) .setSmallIcon(R.drawable.notification_icon) .setContentTitle("My notification") .setContentText("Hello World!"); Intent resultIntent = new Intent(this, ResultActivity.class); TaskStackBuilder stackBuilder = TaskStackBuilder.create(this); stackBuilder.addParentStack(ResultActivity.class); stackBuilder.addNextIntent(resultIntent); PendingIntent resultPendingIntent = stackBuilder.getPendingIntent( 0, PendingIntent.FLAG_UPDATE_CURRENT ); mBuilder.setContentIntent(resultPendingIntent); NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); mNotificationManager.notify(mId, mBuilder.build());
代码清单 7-1
7.2.5 应用一个大型的view风格到通知中
当一个通+知展开后出现一个大型的view,首先创建一个你想要的NotificationCompat.Builder对象。然后调用Builder.setStyle()传入大型view的风格对象。记住android4.1之前的版本是不可用的。当然后面我们会讲解如何兼容低版本。下面代码清单7-2是在7-1上做了适当修改:
NotificationCompat.Builder mBuilder = new NotificationCompat.Builder(this) .setSmallIcon(R.drawable.notification_icon) .setContentTitle("Event tracker") .setContentText("Events received") NotificationCompat.InboxStyle inboxStyle = new NotificationCompat.InboxStyle(); String[] events = new String[6]; inboxStyle.SetBigContentTitle("Event tracker details:"); ...for (int i=0; i < events.length; i++) { inboxStyle.addLine(events[i]); } mBuilder.setStyle(inBoxStyle); ...
代码清单 7-2
7.2.6 处理兼容性
并不是所有通知功能都用于特别的版本。例如动作按钮,依赖于展开的通知,它只出现于android 4.1和高版本中。因为只有在这个版本上展开的通知才可用。为了确保最好的兼容性,请使用NotificationCompat及其子类创建通知,最好是用NotificationCompat.Builder,此外当你实现一个通知,请遵循以下过程:
1. 不管用户使用什么系统版本,都应该提供通知所有的功能给所有用户,为了做到这一点,需要在一个activity中验证所有的功能可用。你可能想要添加一个新的Activity。例如,如果您想要使用addAction()来控制停止和启动媒体播放,首先需要在一个Activity中实现这个控制。
2. 当用户点击通知时,确保所有用户点击后都能启动一个界面。我们需要为Activity创建一个PendingIntent。然后使用setContentIntent()把PendingIntent添加到通知中。
7.3 管理通知
当你需要为同一类型的事件多次处理一个通知时,你应该避免每次重新生成新的通知。你应该考虑更新先前的通知,不是改变一些值就是添加一些值。例如,Gmail通知用户新的email已经收到了,并且未读消息会自增计数,其实就是没收到一个通知消息做了处理。这就是所谓的“堆叠”通知。
7.3.1 更新通知
通知当然是可以被更新,使用通知ID来更新它,调用NotificationManager.notify(ID, notification)即可。如果先前的通知仍然可见,系统会从Notification 对象的content中更新它。如果先前的通知已经dismiss掉了,一个新的通知将被创建。下面的代码演示了一个通知更新并显示事件数量,如代码清单7-3所示:
mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);//被更新的通知IDint notifyID = 1; mNotifyBuilder = new NotificationCompat.Builder(this) .setContentTitle("New Message") .setContentText("You‘ve received new messages.") .setSmallIcon(R.drawable.ic_notify_status) numMessages = 0; ... mNotifyBuilder.setContentText(currentText) .setNumber(++numMessages); // 因为ID保持不变,存在的通知被更新 mNotificationManager.notify( notifyID, mNotifyBuilder.build()); ...
代码清单 7-3
上面那些代码运行后就会生成如图7-5所示的效果:
图7-5 在drawer中显示更新通知
7.3.2 移除通知
移除通知的方法如下:
1. 用户通过个人或“Clear All” dismiss通知
2. 用户点击通知并且你在创建通知的时候调用了setAutoCancel()方法
3. 你根据指定的通知ID调用cancel()方法。这个方法也删除正在进行中的通知
4. 你调用cancelAll(),它将删除你先前所有的通知
7.4 当启动一个Activity时保持导航
当你从一个通知中启动一个Activity的时候,你必须保存用户的语气导航体验。点击返回键将和点击Home键的效果一样。为了保存导航的用户体验,你应该在一个新的任务中启动Activity。根据给定的新任务如何设置PendingIntent取决于你启动的Activity的性质。通常有两种情况:
1. 常规activity
正常启动Activity的情况下,设置PendingIntent来启动一个新的任务,并给PendingIntent提供一个后台堆栈,以复制应用程序正常点击Back键的行为。从Gmail APP中来演示这个通知。当出现一条信息时你点击通知,就会看到信息本身。当你点击Back键时你会通过Gmail回退到Home屏幕,就像你已经进入了Gmail,从Gmail退到Home屏幕一样。
2. 特别的activity
这种Activity,是在某种意义上Activity扩展了通知提供的信息,因为很难显示在通知本身。在这种情况下,设置PendingIntent启动一个新的任务。没有必要创建一个后台堆栈,因为这个Activity并不是属于应用程序正常流程下的一部分。点击Back键后依然会显示Home屏幕。
7.4.1 通过PendingIntent设立一个规则的activity
1. 在manifest中定义你应用程序的Activity层级。
◆支持Android 4.0.3和更早期的版本。在<activity>节点下添加子节点<meta-data>。表示父Activity与子Activity的关系。在<meta-data>节点下设置
android:name="android.support.PARENT_ACTIVITY"
android:value="<parent_activity_name>"
◆支持Android4.1和更高的版本。在<activity>节点中添加android:parentActivityName属性
完美支持的xml代码如代码清单7-4所示:
<activity android:name=".MainActivity" android:label="@string/app_name" > <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter></activity><activityandroid:name=".ResultActivity"<!—android 4.1和更高版本 -->android:parentActivityName=".MainActivity"><!—android 4.0.3和更早版本 --> <meta-data android:name="android.support.PARENT_ACTIVITY" android:value=".MainActivity"/></activity>
代码清单 7-4
2. 创建一个后台推栈基于Intent启动的Activity:
◆创建Intent来启动Activity
◆通过调用TaskStackBuilder.create()来创建一个任务栈
◆通过调用addParentStack()把后台推栈添加到栈中。对于你在manifest中定义的每一个Activity层级,后台堆栈都包含一个启动Activity的Intent对象。并且这个方法还添加了标记(flag)来启动新任务中的堆栈。注意:尽管addParentStack()的参数是一个启动Activity的引用,但这个方法实际并没有添加Intent进去。
◆通过调用addNextIntent()来添加Intent对象。它添加的对象就是最上面◆创建的那个intent对象。
◆如果你需要在堆栈上添加参数到Intent对象你可以调用TaskStackBuilder.editIntentAt()。这有时候是必要的, 当用户使用back键导航回来,以确保目标Activity显示有意义的数据。
◆调用getPendingIntent()获得一个PendingIntent。然后你能调用setContentIntent()把这个PendingIntent作为参数。
下面的代码片段演示了这个过程,如代码清单7-5所示:
... Intent resultIntent = new Intent(this, ResultActivity.class); TaskStackBuilder stackBuilder = TaskStackBuilder.create(this);// 添加后台堆栈stackBuilder.addParentStack(ResultActivity.class);// 添加Intent到栈顶stackBuilder.addNextIntent(resultIntent);// 获得一个PendingIntent包含整个后台堆栈 containing the entire back stackPendingIntent resultPendingIntent = stackBuilder.getPendingIntent(0, PendingIntent.FLAG_UPDATE_CURRENT); ... NotificationCompat.Builder builder = new NotificationCompat.Builder(this); builder.setContentIntent(resultPendingIntent); NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); mNotificationManager.notify(id, builder.build());
代码清单 7-5
7.4.2 通过PendingIntent设立一个专用的activity
以下部分描述了怎样通过PendingIntent设置一个专用的activity。
一个专用的Activity 不需要后台栈,因此你不一定要在manifest中定义它的Activity层级,并且你不必调用addParentStack() 来构建一个后台栈。反而使用manifest设置Activity的任务选项,并通过调用getActivity()创建PendingIntent:
1. 在manifest中添加以下属性到<activity>节点中。
◆android:name="activityclass"
完整的类名
◆android:taskAffinity=""
于代码中设置的FLAG_ACTIVITY_NEW_TASK 标记相结合,它确保这个activity不能进入应用程序的默认任务中。
◆android:excludeFromRecents="true"
从Recents排除了新的任务,以便用户不会意外导航回它。
如代码清单7-6所示:
<activity android:name=".ResultActivity"... android:launchMode="singleTask" android:taskAffinity="" android:excludeFromRecents="true"></activity>...
代码清单 7-6
2. 构建和发布通知
◆创建一个Intent来启动Activity
◆设置Activity启动在一个新的、空的任务中,通过setFlags()方法来处理,传入FLAG_ACTIVITY_NEW_TASK和FLAG_ACTIVITY_CLEAR_TASK
◆为Intent设置其他需要的选项
◆通过getActivity()从Intent中创建一个PendingIntent。你能使用这个PendingIntent对象,把他作为参数传到setContentIntent()中
如代码清单7-7所示:
NotificationCompat.Builder builder = new NotificationCompat.Builder(this); Intent notifyIntent = new Intent(new ComponentName(this, ResultActivity.class)); notifyIntent.setFlags(FLAG_ACTIVITY_NEW_TASK | FLAG_ACTIVITY_CLEAR_TASK); PendingIntent notifyIntent = PendingIntent.getActivity( this, 0, notifyIntent PendingIntent.FLAG_UPDATE_CURRENT ); builder.setContentIntent(notifyIntent); NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); mNotificationManager.notify(id, builder.build());
代码清单 7-7
7.5 显示通知的进度
通知可以包括一个动画进度指示器显示用户正在运行的操作的状态。如果你能估计这种操作需要花费多长时间,可以使用"determinate"形式的指示器(一个progress bar)。如果你不能估计花费的时间,使用“indeterminate”形式的指示器。
7.5.1 显示一个固定的时间进度指示器
显示一个确定的进度条, 通过调用setProgress()添加bar到你的通知中,setProgress(max, progress, false),然后发出通知。如代码清单7-8所示:
... mNotifyManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE); mBuilder = new NotificationCompat.Builder(this); mBuilder.setContentTitle("Picture Download") .setContentText("Download in progress") .setSmallIcon(R.drawable.ic_notification);new Thread( new Runnable() { @Override public void run() { int incr; for (incr = 0; incr <= 100; incr+=5) { mBuilder.setProgress(100, incr, false); mNotifyManager.notify(0, mBuilder.build()); try { Thread.sleep(5*1000); } catch (InterruptedException e) { Log.d(TAG, "sleep failure"); } } mBuilder.setContentText("Download complete") .setProgress(0,0,false); mNotifyManager.notify(ID, mBuilder.build()); } } ).start();
代码清单 7-8
图7-6则是运行后的效果
图7-6 通知中progress bar运行的效果
7.5.2显示一个持续的Activity指示器
为了显示不确定的activity指示器,使用setProgress(0, 0, true)添加它到你的通知中,前面两个参数可以忽略,然后发出通知。它的结果是一个指示器,具有和进度条相同的样式,不同的地方就是它的动画是持续的。在操作开始的地方就发出通知,这个动画将一直执行,直到你修改通知为止。将操作完成时,你应该手动调用setProgress(0, 0, false)然后更新通知移除activity指示器。如果你不这么做就算操作完成动画也会继续运行。下面让我们看下代码清单7-9:
mBuilder.setProgress(100, incr, false); mNotifyManager.notify(0, mBuilder.build());
代码清单 7-9
运行后的效果如图7-7所示:
图7-7 持续的activity指示器动画
7.6 自定义通知布局
通知框架允许你自定义通知布局,它在一个RemoteViews 对象中定义了通知的外观。自定义布局通知和正常的通知类似,它们都是基于一个RemoteViews定义在一个XML布局文件。自定义通知的可用高度取决于通知view的布局。正常view布局限制为64dp,展开view布局限制为256dp。自定义通知布局,通过实例化一个RemoteViews对象然后inflates一个xml布局文件启动。不再调用setContentTitle()方法,而使用setContent()方法来设置自定义通知的内容细节。使用这个方法在RemoteViews中来设置view子类的值:
1. 为通知创建一个单独的xml布局文件。
2. 在你的应用程序中,使用RemoteViews方法来定义你通知的icon和文本。调用setContent()方法put这个RemoteViews对象到你的NotificationCompat.Builder中。避免正在RemoteViews对象中设置Drawable背景,因为你的文本颜色可能会变的看不清。
RemoteViews类也包括早期Chronometer或ProgressBar中的方法 ,更多详细信息请参考API文档。
当你使用自定义通知布局时,请特别注意不同的设备分辨率和水平方向上的问题。不要让你的自定义布局太复杂,一定要在各种配置中测试。
从零开始--系统深入学习android(实践-让我们开始写代码-Android框架学习-7.通知),,5-wow.com
郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。