blob: 51f058fa4172120c05ed02958ac0c00c31bb273b [file] [log] [blame]
&& repo sync -j80aae0002012-10-04 16:34:23 -07001page.title=Notifying the User
Scott Main1c2dea02013-04-10 18:59:29 -07002page.tags="notifications"
3
&& repo sync -j80aae0002012-10-04 16:34:23 -07004trainingnavtop=true
5startpage=true
&& repo sync -j80aae0002012-10-04 16:34:23 -07006
7
8@jd:body
9<div id="tb-wrapper">
10<div id="tb">
11
12<!-- Required platform, tools, add-ons, devices, knowledge, etc. -->
13<h2>Dependencies and prerequisites</h2>
14
15<ul>
16 <li>Android 1.6 (API Level 4) or higher</li>
17</ul>
18<h2>You should also read</h2>
19<ul>
20 <li>
21 <a href="{@docRoot}guide/topics/ui/notifiers/notifications.html">Notifications</a> API Guide
22 </li>
23 <li>
24 <a href="{@docRoot}guide/components/intents-filters.html">
25 Intents and Intent Filters
26 </a>
27 </li>
28 <li>
29 <a href="{@docRoot}design/patterns/notifications.html">Notifications</a> Design Guide
30 </li>
31</ul>
32
33<h2>Try it out</h2>
34
35<div class="download-box">
36 <a href="{@docRoot}shareables/training/NotifyUser.zip"
37class="button">Download the sample</a>
38 <p class="filename">NotifyUser.zip</p>
39</div>
40
41</div>
42</div>
43
44<p>
45 A notification is a user interface element that you display outside your app's normal UI to indicate
46 that an event has occurred. Users can choose to view the notification while using other apps and respond
47 to it when it's convenient for them.
48
49</p>
50
51<p>
52 The <a href="{@docRoot}design/patterns/notifications.html">Notifications design guide</a> shows
53 you how to design effective notifications and when to use them. This class shows you how to
54 implement the most common notification designs.
55</p>
56<h2>Lessons</h2>
57
58<dl>
59 <dt>
60 <strong><a href="build-notification.html">Building a Notification</a></strong>
61 </dt>
62 <dd>
63 Learn how to create a notification
64 {@link android.support.v4.app.NotificationCompat.Builder Builder}, set the
65 required features, and issue the notification.
66 </dd>
67 <dt>
68 <strong><a href="navigation.html">Preserving Navigation when Starting an Activity</a></strong>
69 </dt>
70 <dd>
71 Learn how to enforce the proper
72 navigation for an {@link android.app.Activity} started from a notification.
73 </dd>
74 <dt>
75 <strong>
76 <a href="managing.html">Updating Notifications</a>
77 </strong>
78 </dt>
79 <dd>
80 Learn how to update and remove notifications.
81 </dd>
82 <dt>
83 <strong>
84 <a href="expanded.html">Using Big View Styles</a>
85 </strong>
86 </dt>
87 <dd>
88 Learn how to create a big view within an expanded notification, while still maintaining
89 backward compatibility.
90 </dd>
91
92 <dt>
93 <strong>
94 <a href="display-progress.html">Displaying Progress in a Notification</a>
95 </strong>
96 </dt>
97 <dd>
98 Learn how to display the progress of an operation in a notification, both for
99 operations where you can estimate how much has been completed (determinate progress) and
100 operations where you don't know how much has been completed (indefinite progress).
101 </dd>
102</dl>