From 52bfaaf7444c8b4d571d0c81fadbb1609411d6e1 Mon Sep 17 00:00:00 2001 From: Scott Main Date: Mon, 12 Nov 2012 19:39:58 -0800 Subject: [PATCH] docs: Android SDK Tools r21 Release Notes Change-Id: I7496c2af7592d8080ca4d0618466a9ccc578d0dd --- docs/html/sdk/installing/installing-adt.jd | 2 +- docs/html/tools/sdk/eclipse-adt.jd | 492 +++++++++++++++++------------ docs/html/tools/sdk/tools-notes.jd | 94 +++++- 3 files changed, 387 insertions(+), 201 deletions(-) diff --git a/docs/html/sdk/installing/installing-adt.jd b/docs/html/sdk/installing/installing-adt.jd index dcb9c3688426..93d1db68e1a2 100644 --- a/docs/html/sdk/installing/installing-adt.jd +++ b/docs/html/sdk/installing/installing-adt.jd @@ -9,7 +9,7 @@ adt.zip.checksum=7db4eaae5df6a34fd853317a2bd8250b

Android offers a custom plugin for the Eclipse IDE, called Android -Development Tools (ADT). This plugin is designed to give you a powerful, integrated +Development Tools (ADT). This plugin provides a powerful, integrated environment in which to develop Android apps. It extends the capabilities of Eclipse to let you quickly set up new Android projects, build an app UI, debug your app, and export signed (or unsigned) app packages (APKs) for distribution. diff --git a/docs/html/tools/sdk/eclipse-adt.jd b/docs/html/tools/sdk/eclipse-adt.jd index 10c622b84f86..f2ff07cd33fb 100644 --- a/docs/html/tools/sdk/eclipse-adt.jd +++ b/docs/html/tools/sdk/eclipse-adt.jd @@ -53,52 +53,135 @@ the ADT Plugin, as denoted by revision number.

For a summary of all known issues in ADT, see http://tools.android.com/knownissues.

- - - - - -
- - -ADT 20.0.3 (August 2012) -
+ +
+

+ ADT 21.0.0 (November 2012) +

+ +
+
+
Dependencies:
+ +
+
    +
  • Java 1.6 or higher is required for ADT 20.0.3.
    • +
  • Eclipse Helios (Version 3.6.2) or higher is required for ADT 21.0.0.
    • +
  • ADT 21.0.0 is designed for use with SDK + Tools r21. If you haven't already installed SDK Tools r21.0.0 into your SDK, use the + Android SDK Manager to do so.
    • +
+
+ +
General improvements:
+
+
    +
  • Layout Editor +
      +
    • Added multi-configuration editing feature that was previewed at Google I/O + developer tools talk in June. For an overview, see the + session recording + (starting at: 20:30).
      • +
    • Modified the layout logic so that setting a {@link android.app.Fragment} layout or + a {@link android.widget.ListView} preview layout is now applied not + only to the current layout but to all other configurations of the same layout.
      • +
    • Updated the editor to include resources from library projects in the resource chooser, + XML code completion, Go To Declaration and other editing contexts.
      • +
    • Updated the editor so that it no longer forces all variations of a single + layout into a single editor. You can, for example, open both the landscape and portrait + versions of a layout as separate editors and quickly switch between them, or even + re-dock your editors to edit them simultaneously. If you prefer the previous behavior, + set the new option in Preferences > Android > Editors to use the + old behavior.
      • +
    • Improved the handling of {@link android.widget.RelativeLayout} in the layout editor, + so that dragging widgets around and deleting them should now result in the layout + working more intuitively. In particular, deleting a widget causes the constraints + flowing through the deleted widgets to be intelligently adjusted, and when moving + widgets the constraints are preserved whenever possible.
      • +
    • Added the ability to specify a default action in Layout Editor views, which you can + invoke with the F2 key. For example, after dropping a button or text view, + you can press F2 to edit its text.
      • +
    • Added renaming of an ID (changing the {@code android:id} attribute) by invoking the + Rename shortcut.
      • +
    • Adding a new locale is now easier with the new Add Locale... action + in the locale menu. In addition to creating the new values folder, it lets you edit an + initial set of translations for the new locale.
      • +
    • Updated the editor so that when a custom view (or incorrectly configured view) + throws an exception during initialization or painting, part of the relevant stack trace + is shown inline in the layout editor, and you can click on the stack frames to jump to + the relevant location
      • +
    • Improved the editor error display to show the relevant part of a stack trace + when a custom view throws exceptions during rendering or construction, and provides + hyperlinks to the stack frames.
      • +
    • Improved the stack trace display for exceptions for custom views that are generated + during rendering.
      • +
    • Updated the configuration chooser so that it shows full language and region names (not + just 2-letter codes) in menus, in the configuration dialog and other editing contexts. +
      • +
    • Improved the device menu in the configuration chooser.
      • +
    +
    • +
  • Lint +
      +
    • Added over 25 new lint rules for resources, locale settings, layout + files, incorrect use of {@link android.util.SparseArray} and + {@link android.os.PowerManager.WakeLock} and manifest issues.
      • +
    • Improved the XML export function to support the + Jenkins Lint + plugin. +
      • +
    +
    • +
  • Editors +
      +
    • Modified the plugin to remember which editor mode (text or graphical) you were last + using for each type of editor (layout, manifest or values) and uses that mode for newly + opened files. This means that if you prefer to work with just XML, the editors start + showing you XML text editors after you have switched to them for each type of editor.
      • +
    • Updated XML code completion so that it completes (and shows documentation for) theme + references, such as {@code ?android:attr/dividerHeight}.
      • +
    +
    • +
  • Android Virtual Devices (AVD) +
      +
    • Added new Device Definitions tab in the AVD Manager for configuring + standard size and Nexus virtual devices.
      • +
    • Improved emulators so that they launch with a skin that is dynamically generated and + reflects the actual hardware configured in the AVD Manager.
      • +
    +
    • +
  • Improved the new template mechanism, cleaned up the existing templates and added + several new templates
    • +
  • Added ability to export images and frames in the Tracer for OpenGL ES tool.
    • +
  • Integrated the Systrace tool into the DDMS perspective.
    • +
  • Improved the JUnit test runner to allow a test to be run on all connected devices + simultaneously.
    • +
+
+ +
Bug fixes:
+
+
    +
  • Fixed the editors so that attributes and resources specified by XML files in the + {@code /values} directory are validated when files are saved.
    • +
  • Added a workaround for a bug in Eclipse on Mac OS X 10.8 where the Property Sheet was not + working properly.
    • +
+
+ +
+ +
+
+ +
+

+ ADT 20.0.3 (August 2012) +

+ +
Dependencies:
@@ -126,12 +209,13 @@ ADT 20.0.3 (August 2012)
-
- - -ADT 20.0.2 (July 2012) -
+
+

+ ADT 20.0.2 (July 2012) +

+ +
Dependencies:
@@ -149,7 +233,8 @@ ADT 20.0.2 (July 2012)
  • Fixed keybindings in various XML editors for Eclipse 4.x.
    • -
  • Fixed bug when creating layout configurations that already exist.
    • +
  • Fixed a bug that occurs when you try to create layout configurations that already + exist.
@@ -159,12 +244,13 @@ ADT 20.0.2 (July 2012)
-
- - -ADT 20.0.1 (July 2012) -
+
+

+ ADT 20.0.1 (July 2012) +

+ +
Dependencies:
@@ -199,12 +285,13 @@ unprotected receivers for default Android actions.
-
- - -ADT 20.0.0 (June 2012) -
+
+

+ ADT 20.0.0 (June 2012) +

+ +
Dependencies:
@@ -321,12 +408,13 @@ functions.
-
- - -ADT 18.0.0 (April 2012) -
+
+

+ ADT 18.0.0 (April 2012) +

+ +
Dependencies:
@@ -355,12 +443,13 @@ ADT 18.0.0 (April 2012)
-
- - -ADT 17.0.0 (March 2012) -
+
+

+ ADT 17.0.0 (March 2012) +

+ +
Dependencies:
@@ -444,10 +533,10 @@ select. (Issue (Issue 23940)
  • Fixed a locale bug affecting Turkish locales in particular. (Issue 23747)
    • -
  • Fixed issue where dex complains about duplicate classes in cases where a Library +
  • Fixed an issue where dex complains about duplicate classes in cases where a Library Project depends on the same jar files or Java-only projects.
    • -
  • Fixed issue where test projects had to independently reference the library projects used - by an app project. Now referencing only the app project is enough.
    • +
  • Fixed an issue where test projects had to independently reference the library projects + used by an app project. Now referencing only the app project is enough.
    • @@ -456,12 +545,13 @@ select. (Issue
    -
    - - -ADT 16.0.1 (December 2011) -
    +
    +

    + ADT 16.0.1 (December 2011) +

    + +
    Dependencies:
    @@ -489,12 +579,13 @@ ADT 16.0.1 (December 2011)
    -
    - - -ADT 16.0.0 (December 2011) -
    +
    +

    + ADT 16.0.0 (December 2011) +

    + +
    Dependencies:
    @@ -521,12 +612,13 @@ href="http://tools.android.com/recent/lint">more info)
    -
    - - -ADT 15.0.1 (November 2011) -
    +
    +

    + ADT 15.0.1 (November 2011) +

    + +
    Dependencies:
    @@ -554,12 +646,13 @@ ADT 15.0.1 (November 2011) -
    - - -ADT 15.0.0 (October 2011) -
    +
    +

    + ADT 15.0.0 (October 2011) +

    + +
    Dependencies:
    @@ -577,7 +670,7 @@ do so.
  • Fixed issues in the SDK Manager (Issue 20939, Issue 20607).
    • -
  • Fixed scrolling issue in the new Logcat panel of DDMS.
    • +
  • Fixed a scrolling issue in the new Logcat panel of DDMS.
    • @@ -585,12 +678,13 @@ do so.
    -
    - - -ADT 14.0.0 (October 2011) -
    +
    +

    + ADT 14.0.0 (October 2011) +

    + +
    Dependencies:
    @@ -703,12 +797,13 @@ Linux. -
    - - -ADT 12.0.0 (July 2011) -
    +
    +

    + ADT 12.0.0 (July 2011) +

    + +
    Dependencies:
    @@ -755,13 +850,13 @@ the Android SDK Manager to do so.
    -
    - - -ADT 11.0.0 (June 2011) -
    +
    +

    + ADT 11.0.0 (June 2011) +

    +
    Dependencies:
    @@ -891,12 +986,13 @@ href="http://tools.android.com/recent">Android Tools Project Site.

    -
    - - -ADT 10.0.1 (March 2011) -
    +
    +

    + ADT 10.0.1 (March 2011) +

    + +
    @@ -911,7 +1007,7 @@ so.
    • Temporary work-around to resolve the rare cases in which the layout editor will not open.
      • -
    • Fix issue in which ADT 10.0.0 would install on Eclipse 3.4 and lower, even though ADT +
    • Fixed an issue in which ADT 10.0.0 would install on Eclipse 3.4 and lower, even though ADT requires Eclipse 3.5 or higher (as of 10.0.0).
    @@ -921,13 +1017,13 @@ requires Eclipse 3.5 or higher (as of 10.0.0). -
    - - -ADT 10.0.0 (February 2011) -
    +
    +

    + ADT 10.0.0 (February 2011) +

    +
    Dependencies:
    @@ -971,13 +1067,13 @@ so.
    -
    - - -ADT 9.0.0 (January 2011) -
    +
    +

    + ADT 9.0.0 (January 2011) +

    +
    Dependencies:
    @@ -1080,13 +1176,13 @@ so. -
    - - -ADT 8.0.1 (December 2010) -
    +
    +

    + ADT 8.0.1 (December 2010) +

    +
    Dependencies:
    @@ -1109,13 +1205,13 @@ so.

    -
    - - -ADT 8.0.0 (December 2010) -
    +
    +

    + ADT 8.0.0 (December 2010) +

    +
    Dependencies:
    @@ -1146,9 +1242,9 @@ example, ADT 8.x is for SDK Tools r8.
  • Contextual menu with enum/flag type properties.
  • New zoom controls.
    • -
  • New HierarchyViewer plug-in integrated in Eclipse.
    • -
  • Android launch configurations don't recompile the whole workspace on launch anymore.
    • -
  • android.jar source and javadoc location can now be configured.
    • +
  • New HierarchyViewer plugin for Eclipse.
    • +
  • Android launch configurations no longer recompile the whole workspace on launch.
    • +
  • The location of android.jar source and javadoc can now be configured.
    • @@ -1156,12 +1252,13 @@ example, ADT 8.x is for SDK Tools r8.
    -
    - - -ADT 0.9.9 (September 2010) -
    +
    +

    + ADT 0.9.9 (September 2010) +

    +
    Dependencies:
    @@ -1183,13 +1280,13 @@ so.

    -
    - - -ADT 0.9.8 (September 2010) -
    - +
    +

    + ADT 0.9.8 (September 2010) +

    +
    @@ -1223,7 +1320,7 @@ href="{@docRoot}guide/practices/screens_support.html#range">Supporting Multiple Screens are now available.
  • Fixes problems with handling of library project names that contain characters that are incompatible with the Eclipse path variable. -Now properly sets up the link between the main project and the library +Now it properly sets up the link between the main project and the library project.
    • @@ -1232,12 +1329,13 @@ project.
    -
    - - -ADT 0.9.7 (May 2010) -
    +
    +

    + ADT 0.9.7 (May 2010) +

    +
    Library projects:
    @@ -1257,12 +1355,13 @@ project support through the Ant build system.

    -
    - - -ADT 0.9.6 (March 2010) -
    +
    +

    + ADT 0.9.6 (March 2010) +

    +
    Dependencies:
    @@ -1316,20 +1415,22 @@ Editor.
    • Applications launched from ADT now behave as if they were clicked from the Home screen.
      • -
    • Fixes issue where add-on with no optional library would not show up as valid +
    • Fixes an issue where add-ons without an optional library would not show up as valid targets for application launches.
      • -
    • Resolves possible crash when launching applications.
      • +
    • Resolves a possible crash when launching applications.
    -
    - - -ADT 0.9.5 (December 2009) -
    +
    +

    + ADT 0.9.5 (December 2009) +

    + +
    Dependencies:
    @@ -1342,9 +1443,10 @@ see Exploring the SDK.

    General notes:
      -
    • AVD Launch dialog now shows scale value.
      • -
    • Fixes potential NPE in SDK Manager on AVD launch, for older AVD with no skin name specified.
      • -
    • Fixes XML validation issue in on older Java versions.
      • +
    • The AVD Launch dialog now allows you to set the scale value.
      • +
    • Fixes a potential NullPointerException in the SDK Manager when you launch an AVD that does not + have a skin name specified.
      • +
    • Fixes an XML validation issue in older Java versions.
    • .apk packaging now properly ignores vi swap files as well as hidden files.
    @@ -1352,11 +1454,13 @@ see Exploring the SDK.

    -
    - - -ADT 0.9.4 (October 2009) -
    +
    +

    + ADT 0.9.4 (October 2009) +

    + +
    Dependencies:
    diff --git a/docs/html/tools/sdk/tools-notes.jd b/docs/html/tools/sdk/tools-notes.jd index f8b5d256b289..c5388d0e1b10 100644 --- a/docs/html/tools/sdk/tools-notes.jd +++ b/docs/html/tools/sdk/tools-notes.jd @@ -28,6 +28,89 @@ href="http://tools.android.com/knownissues">http://tools.android.com/knownissues

    SDK Tools, Revision 21 (November 2012) +

    + +
    + +
    +
    Dependencies:
    +
    +
      +
    • Android SDK Platform-tools revision 15 or later.
      • +
    • If you are developing in Eclipse with ADT, note that the SDK Tools r21 is designed + for use with ADT 21.0.0 and later. If you haven't already, update your + ADT Plugin to 21.0.0.
      • +
    • If you are developing outside Eclipse, you must have + Apache Ant 1.8 or later.
      • +
    +
    +
    General Notes:
    +
    +
      +
    • Build System +
        +
      • Added a flag that sets jumbo mode for DEX files, which allows a larger + number of strings in the DEX files. Enable this mode by adding the following line to + the {@code project.properties} file of your project: + 
        set dex.force.jumbo=true
        • +
      • Improved the build time by pre-dexing libraries (both JAR files and library + projects).
        • +
      • Updated the build to generate {@code R} resource classes for library projects + with only the IDs needed by the libraries, reducing the risk of hitting DEX file + limits for fields and methods.
        • +
      • Improved the build so that several editing features (code completion, resource + chooser, go to declaration) properly handle library project resources.
        • +
      +
      • +
    • Lint +
        +
      • Added over 25 new lint rules for resources, locale settings, layout + files, incorrect use of {@link android.util.SparseArray} and + {@link android.os.PowerManager.WakeLock} and manifest issues.
        • +
      • Updated reporting to include errors in library projects if the library project is + in the list of projects to be checked.
        • +
      • Added a new {@code lint} target to the Ant build system for easier + integration with continuous build systems.
        • +
      • Added new {@code --sources} and {@code --classpath} arguments to point to sources + with different directory structures.
        • +
      • Improved the XML export function to support the Jenkins Lint + plugin. +
        • +
      • Added support for class file flow analysis.
        • +
      +
      • +
    • Android Virtual Devices (AVD) +
        +
      • Added new Device Definitions tab in the AVD Manager for configuring + standard size and Nexus virtual devices.
        • +
      • Improved emulators so that they launch with a skin that is dynamically generated and + reflects the actual hardware configured in the AVD Manager.
        • +
      +
      • +
    • Added {@code jobb} tool for creating and encrypting + APK Expansion Files. + (more info) +
    • Improved the Android JUnit test runner to allow a test to be run on all connected + devices simultaneously.
      • +
    +
    + +
    Bug fixes:
    +
    +
      +
    • Fixed manifest merger to properly adapt library classes in the merged manifest.
      • +
    +
    + +
    +
    +
    + +
    +

    + SDK Tools, Revision 20.0.3 (August 2012)

    @@ -128,12 +211,12 @@ application code.
  • Added automatic merging of library project manifest files into the including project's manifest. Enable this feature with the {@code manifestmerger.enabled} property.
  • 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 +the build system to generate a temporary ProGuard {@code 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.
    • -
  • Added two ProGuard configuration files for use in projects: {@code +
  • 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.
    • @@ -141,9 +224,8 @@ disables them.
  • SDK Manager
    • Improved caching to reduce downloading of repository definitions.
      • -
    • Added Tools > Manage Add-on Sites option to allow deactivation of - third-party sites for improved performance (e.g., if one or more sites are temporarily slow to - load.)
      • +
    • Added Tools > Manage Add-on Sites option to improve performance by + allowing temporary deactivation of third-party sites if they are loading slowly.
    • Added settings for the SDK Manager download cache (SDK Manager > Tools > Options).
    -- 2.11.0