-
Market filters quickview
+Quickview
- Android Market applies filters to that let you control whether your app is shown to a user who is browing or searching for apps.
- Filtering is determined by elements in an app's manifest file,
diff --git a/docs/html/guide/practices/design/performance.jd b/docs/html/guide/practices/design/performance.jd
index 56872a72b7831..f5588ac8b3c2f 100644
--- a/docs/html/guide/practices/design/performance.jd
+++ b/docs/html/guide/practices/design/performance.jd
@@ -1,6 +1,30 @@
page.title=Designing for Performance
@jd:body
++++ ++
In this document
+-
+
- Introduction +
- Optimize Judiciously +
- Avoid Creating Objects +
- Performance Myths +
- Prefer Static Over Virtual +
- Avoid Internal Getters/Setters +
- Use Static Final For Constants +
- Use Enhanced For Loop Syntax +
- Avoid Enums Where You Only Need Ints +
- Use Package Scope with Inner Classes +
- Use Floating-Point Judiciously +
- Know And Use The Libraries +
- Use Native Methods Judiciously +
- Closing Notes +
An Android application will run on a mobile device with limited computing power and storage, and constrained battery life. Because of this, it should be efficient. Battery life is one reason you might @@ -8,24 +32,6 @@ want to optimize your app even if it already seems to run "fast enough". Battery life is important to users, and Android's battery usage breakdown means users will know if your app is responsible draining their battery.
-This document covers these topics:
--
-
- Introduction -
- Optimize Judiciously -
- Avoid Creating Objects -
- Performance Myths -
- Prefer Static Over Virtual -
- Avoid Internal Getters/Setters -
- Use Static Final For Constants -
- Use Enhanced For Loop Syntax -
- Avoid Enums Where You Only Need Ints -
- Use Package Scope with Inner Classes -
- Use Floating-Point Judiciously -
- Know And Use The Libraries -
- Use Native Methods Judiciously -
- Closing Notes -
Note that although this document primarily covers micro-optimizations, these will almost never make or break your software. Choosing the right algorithms and data structures should always be your priority, but is diff --git a/docs/html/guide/practices/design/responsiveness.jd b/docs/html/guide/practices/design/responsiveness.jd index 9858e364e7dcc..2c7633d10c94e 100644 --- a/docs/html/guide/practices/design/responsiveness.jd +++ b/docs/html/guide/practices/design/responsiveness.jd @@ -1,11 +1,37 @@ page.title=Designing for Responsiveness @jd:body +
+++ ++In this document
+ + ++
Figure 1. An ANR dialog displayed to the user.
It's possible to write code that wins every performance test in the world, but still sends users +in a fiery rage when they try to use the application. These are the applications that aren't +responsive enough — the ones that feel +sluggish, hang or freeze for significant periods, or take too long to process +input.
+ +In Android, the system guards against applications that are insufficiently responsive for a +period of time by displaying a dialog to the user, called the Application Not Responding (ANR) +dialog. The user can choose to let the application continue, but the user won't appreciate having to +act on this dialog every time he or she uses your application. So it's important to design +responsiveness into your application, so that the system never has cause to display an ANR to the +user.
+It's possible to write code that wins every performance test in the world, but still sends users in a fiery rage when they try to use the application. These are the applications that aren't responsive enough — the diff --git a/docs/html/guide/practices/design/seamlessness.jd b/docs/html/guide/practices/design/seamlessness.jd index a6c164192b33d..dedc16fecf711 100644 --- a/docs/html/guide/practices/design/seamlessness.jd +++ b/docs/html/guide/practices/design/seamlessness.jd @@ -1,6 +1,26 @@ page.title=Designing for Seamlessness @jd:body +
+++ ++In this document
+-
+
- Don't Drop Data +
- Don't Expose Raw Data +
- Don't Interrupt the User +
- Got a Lot to Do? Do it in a Thread +
- Don't Overload a Single Activity Screen +
- Extend System Themes +
- Design Your UI to Work with Multiple Screen Resolutions +
- Assume the Network is Slow +
- Don't Assume Touchscreen or Keyboard +
- Do Conserve the Device Battery +
Even if your application is fast and responsive, certain design decisions can still cause problems for users — because of unplanned interactions with other applications or dialogs, inadvertent loss of data, unintended blocking, @@ -42,20 +62,7 @@ system as just an even-larger federation of these components. This benefits you by allowing you to integrate cleanly and seamlessly with other applications, and so you should design your own code to return the favor.
-This document discusses common seamlessness problems and how to avoid them. -It covers these topics:
--
-
- Don't Drop Data -
- Don't Expose Raw Data -
- Don't Interrupt the User -
- Got a Lot to Do? Do it in a Thread -
- Don't Overload a Single Activity Screen -
- Extend System Themes -
- Design Your UI to Work with Multiple Screen Resolutions -
- Assume the Network is Slow -
- Don't Assume Touchscreen or Keyboard -
- Do Conserve the Device Battery -
This document discusses common seamlessness problems and how to avoid them.
Don't Drop Data
diff --git a/docs/html/guide/practices/screens_support.jd b/docs/html/guide/practices/screens_support.jd index 11ad1b8629c2a..13b5e3aba50e2 100644 --- a/docs/html/guide/practices/screens_support.jd +++ b/docs/html/guide/practices/screens_support.jd @@ -5,7 +5,7 @@ page.title=Supporting Multiple Screens-Multiple screens quickview:
+Quickview
- Android runs on devices that have different screen sizes and resolutions.
- The screen on which your application is displayed can affect its user interface. diff --git a/docs/html/guide/practices/ui_guidelines/activity_task_design.jd b/docs/html/guide/practices/ui_guidelines/activity_task_design.jd index c8d241c68ed70..6cb98e6a026f3 100644 --- a/docs/html/guide/practices/ui_guidelines/activity_task_design.jd +++ b/docs/html/guide/practices/ui_guidelines/activity_task_design.jd @@ -4,7 +4,7 @@ page.title=Activity and Task Design Guidelines
- Activities are the main building blocks of Android applications. diff --git a/docs/html/guide/practices/ui_guidelines/icon_design.jd b/docs/html/guide/practices/ui_guidelines/icon_design.jd index 51ccfaf98bfe3..389d5fa0811a7 100644 --- a/docs/html/guide/practices/ui_guidelines/icon_design.jd +++ b/docs/html/guide/practices/ui_guidelines/icon_design.jd @@ -4,7 +4,7 @@ page.title=Icon Design Guidelines, Android 2.0
- You can use several types of icons in an Android application. @@ -35,25 +35,30 @@ page.title=Icon Design Guidelines, Android 2.0 -
- You can use several types of icons in an Android application. @@ -35,12 +35,17 @@ application can use the standard icons by referencing them as resources. +
- An Options menu is for any commands that are global to the current activity. diff --git a/docs/html/guide/practices/ui_guidelines/widget_design.jd b/docs/html/guide/practices/ui_guidelines/widget_design.jd index fc62fe680b749..e9780696f3b89 100644 --- a/docs/html/guide/practices/ui_guidelines/widget_design.jd +++ b/docs/html/guide/practices/ui_guidelines/widget_design.jd @@ -4,7 +4,7 @@ page.title=Widget Design Guidelines
- Widgets have six standard sizes on the Home screen @@ -27,7 +27,7 @@ page.title=Widget Design Guidelines
- AppWidgets topic in the Dev Guide +
- App Widgets
- AppWidgets blog post
- All Android apps must be signed diff --git a/docs/html/guide/publishing/licensing.jd b/docs/html/guide/publishing/licensing.jd index 07af68de4d14e..fc83ec03d5739 100644 --- a/docs/html/guide/publishing/licensing.jd +++ b/docs/html/guide/publishing/licensing.jd @@ -4,7 +4,7 @@ page.title=Licensing Your Applications
- Licensing lets you protect your application on any device that includes Android Market.
- Your app maintains control of how it enforces its licensing status. diff --git a/docs/html/guide/publishing/preparing.jd b/docs/html/guide/publishing/preparing.jd index 442c12acc2ca2..45a5b77797922 100644 --- a/docs/html/guide/publishing/preparing.jd +++ b/docs/html/guide/publishing/preparing.jd @@ -1,20 +1,6 @@ page.title=Preparing to Publish: A Checklist @jd:body - -
- Test your application extensively on an actual device @@ -44,7 +30,7 @@ Applications document.
- Turn off logging and debugging and clean up data/files
- Version your application @@ -52,8 +38,9 @@ Applications document.
- Register for a Maps API Key, if your application is using MapView elements
- Sign your application
- Test your compiled application @@ -242,7 +229,7 @@ to download Maps data. you can compile your application for release. -
- You can publish your application using a hosted service such as Android Market or through a web server. diff --git a/docs/html/guide/publishing/versioning.jd b/docs/html/guide/publishing/versioning.jd index 1d55f8a30d451..b646247b011d7 100644 --- a/docs/html/guide/publishing/versioning.jd +++ b/docs/html/guide/publishing/versioning.jd @@ -4,7 +4,7 @@ page.title=Versioning Your Applications
- Your application must be versioned diff --git a/docs/html/guide/topics/appwidgets/index.jd b/docs/html/guide/topics/appwidgets/index.jd index 7a8dd599bed93..3de562713d64c 100644 --- a/docs/html/guide/topics/appwidgets/index.jd +++ b/docs/html/guide/topics/appwidgets/index.jd @@ -3,12 +3,14 @@ page.title=App Widgets
- {@link android.appwidget.AppWidgetProvider} -
- {@link android.appwidget.AppWidgetProviderInfo} -
- {@link android.appwidget.AppWidgetManager} -
- App Widgets provide users access to some of your application features +directly from the Home screen (without the need to launch an activity) +
- App Widgets are backed by a special kind of broadcast receiver that handles the App +Widget lifecycle +
- The Basics @@ -28,6 +30,13 @@ page.title=App Widgets
- {@link android.appwidget.AppWidgetProvider} +
- {@link android.appwidget.AppWidgetProviderInfo} +
- {@link android.appwidget.AppWidgetManager} +
- App Widget Design
diff --git a/docs/html/guide/topics/fundamentals.jd b/docs/html/guide/topics/fundamentals.jd
index 6d6abd8b15c99..a095087482f1b 100644
--- a/docs/html/guide/topics/fundamentals.jd
+++ b/docs/html/guide/topics/fundamentals.jd
@@ -3,14 +3,6 @@ page.title=Application Fundamentals
diff --git a/docs/html/guide/topics/intents/intents-filters.jd b/docs/html/guide/topics/intents/intents-filters.jd index bd1d6942c2039..59052143523e3 100644 --- a/docs/html/guide/topics/intents/intents-filters.jd +++ b/docs/html/guide/topics/intents/intents-filters.jd @@ -3,15 +3,6 @@ page.title=Intents and Intent Filters-
Key classes
--
-
- {@link android.app.Activity} -
- {@link android.app.Service} -
- {@link android.content.BroadcastReceiver} -
- {@link android.content.ContentProvider} -
- {@link android.content.Intent} -
In this document
-
@@ -43,6 +35,16 @@ page.title=Application Fundamentals
- Processes and lifecycles
Key classes
+-
+
- {@link android.app.Activity} +
- {@link android.app.Service} +
- {@link android.content.BroadcastReceiver} +
- {@link android.content.ContentProvider} +
- {@link android.content.Intent} +
diff --git a/docs/html/guide/topics/media/index.jd b/docs/html/guide/topics/media/index.jd index 96c500cab7c80..558d4535e2e0b 100644 --- a/docs/html/guide/topics/media/index.jd +++ b/docs/html/guide/topics/media/index.jd @@ -4,7 +4,7 @@ page.title=Audio and Video-Key classes
--
-
- {@link android.content.Intent} -
- {@link android.content.IntentFilter} -
- {@link android.app.Activity} -
- {@link android.app.Service} -
- {@link android.content.BroadcastReceiver} -
- {@link android.content.pm.PackageManager} -
In this document
-
@@ -22,6 +13,15 @@ page.title=Intents and Intent Filters
- Using intent matching
- Note Pad Example
Key classes
+-
+
- {@link android.content.Intent} +
- {@link android.content.IntentFilter} +
- {@link android.content.BroadcastReceiver} +
- {@link android.content.pm.PackageManager} +
diff --git a/docs/html/guide/topics/ui/declaring-layout.jd b/docs/html/guide/topics/ui/declaring-layout.jd index 5c12db9f4ded8..fe641a2d6602e 100644 --- a/docs/html/guide/topics/ui/declaring-layout.jd +++ b/docs/html/guide/topics/ui/declaring-layout.jd @@ -5,12 +5,6 @@ parent.link=index.html-Audio/Video quickview
+Quickview
- Audio playback and record
- Video playback @@ -12,14 +12,6 @@ page.title=Audio and Video
- Built-in codecs for a variety of media. See Android Supported Media Formats
Key classes
--
-
- {@link android.media.MediaPlayer MediaPlayer} (all available formats) -
- {@link android.media.MediaRecorder MediaRecorder} (all available formats) -
- {@link android.media.JetPlayer JetPlayer} (playback, JET content) -
- {@link android.media.SoundPool SoundPool} (sound management) -
In this document
- Audio and Video Playback @@ -32,6 +24,14 @@ page.title=Audio and Video
- Audio Capture
Key classes
+-
+
- {@link android.media.MediaPlayer MediaPlayer} +
- {@link android.media.MediaRecorder MediaRecorder} +
- {@link android.media.JetPlayer JetPlayer} +
- {@link android.media.SoundPool SoundPool} +
See also
- Data Storage diff --git a/docs/html/guide/topics/providers/content-providers.jd b/docs/html/guide/topics/providers/content-providers.jd index da4e7a1ff7054..2aed5e18411ce 100644 --- a/docs/html/guide/topics/providers/content-providers.jd +++ b/docs/html/guide/topics/providers/content-providers.jd @@ -3,12 +3,6 @@ page.title=Content Providers
- {@link android.content.ContentProvider} -
- {@link android.content.ContentResolver} -
- {@link android.database.Cursor} -
- Creating a content provider
- Content URI summary
- {@link android.content.ContentProvider} +
- {@link android.content.ContentResolver} +
- {@link android.database.Cursor} +
- {@link android.content.ContentProvider}
diff --git a/docs/html/guide/topics/search/adding-custom-suggestions.jd b/docs/html/guide/topics/search/adding-custom-suggestions.jd index ce0c619536889..c8f06b915ff60 100644 --- a/docs/html/guide/topics/search/adding-custom-suggestions.jd +++ b/docs/html/guide/topics/search/adding-custom-suggestions.jd @@ -33,7 +33,7 @@ parent.link=index.html-Key classes
--
-
In this document
-
@@ -18,6 +12,13 @@ page.title=Content Providers
Key classes
+-
+
Related Samples
+Related samples
- Searchable Dictionary diff --git a/docs/html/guide/topics/search/index.jd b/docs/html/guide/topics/search/index.jd index 78e0be2e3f290..f563715690d55 100644 --- a/docs/html/guide/topics/search/index.jd +++ b/docs/html/guide/topics/search/index.jd @@ -13,7 +13,7 @@ page.title=Search -
- Searchable Dictionary diff --git a/docs/html/guide/topics/search/search-dialog.jd b/docs/html/guide/topics/search/search-dialog.jd index 49c6627570ffd..49938b4e14abb 100644 --- a/docs/html/guide/topics/search/search-dialog.jd +++ b/docs/html/guide/topics/search/search-dialog.jd @@ -29,7 +29,7 @@ parent.link=index.html
- {@link android.app.SearchManager}
- Searchable Dictionary diff --git a/docs/html/guide/topics/testing/testing_android.jd b/docs/html/guide/topics/testing/testing_android.jd index 46ba7693e2009..935aaf9d46428 100755 --- a/docs/html/guide/topics/testing/testing_android.jd +++ b/docs/html/guide/topics/testing/testing_android.jd @@ -52,7 +52,7 @@ page.title=Testing and Instrumentation
Related Samples
+Related samples
Related Samples
+Related samples
Key Classes
+Key classes
- {@link android.test.InstrumentationTestRunner}
- {@link android.test.ActivityInstrumentationTestCase2} @@ -61,7 +61,7 @@ page.title=Testing and Instrumentation
- {@link android.test.ProviderTestCase2}
- {@link android.test.ServiceTestCase}
Related Tutorials
+Related tutorials
- Hello, Testing @@ -70,7 +70,7 @@ page.title=Testing and Instrumentation Activity Testing
See Also
+See also
- Testing in Eclipse, with ADT diff --git a/docs/html/guide/topics/ui/binding.jd b/docs/html/guide/topics/ui/binding.jd index 6ac0bb08a6927..26364ee8e4c94 100644 --- a/docs/html/guide/topics/ui/binding.jd +++ b/docs/html/guide/topics/ui/binding.jd @@ -11,11 +11,11 @@ parent.link=index.html
- Handling User Selections
See also
+Related tutorials
diff --git a/docs/html/guide/topics/ui/dialogs.jd b/docs/html/guide/topics/ui/dialogs.jd index 74b544bb985a5..1a997f94ad033 100644 --- a/docs/html/guide/topics/ui/dialogs.jd +++ b/docs/html/guide/topics/ui/dialogs.jd @@ -5,10 +5,6 @@ parent.link=index.html-Key classes
--
-
- {@link android.view.View} -
- {@link android.view.ViewGroup} -
- {@link android.view.ViewGroup.LayoutParams} -
In this document
- Write the XML @@ -26,6 +20,12 @@ parent.link=index.html
- Example Layout
Key classes
+-
+
- {@link android.view.View} +
- {@link android.view.ViewGroup} +
- {@link android.view.ViewGroup.LayoutParams} +
diff --git a/docs/html/guide/topics/ui/index.jd b/docs/html/guide/topics/ui/index.jd index abcf6bef688fe..375c9feafa267 100644 --- a/docs/html/guide/topics/ui/index.jd +++ b/docs/html/guide/topics/ui/index.jd @@ -4,13 +4,6 @@ page.title=User Interface-Key classes
--
-
- {@link android.app.Dialog} -
In this document
- Showing a Dialog @@ -26,6 +22,11 @@ parent.link=index.html
- Creating a Custom Dialog
Key classes
+-
+
- {@link android.app.Dialog} +
diff --git a/docs/html/guide/topics/ui/notifiers/index.jd b/docs/html/guide/topics/ui/notifiers/index.jd index f7ccce771411f..d29324cc87971 100644 --- a/docs/html/guide/topics/ui/notifiers/index.jd +++ b/docs/html/guide/topics/ui/notifiers/index.jd @@ -3,13 +3,7 @@ page.title=Notifying the User-Key classes
--
-
- {@link android.view.View} -
- {@link android.view.ViewGroup} -
- {@link android.widget Widget classes} -
In this document
- View Hierarchy @@ -25,6 +18,13 @@ page.title=User Interface
Key classes
+-
+
- {@link android.view.View} +
- {@link android.view.ViewGroup} +
- {@link android.widget Widget classes} +
diff --git a/docs/html/guide/topics/wireless/bluetooth.jd b/docs/html/guide/topics/wireless/bluetooth.jd index a8ff0073d9d82..fa2875b3647d2 100644 --- a/docs/html/guide/topics/wireless/bluetooth.jd +++ b/docs/html/guide/topics/wireless/bluetooth.jd @@ -3,14 +3,13 @@ page.title=Bluetooth-In this document
- -More about
+Topics
- Creating Toast Notifications
- Creating Status Bar Notifications diff --git a/docs/html/guide/topics/ui/notifiers/notifications.jd b/docs/html/guide/topics/ui/notifiers/notifications.jd index a0dd9f11d5ec5..abc945ab6c360 100644 --- a/docs/html/guide/topics/ui/notifiers/notifications.jd +++ b/docs/html/guide/topics/ui/notifiers/notifications.jd @@ -5,18 +5,21 @@ parent.link=index.html
- {@link android.app.Notification} -
- {@link android.app.NotificationManager} -
- A status bar notification allows your application to notify the user of an event +without interupting their current activity +
- You can attach an intent to your notification that the system will initiate when the +user clicks it +
- The Basics
- Managing your Notifications
- Creating a Notification
-
-
- Updating the notification +
- Updating the notification
- Adding a sound
- Adding vibration
- Adding flashing lights @@ -25,6 +28,11 @@ parent.link=index.html
- Creating a Custom Expanded View
- {@link android.app.Notification} +
- {@link android.app.NotificationManager} +
- {@link android.widget.Toast} +
- A toast is a message that appears on the surface of the screen for a moment, but it +does not take focus (or pause the current activity), so it cannot accept user input +
- You can customize the toast layout to include images
- {@link android.widget.Toast} +
- Handling Focus
diff --git a/docs/html/guide/topics/ui/notifiers/toasts.jd b/docs/html/guide/topics/ui/notifiers/toasts.jd index 5b324d282b45b..0d3e10c0ac149 100644 --- a/docs/html/guide/topics/ui/notifiers/toasts.jd +++ b/docs/html/guide/topics/ui/notifiers/toasts.jd @@ -5,16 +5,24 @@ parent.link=index.html-Key classes
--
-
Quickview
+-
+
In this document
Key classes
+-
+
diff --git a/docs/html/guide/topics/ui/ui-events.jd b/docs/html/guide/topics/ui/ui-events.jd index ccef64fbf9773..7d7bfafc28983 100644 --- a/docs/html/guide/topics/ui/ui-events.jd +++ b/docs/html/guide/topics/ui/ui-events.jd @@ -13,9 +13,9 @@ parent.link=index.html-Key classes
+Quickview
-
-
In this document
+ +Key classes
+-
+
See also
+Related tutorials
-Key Classes
--
-
- {@link android.bluetooth.BluetoothAdapter} -
- {@link android.bluetooth.BluetoothDevice} -
- {@link android.bluetooth.BluetoothSocket} -
- {@link android.bluetooth.BluetoothServerSocket} -
Quickview
+-
+
- Android's bluetooth APIs allow your application to perform wireless data transactions with +other devices +
In this document
- The Basics @@ -33,11 +32,18 @@ page.title=Bluetooth
- Managing a Connection
See also
+ +Key classes
-
-
- Bluetooth Chat sample - app +
- {@link android.bluetooth.BluetoothAdapter} +
- {@link android.bluetooth.BluetoothDevice} +
- {@link android.bluetooth.BluetoothSocket} +
- {@link android.bluetooth.BluetoothServerSocket} +
Related samples
+
-Activity and task design quickview
+Quickview
diff --git a/docs/html/guide/practices/ui_guidelines/icon_design_1.jd b/docs/html/guide/practices/ui_guidelines/icon_design_1.jd index 1c75843dda867..995cfea6cca52 100644 --- a/docs/html/guide/practices/ui_guidelines/icon_design_1.jd +++ b/docs/html/guide/practices/ui_guidelines/icon_design_1.jd @@ -4,7 +4,7 @@ page.title=Icon Design Guidelines, Android 1.0-Icon design quickview
+Quickview
See also
- - -Older versions
+ +Downloads
+ + +See also
+ + +-Icon design quickview
+Quickview
Downloads
+ + +See also
diff --git a/docs/html/guide/practices/ui_guidelines/menu_design.jd b/docs/html/guide/practices/ui_guidelines/menu_design.jd index ebf8a4b237b23..840ee66b64d28 100644 --- a/docs/html/guide/practices/ui_guidelines/menu_design.jd +++ b/docs/html/guide/practices/ui_guidelines/menu_design.jd @@ -4,7 +4,7 @@ page.title=Menu Design Guidelines-Menu design quickview
+Quickview
-Widget design quickview
+Quickview
See also
-
-
-Signing quickview
+Quickview
-Market Licensing quickview:
+Quickview
Publishing an application means testing it, packaging it appropriately, and making it available to users of Android-powered mobile devices.
@@ -34,7 +20,7 @@ Applications document.-Before you consider your application ready for release:
+Before you consider your application ready for release:
Before you do the final compile of your application:
+Before you do the final compile of your application:
Compile your application...
-After compiling your application:
+ + +After you compile your application:
After compiling your application
+After you compile your application
9. Sign your application
diff --git a/docs/html/guide/publishing/publishing.jd b/docs/html/guide/publishing/publishing.jd index 9b470c89fbc6b..af1ea749f2e9e 100644 --- a/docs/html/guide/publishing/publishing.jd +++ b/docs/html/guide/publishing/publishing.jd @@ -4,7 +4,7 @@ page.title=Publishing Your Applications-Publishing quickview
+Quickview
-Versioning quickview
+Quickview
-Key classes
--
-
Quickview
+-
+
In this document
Key classes
+-
+
See also