docs: Android SDK r20 Release Notes - cherypick from dac-dev - Change-Id:... (f86f0e68) · Commits · e / os / android_frameworks_base

docs/html/sdk/index.jd

+12 −12

Original line number	Diff line number	Diff line
		@@ -2,21 +2,21 @@ page.title=Android SDK
		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

docs/html/sdk/installing/installing-adt.jd

+4 −4

Original line number	Diff line number	Diff line
		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

docs/html/tools/extras/support-library.jd

+151 −67

Original line number	Diff line number	Diff line
		@@ -46,14 +46,120 @@ by the directory name, such as {@code v4/} and {@code v13/}.</p>
		<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>
		@@ -68,15 +174,13 @@ the Support Package, as denoted by revision number.</p>
		</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 @@ for creating standardized system notifications.</li>
		</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 6 (December 2011)
		</a></p>
		<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">

		<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 @@ for creating standardized system notifications.</li>
		</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 @@ for creating standardized system notifications.</li>
		</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 @@ for creating standardized system notifications.</li>
		</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 @@ Android 3.2 and higher (all other APIs in the v4 library are already available w
		</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 @@ Android 3.2 and higher (all other APIs in the v4 library are already available w
		</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>

docs/html/tools/sdk/eclipse-adt.jd

+124 −1

Original line number	Diff line number	Diff line
		@@ -32,7 +32,8 @@ incredible boost in developing Android applications. </p>
		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 @@ padding: 5px 0 0;
		<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>

docs/html/tools/sdk/tools-notes.jd

+75 −0

Original line number	Diff line number	Diff line
		@@ -66,6 +66,81 @@ padding: 5px 0 0;
		<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">