docs: Android SDK r20 Release Notes - cherypick from dac-dev - Change-Id: I696dd125e04c8edb23ed88f8639af3b556c0b0e1
Change-Id: I37ac2387b1fcc6a321f5c8edc44abe834a01762d
diff --git a/docs/html/sdk/index.jd b/docs/html/sdk/index.jd
index e788ffe..a20d0b1 100644
--- a/docs/html/sdk/index.jd
+++ b/docs/html/sdk/index.jd
@@ -2,21 +2,21 @@
header.hide=1
page.metaDescription=Download the official Android SDK to develop apps for Android-powered devices.
-sdk.win_installer=installer_r18-windows.exe
-sdk.win_installer_bytes=37456234
-sdk.win_installer_checksum=48b1fe7b431afe6b9c8a992bf75dd898
+sdk.win_installer=installer_r20-windows.exe
+sdk.win_installer_bytes=70497095
+sdk.win_installer_checksum=0f25321554e2f88b247320d6a3bc1a7a
-sdk.win_download=android-sdk_r18-windows.zip
-sdk.win_bytes=37448775
-sdk.win_checksum=bfbfdf8b2d0fdecc2a621544d706fa98
+sdk.win_download=android-sdk_r20-windows.zip
+sdk.win_bytes=90353014
+sdk.win_checksum=b62b0f80f559c0ac670e9f058a21f0df
-sdk.mac_download=android-sdk_r18-macosx.zip
-sdk.mac_bytes=33903758
-sdk.mac_checksum=8328e8a5531c9d6f6f1a0261cb97af36
+sdk.mac_download=android-sdk_r20-macosx.zip
+sdk.mac_bytes=58203018
+sdk.mac_checksum=b6b6035ccec55ec2aa057438eb1db1f4
-sdk.linux_download=android-sdk_r18-linux.tgz
-sdk.linux_bytes=29731463
-sdk.linux_checksum=6cd716d0e04624b865ffed3c25b3485c
+sdk.linux_download=android-sdk_r20-linux.tgz
+sdk.linux_bytes=82589455
+sdk.linux_checksum=22a81cf1d4a951c62f71a8758290e9bb
@jd:body
diff --git a/docs/html/sdk/installing/installing-adt.jd b/docs/html/sdk/installing/installing-adt.jd
index 2925272..0e53e75 100644
--- a/docs/html/sdk/installing/installing-adt.jd
+++ b/docs/html/sdk/installing/installing-adt.jd
@@ -1,9 +1,9 @@
page.title=Installing the Eclipse Plugin
walkthru=1
-adt.zip.version=18.0.0
-adt.zip.download=ADT-18.0.0.zip
-adt.zip.bytes=12834793
-adt.zip.checksum=b446fa157ed97af79d1e21629201efbb
+adt.zip.version=20.0.0
+adt.zip.download=ADT-20.0.0.zip
+adt.zip.bytes=12387628
+adt.zip.checksum=ea0fc934af3b6b89097f0146c7822ed0
@jd:body
diff --git a/docs/html/tools/extras/support-library.jd b/docs/html/tools/extras/support-library.jd
index 7258c77..869a15b 100644
--- a/docs/html/tools/extras/support-library.jd
+++ b/docs/html/tools/extras/support-library.jd
@@ -46,14 +46,120 @@
<p>The sections below provide notes about successive releases of
the Support Package, as denoted by revision number.</p>
-<div class="toggle-content open">
+<script type="text/javascript">
+function toggleDiv(link) {
+ var toggleable = $(link).parent();
+ if (toggleable.hasClass("closed")) {
+ //$(".toggleme", toggleable).slideDown("fast");
+ toggleable.removeClass("closed");
+ toggleable.addClass("open");
+ $(".toggle-img", toggleable).attr("title", "hide").attr("src", (toRoot +
+"assets/images/triangle-opened.png"));
+ } else {
+ //$(".toggleme", toggleable).slideUp("fast");
+ toggleable.removeClass("open");
+ toggleable.addClass("closed");
+ $(".toggle-img", toggleable).attr("title", "show").attr("src", (toRoot +
+"assets/images/triangle-closed.png"));
+ }
+ return false;
+}
+</script>
- <p><a href="#" onclick="return toggleContent(this)">
- <img src="{@docRoot}assets/images/triangle-opened.png" class="toggle-content-img" />
- Support Package, revision 8 (April 2012)
- </a></p>
+<style>
+.toggleable {
+padding: 5px 0 0;
+}
+.toggleme {
+ padding: 10px 0 0 20px;
+}
+.toggleable a {
+ text-decoration:none;
+}
+.toggleme a {
+ text-decoration:underline;
+}
+.toggleable.closed .toggleme {
+ display:none;
+}
+#jd-content .toggle-img {
+ margin:0 5px 3px 0;
+}
+</style>
- <div class="toggle-content-toggleme" style="padding-left:2em">
+<div class="toggleable opened">
+ <a href="#" onclick="return toggleDiv(this)">
+ <img src="{@docRoot}assets/images/triangle-opened.png" class="toggle-img" height="9px" width="9px"
+/>Support Package, revision 9</a> <em>(June 2012)</em>
+ <div class="toggleme">
+ <dl>
+ <dt>Changes for v4 support library:</dt>
+ <dd>
+ <ul>
+
+ <li>User Interface Support
+ <ul>
+ <li>Added {@link android.support.v4.view.PagerTabStrip} support, providing enhanced
+functionality beyond {@link android.support.v4.view.PagerTitleStrip}.</li>
+ <li>Fixed various bugs for {@link android.support.v4.view.PagerTitleStrip} and
+{@link android.support.v4.view.PagerTabStrip}, including {@link
+android.widget.TextView#setAllCaps setAllCaps} option, title alignment,
+appearance improvements, minimum width constraints and touch navigation issues.</li>
+ <li>Added support for {@link android.support.v4.view.ViewPager} page gutters, which
+helps the {@link android.support.v4.view.ViewPager} class provide paging support for content with
+a large horizontal scroll range, such as a map.</li>
+ <li>Fixed numerous bugs for {@link android.support.v4.view.ViewPager}, including size
+and data set change problems, page positioning, user interaction, scroll tracking and keyboard
+navigation problems.</li>
+ <li>Fixed many bugs for {@link android.support.v4.app.Fragment}, including proper
+handling of {@link android.support.v4.app.Fragment#onActivityResult onActivityResult()} when
+the target fragment no longer exists, dispatching selection events to invisible fragments, improved
+{@link android.support.v4.app.FragmentTransaction#replace FragmentTransaction.replace()} behavior
+and added better state handling for fragments being moved out of view.</li>
+ <li>Added support for the {@link
+android.support.v4.view.ViewCompat postOnAnimation()} method in {@link
+android.support.v4.view.ViewCompat}.</li>
+ <li>Updated {@link android.support.v4.app.NavUtils} to use Android 4.1 (API level 16)
+<em>Up</em> navigation functionality when available.</li>
+ </ul>
+ </li>
+
+ <li>Accessibility
+ <ul>
+ <li>Updated accessibility support classes, including {@link
+android.support.v4.view.accessibility.AccessibilityNodeInfoCompat}, to follow fixes made in Android
+4.1 (API level 16).</li>
+ <li>Added support for accessibility scroll actions in {@link
+android.support.v4.view.ViewPager}.</li>
+ </ul>
+ </li>
+
+ <li>General improvements
+ <ul>
+ <li>Updated {@link android.support.v4.app.TaskStackBuilder} to reflect API changes in
+Android 4.1 (API level 16).</li>
+ <li>Enhanced {@link android.support.v4.app.TaskStackBuilder} to allow it to be used
+from a Service.</li>
+ <li>Added support for {@link android.support.v4.content.IntentCompat EXTRA_HTML_TEXT}
+to {@link android.support.v4.app.ShareCompat}.</li>
+ <li>Updated {@link android.support.v4.app.NotificationCompat.Builder} to support the
+{@link android.support.v4.app.NotificationCompat.Builder#setNumber setNumber()} method.</li>
+ <li>Added support in {@link android.support.v4.net.ConnectivityManagerCompat} for the
+{@link android.support.v4.net.ConnectivityManagerCompat#isActiveNetworkMetered
+isActiveNetworkMetered()} method.</li>
+ </ul>
+ </li>
+ </ul>
+ </dd>
+ </dl>
+ </div>
+</div>
+
+<div class="toggleable closed">
+ <a href="#" onclick="return toggleDiv(this)">
+ <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px"
+/>Support Package, revision 8</a> <em>(April 2012)</em>
+ <div class="toggleme">
<dl>
<dt>Changes for v4 support library:</dt>
<dd>
@@ -67,16 +173,14 @@
</ul>
</dd>
</dl>
+ </div>
</div>
-<div class="toggle-content closed">
-
- <p><a href="#" onclick="return toggleContent(this)">
- <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" />
- Support Package, revision 7 (March 2012)
- </a></p>
-
- <div class="toggle-content-toggleme" style="padding-left:2em">
+<div class="toggleable closed">
+ <a href="#" onclick="return toggleDiv(this)">
+ <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px"
+/>Support Package, revision 7</a> <em>(March 2012)</em>
+ <div class="toggleme">
<dl>
<dt>Changes for v4 support library:</dt>
<dd>
@@ -98,15 +202,14 @@
</dd>
</dl>
</div>
+</div>
-<div class="toggle-content closed">
+<div class="toggleable closed">
+ <a href="#" onclick="return toggleDiv(this)">
+ <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px"
+/>Support Package, revision 6</a> <em>(December 2011)</em>
+ <div class="toggleme">
- <p><a href="#" onclick="return toggleContent(this)">
- <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" />
- Support Package, revision 6 (December 2011)
- </a></p>
-
- <div class="toggle-content-toggleme" style="padding-left:2em">
<p class="note"><strong>Note:</strong> Reference for support library APIs are now available with
the framework references, for example: {@link android.support.v4.app}.</p>
<dl>
@@ -151,15 +254,13 @@
</dd>
</dl>
</div>
+</div>
-<div class="toggle-content closed">
-
- <p><a href="#" onclick="return toggleContent(this)">
- <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" />
- Support Package, revision 5 (December 2011)
- </a></p>
-
- <div class="toggle-content-toggleme" style="padding-left:2em">
+<div class="toggleable closed">
+ <a href="#" onclick="return toggleDiv(this)">
+ <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px"
+/>Support Package, revision 5</a> <em>(December 2011)</em>
+ <div class="toggleme">
<dl>
<dt>Changes for v4 support library:</dt>
<dd>
@@ -211,15 +312,13 @@
</dd>
</dl>
</div>
+</div>
-<div class="toggle-content closed">
-
- <p><a href="#" onclick="return toggleContent(this)">
- <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" />
- Support Package, revision 4 (October 2011)
- </a></p>
-
- <div class="toggle-content-toggleme" style="padding-left:2em">
+<div class="toggleable closed">
+ <a href="#" onclick="return toggleDiv(this)">
+ <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px"
+/>Support Package, revision 4</a> <em>(October 2011)</em>
+ <div class="toggleme">
<dl>
<dt>Changes for v4 support library:</dt>
<dd>
@@ -253,20 +352,14 @@
</dd>
</dl>
</div>
-
-
-
</div>
-<div class="toggle-content closed">
-
- <p><a href="#" onclick="return toggleContent(this)">
- <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" />
- Compatibility Package, revision 3 (July 2011)
- </a></p>
-
- <div class="toggle-content-toggleme" style="padding-left:2em">
+<div class="toggleable closed">
+ <a href="#" onclick="return toggleDiv(this)">
+ <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px"
+/>Compatibility Package, revision 3</a> <em>(July 2011)</em>
+ <div class="toggleme">
<dl>
<dt>Changes for v4 support library:</dt>
<dd>
@@ -309,18 +402,14 @@
</dd>
</dl>
</div>
-
</div>
-<div class="toggle-content closed">
-
- <p><a href="#" onclick="return toggleContent(this)">
- <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" />
- Compatibility Package, revision 2 (May 2011)
- </a></p>
-
- <div class="toggle-content-toggleme" style="padding-left:2em">
+<div class="toggleable closed">
+ <a href="#" onclick="return toggleDiv(this)">
+ <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px"
+/>Compatibility Package, revision 2</a> <em>(May 2011)</em>
+ <div class="toggleme">
<dl>
<dt>Changes for v4 library:</dt>
<dd>
@@ -332,21 +421,16 @@
</dd>
</dl>
</div>
-
</div>
-<div class="toggle-content closed">
-
- <p><a href="#" onclick="return toggleContent(this)">
- <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" />
- Compatibility Package, revision 1 (March 2011)
- </a></p>
-
- <div class="toggle-content-toggleme" style="padding-left:2em">
+<div class="toggleable closed">
+ <a href="#" onclick="return toggleDiv(this)">
+ <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px"
+/>Compatibility Package, revision 1</a> <em>(March 2011)</em>
+ <div class="toggleme">
<p>Initial release with the v4 library.</p>
</div>
-
</div>
diff --git a/docs/html/tools/sdk/eclipse-adt.jd b/docs/html/tools/sdk/eclipse-adt.jd
index ac200b6..ae3eb05 100644
--- a/docs/html/tools/sdk/eclipse-adt.jd
+++ b/docs/html/tools/sdk/eclipse-adt.jd
@@ -32,7 +32,8 @@
plugin and install it into your Eclipse development environment. Note that
before you can install or use ADT, you must have compatible versions of both the
Eclipse IDE and the Android SDK installed. For details, make sure to read <a
-href="#installing">Installing the ADT Plugin</a>, below. </p>
+href="{@docRoot}sdk/installing/installing-adt.html">Installing the Eclipse
+Plugin</a>. </p>
<p>If you are already using ADT, this document also provides instructions on
how to update ADT to the latest version or how to uninstall it, if necessary.
@@ -96,6 +97,128 @@
<a href="#" onclick="return toggleDiv(this)">
<img src="{@docRoot}assets/images/triangle-opened.png" class="toggle-img" height="9px"
width="9px" />
+ADT 20.0.0</a> <em>(June 2012)</em>
+ <div class="toggleme">
+<dl>
+ <dt>Dependencies:</dt>
+
+ <dd>
+ <ul>
+ <li>Java 1.6 or higher is required for ADT 20.0.0.</li>
+ <li>Eclipse Helios (Version 3.6.2) or higher is required for ADT 20.0.0.</li>
+ <li>ADT 20.0.0 is designed for use with <a href="{@docRoot}sdk/tools-notes.html">SDK Tools
+ r20</a>. If you haven't already installed SDK Tools r20 into your SDK, use the Android SDK
+ Manager to do so.</li>
+ </ul>
+ </dd>
+
+ <dt>General improvements:</dt>
+ <dd>
+ <ul>
+ <li>Application Templates
+ <ul>
+ <li>Added Android application templates to allow developers to create specific types of
+applications faster, using Android-recommended best practices.</li>
+ </ul>
+ </li>
+ <li>Performance
+ <ul>
+ <li>Improved overall ADT performance and fixed memory issues. Loading SDK data
+should be up to 30% faster.</li>
+ </ul>
+ </li>
+ <li>Tracer for GLES
+ <ul>
+ <li>Added new perspective view and tools for tracing OpenGL calls for an application and
+track the visual results of each call. (<a href="{@docRoot}tools/gltracer.html">more info</a>)</li>
+ </ul>
+ </li>
+ <li>Lint
+ <ul>
+ <li>Added new Lint rules for manifest registrations, duplicate activity
+registrations, security checking, correct use of Toast, missing SharedPreferences commit()
+calls, Fragment class instantiation, and handler leaks.</li>
+ <li>Created tighter integration of lint with the layout editor. (<a
+href="http://tools.android.com/recent/lintfeedback">more info</a>)</li>
+ <li>Added execution of Lint tool on save option for Java files. (<a
+href="http://tools.android.com/recent/lintonsave">more info</a>)</li>
+ </ul>
+ </li>
+ <li>Layout Editor (<a href="http://tools.android.com/recent/newlayouteditorpropertysheet">more
+info</a>)
+ <ul>
+ <li>Added highlighting (in bold) for important attributes, inline preview of colors and
+images, including the corresponding resource name.</li>
+ <li>Added display of default values, when available.</li>
+ <li>Added completion of resource values and enum and flag constants.</li>
+ <li>Added support for displaying advanced properties, and nested properties for better
+categorization, for example, layout params are listed first as a single nested property.</li>
+ <li>Display Tooltips over the attribute names, not values, so they never obscure the value
+column.</li>
+ <li>Provided checkbox support for boolean values.</li>
+ <li>Added support for switching between alphabetical and natural sort orders.</li>
+ <li>Improved layout editor tool's window management for more usable editing views.</li>
+ <li>Improved the layout editor's configuration chooser header user interface.</li>
+ </ul>
+ </li>
+ <li>XML Editing
+ <ul>
+ <li>Added go to declaration support for theme references (?android:attr, ?attr:).</li>
+ <li>Improved code completion in style definitions.</li>
+ <li>Improved code completion for the {@code minSdkVersion} and {@code targetSdkVersion}
+attributes in manifest files so that version descriptions are displayed for each of the API
+levels</li>
+ <li>Provided support for code completion of custom attributes for custom views,
+including current edits to the style files.</li>
+ <li>Improved synchronization of text and graphic editors with the XML outline view,
+including outline changes and display of current selection.</li>
+ </ul>
+ </li>
+ <li>Build System
+ <ul>
+ <li>Added automatic merging of library project manifest files into the including
+project's manifest. Enable this feature with the {@code manifestmerger.enabled} property.</li>
+ <li>Added automatic ProGuard support for the {@code aapt -G} flag. This change causes
+the build system to generate a temporary ProGuard keep-rules file containing classes that
+are referenced from XML files (such as custom views) and pass this to ProGuard at shrink-time. This
+can make the resulting APK much smaller when using just a small portion of a large library project
+(such as the Android Support library), since the catch-all rules to keep all custom views from the
+default ProGuard configuration file have also been removed.</li>
+ </ul>
+ </li>
+ <li>Added support building and debugging NDK-based Android projects.</li>
+ </li>
+ <li>Added support to the Asset Studio Wizard for padding and turning off background
+shapes.</li>
+ <li>Improved LogCat to allow developers to set colors for different priorities.</li>
+ <li>Improved app Run functionality to allow running on multiple devices with a single launch.
+The target tab in the launch configuration dialog includes an option to allow launching on all
+connected devices, with the option to further narrow the list to just physical devices or just
+emulators. (This feature is available only for Run configurations, and not for Debug or JUnit
+tests.)</li>
+ <ul>
+ </dd>
+
+ <dt>Bug fixes:</dt>
+ <dd>
+ <ul>
+ <li>Fixed a number of issues where Lint incorrectly reported code errors or failed to
+flag code issues.</li>
+ <li>Fixed several bugs in the layout editor.</li>
+ <li>Fixed compatibility issues with Eclipse 4.x (Juno), including cut/copy/paste
+functions.</li>
+ </ul>
+ </dd>
+
+</dl>
+
+</div>
+</div>
+
+<div class="toggleable closed">
+ <a href="#" onclick="return toggleDiv(this)">
+ <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px"
+width="9px" />
ADT 18.0.0</a> <em>(April 2012)</em>
<div class="toggleme">
<dl>
diff --git a/docs/html/tools/sdk/tools-notes.jd b/docs/html/tools/sdk/tools-notes.jd
index f08209b..5d9bb49 100644
--- a/docs/html/tools/sdk/tools-notes.jd
+++ b/docs/html/tools/sdk/tools-notes.jd
@@ -66,6 +66,81 @@
<a href="#" onclick="return toggleDiv(this)">
<img src="{@docRoot}assets/images/triangle-opened.png" class="toggle-img" height="9px"
width="9px" />
+ SDK Tools, Revision 20</a> <em>(June 2012)</em>
+
+ <div class="toggleme">
+ <dl>
+ <dt>Dependencies:</dt>
+ <dd>
+ <ul>
+ <li>Android SDK Platform-tools revision 12 or later.</li>
+ <li>If you are developing in Eclipse with ADT, note that the SDK Tools r20 is designed for
+ use with ADT 20.0.0 and later. If you haven't already, we highly recommend updating your
+ <a href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> to 20.0.0.</li>
+ <li>If you are developing outside Eclipse, you must have
+ <a href="http://ant.apache.org/">Apache Ant</a> 1.8 or later.</li>
+ </ul>
+ </dd>
+ <dt>General notes:</dt>
+ <dd>
+ <ul>
+ <li>Added new Device Monitor application, grouping Android debugging tools into a
+single application, including ddms, traceview, hierarchyviewer and Tracer for GLES. (<a
+href="{@docRoot}tools/gltracer.html">more info</a>)</li>
+ <li>Added new System Trace new tool for tracing Android system activity. This tool allow you
+to capture a slice of system activity, plus additional information tagged from the <strong>Settings
+> Developer Options > Monitoring: Enable traces</strong> or with specific calls added to your
+application code. (<a href="{@docRoot}tools/systrace.html">more info</a>)</li>
+ </li>
+ <li>Build System
+ <ul>
+ <li>Added automatic merging of library project manifest files into the including
+project's manifest. Enable this feature with the {@code manifestmerger.enabled} property.</li>
+ <li>Added automatic ProGuard support for the {@code aapt -G} flag. This change causes
+the build system to generate a temporary ProGuard keep-rules file containing classes that
+are referenced from XML files (such as custom views) and pass this to ProGuard at shrink-time. This
+can make the resulting APK much smaller when using just a small portion of a large library project
+(such as the Android Support library), since the catch-all rules to keep all custom views from the
+default ProGuard configuration file have also been removed.</li>
+ <li>Added two ProGuard configuration files for use in projects: {@code
+proguard-android-optimize.txt} which enables optimizations and {@code proguard-android.txt} which
+disables them.</li>
+ </ul>
+ </li>
+ <li>SDK Manager
+ <ul>
+ <li>Improved caching to reduce downloading of repository definitions.</li>
+ <li>Added <strong>Tools > Manage Add-on Sites</strong> option to allow deactivation of
+ third-party sites for improved performance (e.g., if one or more sites are temporarily slow to
+ load.)</li>
+ <li>Added settings for the SDK Manager download cache (<strong>SDK Manager > Tools >
+Options</strong>).</li>
+ </ul>
+ </li>
+ </ul>
+ </dd>
+ <dt>Bug fixes:</dt>
+ <dd>
+ <ul>
+ <li>Build
+ <ul>
+ <li>Fixed problem where test projects did not have access to the full classpath of tested
+projects, including Library Projects and third-party jars.</li>
+ <li>Fixed deployment logic so that applications with embedded tests can now be deployed
+and tested like test applications, including code coverage information.</li>
+ <li>Fixed Ant support for testing projects with libraries.</li>
+ </ul>
+ </li>
+ </ul>
+ </dd>
+ </dl>
+ </div>
+</div>
+
+<div class="toggleable closed">
+ <a href="#" onclick="return toggleDiv(this)">
+ <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px"
+ width="9px" />
SDK Tools, Revision 19</a> <em>(April 2012)</em>
<div class="toggleme">