第7章通知

一个通知是一条消息他是显示于你应用程序之外的一个界面中。当你告诉系统要发布一个通知时，它首先作为一个icon出现在通知区域。为了看见通知的细节，用户可以点击通知区域展开一个新的界面。下面让我们来看一下图7-1和图7-2：

第三部分：Android 应用程序接口指南---第二节：UI---第七章通知

图7-1 通知出现在通知区域

第三部分：Android 应用程序接口指南---第二节：UI---第七章通知

图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：

第三部分：Android 应用程序接口指南---第二节：UI---第七章通知

图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所示：

第三部分：Android 应用程序接口指南---第二节：UI---第七章通知

图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);

//被更新的通知ID

int 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所示的效果：

第三部分：Android 应用程序接口指南---第二节：UI---第七章通知

图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>

<activity

android: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 stack

PendingIntent 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则是运行后的效果

第三部分：Android 应用程序接口指南---第二节：UI---第七章通知

图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所示：

第三部分：Android 应用程序接口指南---第二节：UI---第七章通知

图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文档。

当你使用自定义通知布局时，请特别注意不同的设备分辨率和水平方向上的问题。不要让你的自定义布局太复杂,一定要在各种配置中测试。

本文来自jy02432443，是本人辛辛苦苦一个个字码出来的，转载请保留出处，并保留追究法律责任的权利 QQ78117253

秒客网

第三部分：Android 应用程序接口指南---第二节：UI---第七章通知

第7章通知

7.1 通知显示元素

7.2 创建一个通知

7.2.4 创建一个简单的通知

7.2.5 应用一个大型的view风格到通知中

7.2.6 处理兼容性

7.3 管理通知

7.3.1 更新通知

7.3.2 移除通知

7.4 当启动一个Activity时保持导航

7.4.1 通过PendingIntent设立一个规则的activity

7.4.2 通过PendingIntent设立一个专用的activity

7.5 显示通知的进度

7.5.1 显示一个固定的时间进度指示器

7.5.2显示一个持续的Activity指示器

7.6 自定义通知布局

相关文章

第三部分：Android 应用程序接口指南---第二节：UI---第七章 通知

第7章 通知

7.1 通知显示元素

7.2 创建一个通知

7.2.4 创建一个简单的通知

7.2.5 应用一个大型的view风格到通知中

7.2.6 处理兼容性

7.3 管理通知

7.3.1 更新通知

7.3.2 移除通知

7.4 当启动一个Activity时保持导航

7.4.1 通过PendingIntent设立一个规则的activity

7.4.2 通过PendingIntent设立一个专用的activity

7.5 显示通知的进度

7.5.1 显示一个固定的时间进度指示器

7.5.2显示一个持续的Activity指示器

7.6 自定义通知布局

相关文章

第三部分：Android 应用程序接口指南---第二节：UI---第七章通知

第7章通知