blob: f37f1dcc8401df0acba9c925f3d7c54520e68f1c [file] [log] [blame]
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001<html>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002
3<body>
4
Scott Mainf4f05b82011-01-07 14:38:23 -08005<p>Contains high-level classes encapsulating the overall Android application model.</p>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08006
Scott Mainf4f05b82011-01-07 14:38:23 -08007<p>An Android application is defined using one or more of Android's four core application
8components. Two such application components are defined in this package: {@link
9android.app.Activity} and {@link android.app.Service}. The other two components are from the {@link
10android.content} package: {@link android.content.BroadcastReceiver} and {@link
11android.content.ContentProvider}.</p>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080012
Scott Mainf4f05b82011-01-07 14:38:23 -080013<p>An {@link android.app.Activity} is an application component that provides a screen with which
14users can interact in order to do something, such as dial the phone, take a photo, send an email, or
15view a map. An activity can start other activities, including activities that live in separate
16applications.</p>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080017
Scott Mainf4f05b82011-01-07 14:38:23 -080018<p>A {@link android.app.Service} is an application component that can perform
19long-running operations in the background without a user interface. For example, a service
20can handle network transactions, play music, or work with a content provider without the user being
21aware of the work going on.</p>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080022
Scott Mainf4f05b82011-01-07 14:38:23 -080023<p>The {@link android.app.Fragment} class is also an important part of an application's
24design&mdash;especially when designing for large screen devices, such as tablets. A fragment defines
25a distinct part of an activity's behavior, including the associated UI. It has its own lifecycle
26that is similar to that of the activity and can exist alongside other fragments that are embedded in
27the activity. While an activity is running, you can add and remove fragments and include each
28fragment in a back stack that's managed by the activity&mdash;allowing the user to navigate
29backwards through the fragment states, without leaving the activity.</p>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080030
Scott Mainf4f05b82011-01-07 14:38:23 -080031<p>This package also defines application utilities, such as dialogs, notifications, and the
32action bar.</p>
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080033
Scott Mainf4f05b82011-01-07 14:38:23 -080034<p>For information about using some the classes in this package, see the following
Scott Main13033ea2011-02-15 13:18:30 -080035documents: <a href="{@docRoot}guide/topics/fundamentals/activities.html">Activities</a>, <a
36href="{@docRoot}guide/topics/fundamentals/services.html">Services</a>, <a
37href="{@docRoot}guide/topics/fundamentals/fragments.html">Fragments</a>, <a
Scott Mainf4f05b82011-01-07 14:38:23 -080038href="{@docRoot}guide/topics/ui/actionbar.html">Using the Action Bar</a>, <a
39href="{@docRoot}guide/topics/ui/dialogs.html">Creating Dialogs</a>, and <a
40href="{@docRoot}guide/topics/ui/notifiers/index.html">Notifying the User</a>.</p>
41
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080042
43</body>
44</html>