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 0000000000000..909b2859caa7b 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 0000000000000..13de6079718fd 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 0000000000000..603b54cafa682 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 8825bccba19dd..eeb889639aea3 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
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.
+ +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)
+
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:
+variant.packageApplication or variant.zipAlignAll Gradle plugin release notes are available are here: http://tools.android.com/tech-docs/new-build-system.
+
+
Android Studio v0.1.x (May 2013)
+ +
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).
+
+Figure 1. Error dialog when opening an existing project.
+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.
+ +
in the bottom-right corner of the IDE,
+then click Search in build.gradle files.build.gradle file.classpath to change the gradle version to 0.5.+.
+ For example:
+
+dependencies {
+ classpath 'com.android.tools.build:gradle:0.5.+'
+}
+
+
+Figure 2. Error dialog when creating a new project +or opening a project using the support library.
+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.
+ + +