From 276f0ce4df7f58786da08c34f548456129144aed Mon Sep 17 00:00:00 2001 From: Scott Main Date: Thu, 11 Jul 2013 15:31:10 -0700 Subject: update Android Studio for v0.2.0. add release notes and troubleshooting topics Change-Id: Ic924d61f9ab9208ed3275edb8837d8593d752ae9 --- docs/html/images/tools/studio_error_eventlog.png | Bin 0 -> 2259 bytes docs/html/images/tools/studio_error_gradle5.png | Bin 0 -> 48854 bytes docs/html/images/tools/studio_error_supportlib.png | Bin 0 -> 171678 bytes docs/html/sdk/installing/studio.jd | 188 ++++++++++++++++++--- 4 files changed, 167 insertions(+), 21 deletions(-) create mode 100644 docs/html/images/tools/studio_error_eventlog.png create mode 100644 docs/html/images/tools/studio_error_gradle5.png create mode 100644 docs/html/images/tools/studio_error_supportlib.png (limited to 'docs') diff --git a/docs/html/images/tools/studio_error_eventlog.png b/docs/html/images/tools/studio_error_eventlog.png new file mode 100644 index 0000000..909b285 Binary files /dev/null and b/docs/html/images/tools/studio_error_eventlog.png differ diff --git a/docs/html/images/tools/studio_error_gradle5.png b/docs/html/images/tools/studio_error_gradle5.png new file mode 100644 index 0000000..13de607 Binary files /dev/null and b/docs/html/images/tools/studio_error_gradle5.png differ diff --git a/docs/html/images/tools/studio_error_supportlib.png b/docs/html/images/tools/studio_error_supportlib.png new file mode 100644 index 0000000..603b54c Binary files /dev/null and b/docs/html/images/tools/studio_error_supportlib.png differ diff --git a/docs/html/sdk/installing/studio.jd b/docs/html/sdk/installing/studio.jd index 8825bcc..eeb8896 100644 --- a/docs/html/sdk/installing/studio.jd +++ b/docs/html/sdk/installing/studio.jd @@ -249,36 +249,36 @@ download (or continue to use) the Windows - android-studio-bundle-130.677228-windows.exe + href="http://dl.google.com/android/studio/android-studio-bundle-130.737825-windows.exe"> + android-studio-bundle-130.737825-windows.exe - 393023485 bytes - 3da987a9778b66edb68fb43d8b53bfcb + 396091268 bytes + 6da1bc8effa048c8ff669e4c484eb11f Mac OS X - android-studio-bundle-130.687321-mac.dmg + href="http://dl.google.com/android/studio/android-studio-bundle-130.737825-mac.dmg"> + android-studio-bundle-130.737825-mac.dmg - 379877697 bytes - eb5ca6c77f4a119595d941daeda58810 + 383326582 bytes + 2959bc5039238d286670cc6225342b89 Linux - android-studio-bundle-130.687321-linux.tgz + href="http://dl.google.com/android/studio/android-studio-bundle-130.737825-linux.tgz"> + android-studio-bundle-130.737825-linux.tgz - 406516375 bytes - 6796d66de07c85b2822ca8d501a043c0 + 409935592 bytes + dcd13922f7cf577e3c852b224205d843 @@ -286,6 +286,25 @@ download (or continue to use) the +

Updating to 0.2.x

+ +

To update your existing version of Android Studio to 0.2.x, simply +follow the installation instructions below and replace your existing +installation.

+ +

Caution: Replacing your existing installation of +Android Studio will remove any additional SDK packages you've installed, such as target +platforms, system images, and sample apps. To preserve these, copy them from your current +SDK directory under Android Studio to a temporary location +before installing the update. Then move them back once the update is complete. +If you fail to copy these packages, then you can instead download them again through +the Android SDK Manager.

+ +

Also note that due to the update to Gradle 0.5, you will encounter errors when opening +existing projects. See the Troubleshooting notes below for +information about how to resolve them.

+ +

Installing Android Studio

  1. Download the Android Studio package from above.
    2. @@ -390,14 +409,78 @@ style="vertical-align:bottom;margin:0;height:19px" /> in the toolbar.

    Revisions

    -

    Note: Periodic updates are pushed to Android Studio -without requiring you to update from here. To manually check for updates, select -Help > Check for updates (on Mac, select Android Studio > -Check for updates).

    +

    Note: There is not a patch update available from +0.1.9 to 0.2. To update from Android Studio 0.1.x to 0.2.x, you must +install a new Android Studio bundle from this page. The reason for that is that we have made +changes to the bundled SDK such that it includes a pre-configured local Maven repository +which can serve up the v4 support library and which is required for creating new projects.

    +

    Android Studio v0.2.x (July 2013) +

    + +
    +
      +
    • Merged in the latest IntelliJ codebase changes. Includes fixes for issues reported by Studio users such as tweaks to Linux font sizes and font rendering.
      • +
    • Android Gradle plug-in updated to 0.5.0. +

      Caution: This new version is not backwards compatible. + When opening a project that uses an older version of the plug-in, Studio will show an error + stating Gradle <project_name> project refresh failed. See Troubleshooting below for details.

      +

      The updated Gradle plug-in includes the following changes:

      +
        +
      • Fixed IDE model to contain the output file even if it's customized through the DSL. Also + fixed the DSL to get/set the output file on the variant object so that it's not necessary to + use variant.packageApplication or variant.zipAlign
        • +
      • Fixed dependency resolution so that we resolved the combination of (default config, + build types, flavor(s)) together instead of separately.
        • +
      • Fixed dependency for tests of library project to properly include all the dependencies + of the library itself.
        • +
      • Fixed case where two dependencies have the same leaf name.
        • +
      • Fixed issue where Proguard rules file cannot be applied on flavors.
        • +
      +

      All Gradle plugin release notes are available are here: http://tools.android.com/tech-docs/new-build-system.

      +
      • +
    • Gradle errors from aapt no longer point to merged output files in the build/ folder, they + point back to the real source locations.
      • +
    • Parallel Builds. It's now possible to use Gradle's parallel builds. Please be aware that + parallel builds are in "incubation" (see Gradle's + documentation.) This feature is off by default. To enable it, go to + Preferences > Compiler and check the box Compile + independent modules in parallel.
      • +
    • Further work on the new resource repository used for layout rendering, resource + folding in the editor, and more: +
        +
      • Basic support for .aar library dependencies (e.g. using a library without a local copy of + the sources). Still not working for resource XML validation and navigation in source editors. +
        • +
      • Cycle detection in resource references.
        • +
      • Quick Documentation (F1), which can show all translations of the string under the caret, + will now also show all resource overlays from the various Gradle flavors and build types, as + well as libraries. They are listed in reverse resource overlay order, with strikethrough on + the versions of the string that are masked.
        • +
      • Fixes to handle updating the merged resources when the set of module dependencies + change.
        • +
      • XML rendering fixes to properly handle character entity declarations and XML and unicode + escapes.
        • +
      +
    • Save screenshot support for the layout preview and layout editor windows.
      • +
    • Template bug fixes.
      • +
    • Lint bug fixes.
      • +
    • Various fixes for crash reports. Thank you, and keep filing crash reports!
      • +
    +
    +
    + +
    +

    + Android Studio v0.1.x (May 2013)

    @@ -408,13 +491,76 @@ Check for updates).

    +

     

    + +

    Note: Periodic updates are pushed to Android Studio +without requiring you to update from here. To manually check for updates, select +Help > Check for updates (on Mac, select Android Studio > +Check for updates).

    + + + + +

    Troubleshooting

    + + +
    + +

    Figure 1. Error dialog when opening an existing project.

    +
    + +

    Error: Gradle project refresh failed

    + +

    Android Studio 0.2.0 has updated the Gradle plug-in to 0.5.0, which is not backwards compatible. +When opening a project that uses an older version of the plug-in, Studio will display the error +shown in figure 1 in the upper right corner of the IDE. +To resolve the error, you must change the version of the Android Gradle plug-in to 0.5.0.

    + +
      +
    1. Click the link in the error dialog Search in build.gradle files. If the dialog +is no longer visible, click Event Log + in the bottom-right corner of the IDE, +then click Search in build.gradle files.
      2. +
    2. Double-click the line under the build.gradle usage. For example: + classpath 'com.android.tools.build:gradle:0.4. This opens the project + build.gradle file.
      3. +
    3. Edit the classpath to change the gradle version to 0.5.+. + For example: + 
      +dependencies {
+  classpath 'com.android.tools.build:gradle:0.5.+'
+}
+
      +
      4. +
    4. Save the file and rebuild your project.
      5. +
    +
    + +

    Figure 2. Error dialog when creating a new project +or opening a project using the support library.

    +
    +

    Error: Failed to import Gradle project

    +

    If, after updating to Android Studio 0.2.x and creating or opening a project, you receive an +error stating "Could not find any version that matches +com.android.support:support-v4:13.0.+", then you must install the Android Studio +Repository. This was likely caused because you're pointing Android Studio to an external +Android SDK location that does not have the new Maven repository included with Android Studio +0.2.x. This new Maven repository is used by the new build system for the Support Library, instead +of using the Support Library JAR files, so must be present in the SDK.

    +
      +
    1. Open the Android SDK Manager.
      2. +
    2. Expand the Extras directory +and install Android Studio Repository.
      3. +
    + @@ -430,7 +576,7 @@ Check for updates).

    - +