建立Notification · Android Training官方培訓課程中文版

> 編寫:[fastcome1985](https://github.com/fastcome1985) - 原文:[http://developer.android.com/training/notify-user/build-notification.html](http://developer.android.com/training/notify-user/build-notification.html) - 這節課向你說明如何創建與發布一個Notification。 - 這節課的例子是基于[NotificationCompat.Builder](#)類的，[NotificationCompat.Builder](#)在[Support Library](#)中。為了給許多各種不同的平臺提供最好的notification支持，你應該使用[NotificationCompat](#)以及它的子類，特別是[NotificationCompat.Builder](#)。 ### 創建Notification Buider - 創建Notification時，可以用[NotificationCompat.Builder](#)對象指定Notification的UI內容與行為。一個[Builder](#)至少包含以下內容： - 一個小的icon，用[setSmallIcon()](#))方法設置 - 一個標題，用[setContentTitle()](#))方法設置。 - 詳細的文本，用[setContentText()](#))方法設置例如： ~~~ NotificationCompat.Builder mBuilder = new NotificationCompat.Builder(this) .setSmallIcon(R.drawable.notification_icon) .setContentTitle("My notification") .setContentText("Hello World!"); ~~~ ### 定義Notification的Action（行為） - 盡管在Notification中Actions是可選的，但是你應該至少添加一種Action。一種Action可以讓用戶從Notification直接進入你應用內的[Activity](# "An activity represents a single screen with a user interface.")，在這個[activity](# "An activity represents a single screen with a user interface.")中他們可以查看引起Notification的事件或者做下一步的處理。在Notification中，action本身是由[PendingIntent](#)定義的，PendingIntent包含了一個啟動你應用內[Activity](# "An activity represents a single screen with a user interface.")的[Intent](#)。 - 如何構建一個[PendingIntent](#)取決于你要啟動的[activity](# "An activity represents a single screen with a user interface.")的類型。當從Notification中啟動一個[activity](# "An activity represents a single screen with a user interface.")時，你必須保存用戶的導航體驗。在下面的代碼片段中，點擊Notification啟動一個新的[activity](# "An activity represents a single screen with a user interface.")，這個[activity](# "An activity represents a single screen with a user interface.")有效地擴展了Notification的行為。在這種情形下，就沒必要人為地去創建一個返回棧（更多關于這方面的信息，請查看 [Preserving Navigation when Starting an ](#)[Activity](# "An activity represents a single screen with a user interface.")） ~~~ Intent resultIntent = new Intent(this, ResultActivity.class); ... // Because clicking the notification opens a new ("special") activity, there's // no need to create an artificial back stack. PendingIntent resultPendingIntent = PendingIntent.getActivity( this, 0, resultIntent, PendingIntent.FLAG_UPDATE_CURRENT ); ~~~ ### 設置Notification的點擊行為可以通過調用[NotificationCompat.Builder](#)中合適的方法，將上一步創建的[PendingIntent](#)與一個手勢產生關聯。比方說，當點擊Notification抽屜里的Notification文本時，啟動一個[activity](# "An activity represents a single screen with a user interface.")，可以通過調用[setContentIntent()](#))方法把[PendingIntent](#)添加進去。例如： ~~~ PendingIntent resultPendingIntent; ... mBuilder.setContentIntent(resultPendingIntent); ~~~ ### 發布Notification 為了發布notification： ~~~ * 獲取一個[NotificationManager](http://www.baidu.com/baidu?wd=NotificationManager.&tn=monline_4_dg)實例 * 使用[notify()](developer.android.com/reference/java/lang/Object.html#notify())方法發布Notification。當你調用[notify()](developer.android.com/reference/java/lang/Object.html#notify())方法時，指定一個notification ID。你可以在以后使用這個ID來更新你的notification。這在[Managing Notifications](developer.android.com/intl/zh-cn/training/notify-user/managing.html)中有更詳細的描述。 * 調用[build()](developer.android.com/reference/android/support/v4/app/NotificationCompat.Builder.html#build())方法，會返回一個包含你的特征的[Notification](developer.android.com/reference/android/app/Notification.html)對象。 ~~~ 舉個例子： ~~~ NotificationCompat.Builder mBuilder; ... // Sets an ID for the notification int mNotificationId = 001; // Gets an instance of the NotificationManager service NotificationManager mNotifyMgr = (NotificationManager) getSystemService(NOTIFICATION_SERVICE); // Builds the notification and issues it. mNotifyMgr.notify(mNotificationId, mBuilder.build()); ~~~