diff options
Diffstat (limited to 'docs/html/sdk/android-4.0.3.jd')
| -rw-r--r-- | docs/html/sdk/android-4.0.3.jd | 555 |
1 files changed, 0 insertions, 555 deletions
diff --git a/docs/html/sdk/android-4.0.3.jd b/docs/html/sdk/android-4.0.3.jd deleted file mode 100644 index f6dbee0..0000000 --- a/docs/html/sdk/android-4.0.3.jd +++ /dev/null @@ -1,555 +0,0 @@ -page.title=Android 4.0.3 Platform -sdk.platform.version=4.0.3 -sdk.platform.apiLevel=15 -@jd:body - -<div id="qv-wrapper"> -<div id="qv"> - -<h2>In this document</h2> -<ol> - <li><a href="#relnotes">Revisions</a></li> - <li><a href="#api">API Overview</a></li> - <li><a href="#Honeycomb">Previous APIs</a></li> - <li><a href="#api-level">API Level</a></li> - <li><a href="#apps">Built-in Applications</a></li> - <li><a href="#locs">Locales</a></li> - <li><a href="#skins">Emulator Skins</a></li> -</ol> - -<h2>Reference</h2> -<ol> -<li><a -href="{@docRoot}sdk/api_diff/15/changes.html">API -Differences Report »</a> </li> -</ol> - -</div> -</div> - -<p><em>API Level:</em> <strong>{@sdkPlatformApiLevel}</strong></p> - -<p>Android {@sdkPlatformVersion} is an incremental release of the Android 4.x -(Ice Cream Sandwich) platform family. This release includes new features for -users and developers, API changes, and various bug fixes.</p> - -<p>For developers, the Android {@sdkPlatformVersion} platform is available as a -downloadable component for the Android SDK. The development platform includes a -fully compliant Android library and system image as well as a set of emulator -skins, sample applications, and more. The downloadable platform includes no -external libraries.</p> - -<p>To start developing or testing against Android {@sdkPlatformVersion}, -use the Android SDK Manager to download the platform into your SDK. For more -information, see <a href="{@docRoot}sdk/adding-components.html">Adding SDK -Components</a>. If you are new to Android, <a -href="{@docRoot}sdk/index.html">download the SDK Starter Package</a> first.</p> - -<p>For a high-level overview of the new user and developer features, see the -<a href="http://developer.android.com/sdk/android-4.0-highlights.html">Platform -Highlights</a>.</p> - - -<h2 id="relnotes">Development Platform Revisions</h2> - -<p>The sections below provide notes about successive revisions of the Android -{@sdkPlatformVersion} development platform for the Android SDK, as denoted by -revision number. To determine what revisions you have installed in your SDK -environment, refer to the "Installed Packages" listing in the Android SDK -Manager.</p> - -<p class="caution"><strong>Important:</strong> To download the new Android -4.0.x system components from the Android SDK Manager, you must first update the -SDK tools to revision 14 or later and restart the Android SDK Manager. If you do not, -the Android 4.0.x system components will not be available for download.</p> - -<div class="toggle-content opened" style="padding-left:1em;"> - - <p><a href="#" onclick="return toggleContent(this)"> - <img src="{@docRoot}assets/images/triangle-opened.png" -class="toggle-content-img" alt="" /> - Revision 3</a> <em>(March 2012)</em> - </a></p> - - <div class="toggle-content-toggleme" style="padding-left:2em;"> - - <p>Maintenance update. The system version is 4.0.4.</p> - <p class="note"><strong>Note:</strong> This system image includes support for emulator -hardware graphics acceleration when used with SDK Tools r17 or higher. -(<a href="{@docRoot}guide/developing/devices/emulator.html#accel-graphics">more info</a>)</p> - <dl> - <dt>Dependencies:</dt> - <dd>SDK Tools r17 or higher is required.</dd> - </dl> - - </div> -</div> - -<div class="toggle-content closed" style="padding-left:1em;"> - - <p><a href="#" onclick="return toggleContent(this)"> - <img src="{@docRoot}assets/images/triangle-closed.png" -class="toggle-content-img" alt="" /> - Revision 2</a> <em>(January 2012)</em> - </a></p> - - <div class="toggle-content-toggleme" style="padding-left:2em;"> - - <p>Maintenance update. The system version is 4.0.3.</p> - <dl> - <dt>Dependencies:</dt> - <dd>SDK Tools r14 or higher is required.</dd> - </dl> - - </div> -</div> - -<div class="toggle-content closed" style="padding-left:1em;"> - - <p><a href="#" onclick="return toggleContent(this)"> - <img src="{@docRoot}assets/images/triangle-closed.png" -class="toggle-content-img" alt="" /> - Revision 1</a> <em>(December 2011)</em> - </a></p> - - <div class="toggle-content-toggleme" style="padding-left:2em;"> - - <p>Initial release. The system version is 4.0.3.</p> - <dl> - <dt>Dependencies:</dt> - <dd>SDK Tools r14 or higher is required.</dd> - </dl> - - </div> -</div> - -<h2 id="api">API Overview</h2> - -<p>The sections below provide a technical overview of new APIs in Android 4.0.3.</p> - -<div class="toggle-content closed" style="padding-left:1em;"> - - <p><a href="#" onclick="return toggleContent(this)"> - <img src="{@docRoot}assets/images/triangle-closed.png" -class="toggle-content-img" alt="" /> - <strong>Table of Contents</strong> - </a></p> - - <div class="toggle-content-toggleme" style="padding-left:2em;"> - <ol class="toc" style="margin-left:-1em"> - <li><a href="#contacts">Social stream API in Contacts Provider</a></li> - <li><a href="#calendar">Calendar Provider</a></li> - <li><a href="#widgets">Home screen widgets</a></li> - <li><a href="#textservices">Spell-checking</a></li> - <li><a href="#bluetooth">Bluetooth</a></li> - <li><a href="#ui">UI toolkit</a></li> - <li><a href="#accessibility">Accessibility</a></li> - <li><a href="#tts">Text-to-speech</a></li> - <li><a href="#database">Database</a></li> - <li><a href="#intents">Intents</a></li> - <li><a href="#camera">Camera</a></li> - <li><a href="#permissions">Permissions</a></li> - </ol> - </div> -</div> - - - - - -<h3 id="contacts">Social stream API in Contacts Provider</h3> - -<p>Applications that use social stream data such as status updates and check-ins -can now sync that data with each of the user’s contacts, providing items in a -stream along with photos for each.</p> - -<p>The database table that contains an individual contact’s social stream is -defined by {@link android.provider.ContactsContract.StreamItems}, the Uri for -which is nested within the {@link android.provider.ContactsContract.RawContacts} -directory to which the stream items belong. Each social stream table includes -several columns for metadata about each stream item, such as an icon -representing the source (an avatar), a label for the item, the primary text -content, comments about the item (such as responses from other people), and -more. Photos associated with a stream are stored in another table, defined by -{@link android.provider.ContactsContract.StreamItemPhotos}, which is available -as a sub-directory of the {@link android.provider.ContactsContract.StreamItems} -Uri.</p> - -<p>See {@link android.provider.ContactsContract.StreamItems} and -{@link android.provider.ContactsContract.StreamItemPhotos} for more information.</p> - -<p>To read or write social stream items for a contact, an application must -request permission from the user by declaring <code><uses-permission -android:name="android.permission.READ_SOCIAL_STREAM"></code> and/or <code><uses-permission -android:name="android.permission.WRITE_SOCIAL_STREAM"></code> in their manifest files.</p> - -<h3 id="calendar">Calendar Provider</h4> -<ul> -<li>Adds the class {@link android.provider.CalendarContract.Colors} to represent -a color table in the <a href="{@docRoot}guide/topics/providers/calendar-provider.html">Calendar -Provider</a>. The class provides fields for accessing -colors available for a given account. Colors are referenced by -{@link android.provider.CalendarContract.ColorsColumns#COLOR_KEY COLOR_KEY} -which must be unique for a given account name/type. These values can only be -updated by the sync adapter.</li> -<li>Adds {@link android.provider.CalendarContract.CalendarColumns#ALLOWED_AVAILABILITY ALLOWED_AVAILABILITY} -and -{@link android.provider.CalendarContract.CalendarColumns#ALLOWED_ATTENDEE_TYPES ALLOWED_ATTENDEE_TYPES} -for exchange/sync support.</li> -<li>Adds {@link android.provider.CalendarContract.AttendeesColumns#TYPE_RESOURCE} -(such as conference rooms) for attendees and -{@link android.provider.CalendarContract.EventsColumns#AVAILABILITY_TENTATIVE}, -as well as {@link android.provider.CalendarContract.EventsColumns#EVENT_COLOR_KEY} -for events.</li> -</ul> - -<h3 id="widgets">Home screen widgets</h3> - -<p>Starting from Android 4.0, home screen widgets should no longer include their -own padding. Instead, the system now automatically adds padding for each widget, -based the characteristics of the current screen. This leads to a more uniform, -consistent presentation of widgets in a grid. To assist applications that host -home screen widgets, the platform provides a new method -{@link android.appwidget.AppWidgetHostView#getDefaultPaddingForWidget(android.content.Context, android.content.ComponentName, android.graphics.Rect) -getDefaultPaddingForWidget()}. Applications can call this method to get the -system-defined padding and account for it when computing the number of cells to -allocate to the widget.</p> - -<h3 id="textservices">Spell-checking</h3> - -<ul> -<li>For apps that accessing spell-checker services, a new {@link -android.view.textservice.SpellCheckerSession#cancel() cancel()} method cancels -any pending and running spell-checker tasks in a session.</li> - -<li>For spell-checker services, a new suggestions flag, -{@link android.view.textservice.SuggestionsInfo#RESULT_ATTR_HAS_RECOMMENDED_SUGGESTIONS}, -lets the services distinguish higher-confidence suggestions from -lower-confidence ones. For example, a spell-checker could set the flag if an -input word is not in the user dictionary but has likely suggestions, or not set -the flag if an input word is not in the dictionary and has suggestions that are -likely to be less useful. - -<p>Apps connected to the spell-checker can use the {@link -android.view.textservice.SuggestionsInfo#RESULT_ATTR_HAS_RECOMMENDED_SUGGESTIONS} -flag in combination with other suggestion attributes, as well as the {@link -android.view.textservice.SuggestionsInfo#getSuggestionsAttributes()} and {@link -android.view.textservice.SuggestionsInfo#getSuggestionsCount()} methods, to -determine whether to mark input words as typos and offer suggestions.</p></li> - -<li>A new {@link android.text.style.SuggestionSpan#FLAG_AUTO_CORRECTION} style -for text spans indicates that auto correction is about to be applied to a -word/text that the user is typing/composing. This type of suggestion is rendered -differently, to indicate the auto correction is happening.</li> -</ul> - -<h3 id="bluetooth">Bluetooth</h3> -<p>New public methods {@link -android.bluetooth.BluetoothDevice#fetchUuidsWithSdp()} and {@link -android.bluetooth.BluetoothDevice#getUuids()} let apps determine the features -(UUIDs) supported by a remote device. In the case of {@link -android.bluetooth.BluetoothDevice#fetchUuidsWithSdp()}, the system performs a -service discovery on the remote device to get the UUIDs supported, then -broadcasts the result in an {@link -android.bluetooth.BluetoothDevice#ACTION_UUID} intent.</p> - -<h3 id="ui">UI toolkit</h3> - -<p>New methods {@link android.app.Fragment#setUserVisibleHint(boolean) setUserVisibleHint()} and -{@link android.app.Fragment#getUserVisibleHint() getUserVisibleHint()} allow a -fragment to set a hint of whether or not it is currently user-visible. The -system defers the start of fragments that are not user-visible until the loaders -for visible fragments have run. The visibility hint is "true" by default.</li> -</p> - -<h3 id="graphics">Graphics</h3> - -<ul> -<li>New method {@link android.graphics.SurfaceTexture#setDefaultBufferSize(int -width, int height)} in {@link android.graphics.SurfaceTexture} sets the default size of the image -buffers. This method may be used to set the image size when producing images -with {@link android.graphics.Canvas} (via {@link -android.view.Surface#lockCanvas}), or OpenGL ES (via an EGLSurface).</li> -<li>Adds definitions for the enums of the GL_OES_EGL_image_external OpenGL ES extension — -{@link android.opengl.GLES11Ext#GL_REQUIRED_TEXTURE_IMAGE_UNITS_OES}, -{@link android.opengl.GLES11Ext#GL_SAMPLER_EXTERNAL_OES}, -{@link android.opengl.GLES11Ext#GL_TEXTURE_BINDING_EXTERNAL_OES}, and -{@link android.opengl.GLES11Ext#GL_TEXTURE_EXTERNAL_OES}.</li> -</ul> - -<h3 id="accessibility">Accessibility</h3> - -<ul> -<li>Clients of {@link android.widget.RemoteViews} can now use the method {@link -android.widget.RemoteViews#setContentDescription(int, java.lang.CharSequence) -setContentDescription()} to set and get the content description of any View in -the inflated layout.</li> - -<li>The methods {@link android.view.accessibility.AccessibilityRecord#getMaxScrollX()}, -{@link android.view.accessibility.AccessibilityRecord#getMaxScrollY()}, -{@link android.view.accessibility.AccessibilityRecord#setMaxScrollX(int) setMaxScrollX()}, and -{@link android.view.accessibility.AccessibilityRecord#setMaxScrollY(int) setMaxScrollY()} -allow apps to get and set the maximum scroll offset for an -{@link android.view.accessibility.AccessibilityRecord} object.</li> - -<li>When touch-exploration mode is enabled, a new secure setting -{@link android.provider.Settings.Secure#ACCESSIBILITY_SPEAK_PASSWORD} -indicates whether the user requests the IME to speak text entered in password fields, even when -a headset is not in use. By default, no password text is spoken unless a headset -is in use.</li> -</ul> - -<h3 id="tts">Text-to-speech</h3> - -<ul> -<li>Adds the new method {@link -android.speech.tts.TextToSpeech.Engine#getFeatures(java.util.Locale) -getFeatures()}for querying and enabling network TTS support. -<li>Adds a new listener class, {@link -android.speech.tts.UtteranceProgressListener}, that engines can register to -receive notification of speech-synthesis errors.</li> -</ul> - -<h3 id="database">Database</h3> - -<ul> -<li>A new {@link android.database.CrossProcessCursorWrapper} class lets content -providers return results for a cross-process query more efficiently. The new -class is a useful building block for wrapping cursors that will be sent to -processes remotely. It can also transform normal {@link android.database.Cursor} -objects into {@link android.database.CrossProcessCursor} objects -transparently. - -<p>The {@link android.database.CrossProcessCursorWrapper} class fixes common -performance issues and bugs that applications have encountered when -implementing content providers.</p></li> - -<li>The {@link android.database.CursorWindow#CursorWindow(java.lang.String)} -constructor now takes a name string as input. The system no longer distinguishes -between local and remote cursor windows, so {@link -android.database.CursorWindow#CursorWindow(boolean)} is now deprecated.</li> -</ul> - -<h3 id="intents">Intents</h3> - -<p>Adds new categories for targeting common types of applications on the -device, such as {@link android.content.Intent#CATEGORY_APP_BROWSER}, {@link -android.content.Intent#CATEGORY_APP_CALENDAR}, {@link -android.content.Intent#CATEGORY_APP_MAPS}, and more.</li> - -<h3 id="camera">Camera</h3> - -<ul> -<li>{@link android.media.MediaMetadataRetriever} adds the new constant -{@link android.media.MediaMetadataRetriever#METADATA_KEY_LOCATION} to let apps -access retrieve location information for an image or video. </li> - -<li>{@link android.media.CamcorderProfile} adds the QVGA (320x240) resolution -profiles. Quality level is represented by the -{@link android.media.CamcorderProfile#QUALITY_QVGA}.and -{@link android.media.CamcorderProfile#QUALITY_TIME_LAPSE_QVGA} constants.</li> - -<li>New methods {@link android.hardware.Camera.Parameters#setVideoStabilization(boolean) setVideoStabilization()}, -{@link android.hardware.Camera.Parameters#getVideoStabilization() setVideoStabilization()}, and {@link android.hardware.Camera.Parameters#isVideoStabilizationSupported() isVideoStabilizationSupported()} -let you check and manage video stabilization for a {@link android.hardware.Camera}.</li> -</ul> - -<h3 id="Permissions">Permissions</h3> - -<p>The following are new permissions:</p> -<ul> -<li>{@link android.Manifest.permission#READ_SOCIAL_STREAM} and -{@link android.Manifest.permission#WRITE_SOCIAL_STREAM}: Allow a sync -adapter to read and write social stream data to a contact in the shared -Contacts Provider.</li> -</ul> - - -<div class="special" style="margin-top:2em"> -<p>For a detailed view of all API changes in Android {@sdkPlatformVersion} (API Level -{@sdkPlatformApiLevel}), see the <a -href="{@docRoot}sdk/api_diff/{@sdkPlatformApiLevel}/changes.html">API Differences Report</a>.</p> -</div> - - -<h2 id="api-level">API Level</h2> - -<p>The Android {@sdkPlatformVersion} API is assigned an integer -identifier—<strong>{@sdkPlatformApiLevel}</strong>—that is stored in the system itself. -This identifier, called the "API level", allows the system to correctly determine whether an -application is compatible with the system, prior to installing the application. </p> - -<p>To use APIs introduced in Android {@sdkPlatformVersion} in your application, you need compile the -application against an Android platform that supports API level {@sdkPlatformApiLevel} or -higher. Depending on your needs, you might also need to add an -<code>android:minSdkVersion="{@sdkPlatformApiLevel}"</code> attribute to the -<a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html">{@code <uses-sdk>}</a> -element.</p> - -<p>For more information, see the <a href="{@docRoot}guide/appendix/api-levels.html">API Levels</a> -document. </p> - - -<h2 id="apps">Built-in Applications</h2> - -<p>The system image included in the downloadable platform provides these -built-in applications:</p> - -<table style="border:0;padding-bottom:0;margin-bottom:0;"> -<tr> -<td style="border:0;padding-bottom:0;margin-bottom:0;"> -<ul> -<li>API Demos</li> -<li>Browser</li> -<li>Calculator</li> -<li>Calendar</li> -<li>Camera</li> -<li>Clock</li> -<li>Custom Locale</li> -<li>Dev Tools</li> -<li>Downloads</li> -<li>Email</li> -<li>Gallery</li> -</ul> -</td> -<td style="border:0;padding-bottom:0;margin-bottom:0;padding-left:5em;"> -<ul> -<li>Gestures Builder</li> -<li>Messaging</li> -<li>Music</li> -<li>People</li> -<li>Phone</li> -<li>Search</li> -<li>Settings</li> -<li>Speech Recorder</li> -<li>Widget Preview</li> -</ul> -</td> -</tr> -</table> - - -<h2 id="locs" style="margin-top:.75em;">Locales</h2> - -<p>The system image included in the downloadable SDK platform provides a variety of built-in -locales. In some cases, region-specific strings are available for the locales. In other cases, a -default version of the language is used. The languages that are available in the Android 3.0 system -image are listed below (with <em>language</em>_<em>country/region</em> locale descriptor).</p> - -<table style="border:0;padding-bottom:0;margin-bottom:0;"> -<tr> -<td style="border:0;padding-bottom:0;margin-bottom:0;"> -<ul> -<li>Arabic, Egypt (ar_EG)</li> -<li>Arabic, Israel (ar_IL)</li> -<li>Bulgarian, Bulgaria (bg_BG)</li> -<li>Catalan, Spain (ca_ES)</li> -<li>Czech, Czech Republic (cs_CZ)</li> -<li>Danish, Denmark(da_DK)</li> -<li>German, Austria (de_AT)</li> -<li>German, Switzerland (de_CH)</li> -<li>German, Germany (de_DE)</li> -<li>German, Liechtenstein (de_LI)</li> -<li>Greek, Greece (el_GR)</li> -<li>English, Australia (en_AU)</li> -<li>English, Canada (en_CA)</li> -<li>English, Britain (en_GB)</li> -<li>English, Ireland (en_IE)</li> -<li>English, India (en_IN)</li> -<li>English, New Zealand (en_NZ)</li> -<li>English, Singapore(en_SG)</li> -<li>English, US (en_US)</li> -<li>English, South Africa (en_ZA)</li> -<li>Spanish (es_ES)</li> -<li>Spanish, US (es_US)</li> -<li>Finnish, Finland (fi_FI)</li> -<li>French, Belgium (fr_BE)</li> -<li>French, Canada (fr_CA)</li> -<li>French, Switzerland (fr_CH)</li> -<li>French, France (fr_FR)</li> -<li>Hebrew, Israel (he_IL)</li> -<li>Hindi, India (hi_IN)</li> -</ul> -</td> -<td style="border:0;padding-bottom:0;margin-bottom:0;padding-left:5em;"> -<li>Croatian, Croatia (hr_HR)</li> -<li>Hungarian, Hungary (hu_HU)</li> -<li>Indonesian, Indonesia (id_ID)</li> -<li>Italian, Switzerland (it_CH)</li> -<li>Italian, Italy (it_IT)</li> -<li>Japanese (ja_JP)</li> -<li>Korean (ko_KR)</li> -<li>Lithuanian, Lithuania (lt_LT)</li> -<li>Latvian, Latvia (lv_LV)</li> -<li>Norwegian bokmål, Norway (nb_NO)</li> -<li>Dutch, Belgium (nl_BE)</li> -<li>Dutch, Netherlands (nl_NL)</li> -<li>Polish (pl_PL)</li> -<li>Portuguese, Brazil (pt_BR)</li> -<li>Portuguese, Portugal (pt_PT)</li> -<li>Romanian, Romania (ro_RO)</li> -<li>Russian (ru_RU)</li></li> -<li>Slovak, Slovakia (sk_SK)</li> -<li>Slovenian, Slovenia (sl_SI)</li> -<li>Serbian (sr_RS)</li> -<li>Swedish, Sweden (sv_SE)</li> -<li>Thai, Thailand (th_TH)</li> -<li>Tagalog, Philippines (tl_PH)</li> -<li>Turkish, Turkey (tr_TR)</li> -<li>Ukrainian, Ukraine (uk_UA)</li> -<li>Vietnamese, Vietnam (vi_VN)</li> -<li>Chinese, PRC (zh_CN)</li> -<li>Chinese, Taiwan (zh_TW)</li> -</td> -</tr> -</table> - -<p class="note"><strong>Note:</strong> The Android platform may support more -locales than are included in the SDK system image. All of the supported locales -are available in the <a href="http://source.android.com/">Android Open Source -Project</a>.</p> - -<h2 id="skins">Emulator Skins</h2> - -<p>The downloadable platform includes the following emulator skins:</p> - -<ul> - <li> - QVGA (240x320, low density, small screen) - </li> - <li> - WQVGA400 (240x400, low density, normal screen) - </li> - <li> - WQVGA432 (240x432, low density, normal screen) - </li> - <li> - HVGA (320x480, medium density, normal screen) - </li> - <li> - WVGA800 (480x800, high density, normal screen) - </li> - <li> - WVGA854 (480x854 high density, normal screen) - </li> - <li> - WXGA720 (1280x720, extra-high density, normal screen) - </li> - <li> - WSVGA (1024x600, medium density, large screen) - </li> - <li> - WXGA (1280x800, medium density, xlarge screen) - </li> -</ul> - -<p>To test your application on an emulator that represents the latest Android device, you can create -an AVD with the new WXGA720 skin (it's an xhdpi, normal screen device). Note that the emulator -currently doesn't support the new on-screen navigation bar for devices without hardware navigation -buttons, so when using this skin, you must use keyboard keys <em>Home</em> for the Home button, -<em>ESC</em> for the Back button, and <em>F2</em> or <em>Page-up</em> for the Menu button.</p> - -<p>However, due to performance issues in the emulator when running high-resolution screens such as -the one for the WXGA720 skin, we recommend that you primarily use the traditional WVGA800 skin -(hdpi, normal screen) to test your application.</p> - |