diff options
Diffstat (limited to 'docs')
-rw-r--r-- | docs/html/images/tools/studio_error_eventlog.png | bin | 0 -> 2259 bytes | |||
-rw-r--r-- | docs/html/images/tools/studio_error_gradle5.png | bin | 0 -> 48854 bytes | |||
-rw-r--r-- | docs/html/images/tools/studio_error_supportlib.png | bin | 0 -> 171678 bytes | |||
-rw-r--r-- | docs/html/sdk/installing/studio.jd | 188 |
4 files changed, 167 insertions, 21 deletions
diff --git a/docs/html/images/tools/studio_error_eventlog.png b/docs/html/images/tools/studio_error_eventlog.png Binary files differnew file mode 100644 index 0000000..909b285 --- /dev/null +++ b/docs/html/images/tools/studio_error_eventlog.png diff --git a/docs/html/images/tools/studio_error_gradle5.png b/docs/html/images/tools/studio_error_gradle5.png Binary files differnew file mode 100644 index 0000000..13de607 --- /dev/null +++ b/docs/html/images/tools/studio_error_gradle5.png diff --git a/docs/html/images/tools/studio_error_supportlib.png b/docs/html/images/tools/studio_error_supportlib.png Binary files differnew file mode 100644 index 0000000..603b54c --- /dev/null +++ b/docs/html/images/tools/studio_error_supportlib.png 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 <td>Windows</td> <td> <a onclick="return onDownload(this)" id="win-studio" - href="http://dl.google.com/android/studio/android-studio-bundle-130.687321-windows.exe"> - 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 </a> </td> - <td>393023485 bytes</td> - <td>3da987a9778b66edb68fb43d8b53bfcb</td> + <td>396091268 bytes</td> + <td>6da1bc8effa048c8ff669e4c484eb11f</td> </tr> <tr> <td><nobr>Mac OS X</nobr></td> <td> <a onclick="return onDownload(this)" id="mac-studio" - href="http://dl.google.com/android/studio/android-studio-bundle-130.687321-mac.dmg"> - 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 </a> </td> - <td>379877697 bytes</td> - <td>eb5ca6c77f4a119595d941daeda58810</td> + <td>383326582 bytes</td> + <td>2959bc5039238d286670cc6225342b89</td> </tr> <tr> <td>Linux</td> <td> <a onclick="return onDownload(this)" id="linux-studio" - href="http://dl.google.com/android/studio/android-studio-bundle-130.687321-linux.tgz"> - 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 </a> </td> - <td>406516375 bytes</td> - <td>6796d66de07c85b2822ca8d501a043c0</td> + <td>409935592 bytes</td> + <td>dcd13922f7cf577e3c852b224205d843</td> </tr> </table> @@ -286,6 +286,25 @@ download (or continue to use) the +<h2 id="Updating">Updating to 0.2.x</h2> + +<p>To update your existing version of Android Studio to 0.2.x, simply +follow the <a href="#Installing">installation instructions</a> below and replace your existing +installation.</p> + +<p class="caution"><strong>Caution:</strong> 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.</p> + +<p>Also note that due to the update to Gradle 0.5, you will encounter errors when opening +existing projects. See the <a href="#Troubleshooting">Troubleshooting</a> notes below for +information about how to resolve them.</p> + + <h2 id="Installing">Installing Android Studio</h2> <ol> <li>Download the <strong>Android Studio</strong> package from above.</li> @@ -390,14 +409,78 @@ style="vertical-align:bottom;margin:0;height:19px" /> in the toolbar.</p> <h2 id="Revisions">Revisions</h2> -<p class="note"><strong>Note:</strong> Periodic updates are pushed to Android Studio -without requiring you to update from here. To manually check for updates, select -<strong>Help > Check for updates</strong> (on Mac, select <strong>Android Studio > -Check for updates</strong>).</p> +<p class="note"><strong>Note:</strong> <strong>There is not a patch update available from +0.1.9 to 0.2</strong>. 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.</p> + <div class="toggle-content opened"> <p><a href="#" onclick="return toggleContent(this)"> <img src="{@docRoot}assets/images/triangle-opened.png" class="toggle-content-img" + alt=""/>Android Studio v0.2.x</a> <em>(July 2013)</em> + </p> + + <div class="toggle-content-toggleme"> + <ul> + <li>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.</li> + <li>Android Gradle plug-in updated to 0.5.0. + <p class="caution"><strong>Caution:</strong> 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 <strong>Gradle <project_name> project refresh failed.</strong> See <a + href="#Troubleshooting">Troubleshooting</a> below for details.</p> + <p>The updated Gradle plug-in includes the following changes:</p> + <ul> + <li>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 <code>variant.packageApplication or variant.zipAlign</code></li> + <li>Fixed dependency resolution so that we resolved the combination of (default config, + build types, flavor(s)) together instead of separately.</li> + <li>Fixed dependency for tests of library project to properly include all the dependencies + of the library itself.</li> + <li>Fixed case where two dependencies have the same leaf name.</li> + <li>Fixed issue where Proguard rules file cannot be applied on flavors.</li> + </ul> + <p>All Gradle plugin release notes are available are here: <a href= + "http://tools.android.com/tech-docs/new-build-system" + >http://tools.android.com/tech-docs/new-build-system</a>.</p> + </li> + <li>Gradle errors from aapt no longer point to merged output files in the build/ folder, they + point back to the real source locations.</li> + <li>Parallel Builds. It's now possible to use Gradle's parallel builds. Please be aware that + parallel builds are in "incubation" (see <a + href="http://www.gradle.org/docs/current/userguide/gradle_command_line.html">Gradle's + documentation</a>.) This feature is off by default. To enable it, go to + <strong>Preferences</strong> > <strong>Compiler</strong> and check the box <em>Compile + independent modules in parallel</em>.</li> + <li>Further work on the new resource repository used for layout rendering, resource + folding in the editor, and more: + <ul> + <li>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. + </li> + <li>Cycle detection in resource references.</li> + <li>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.</li> + <li>Fixes to handle updating the merged resources when the set of module dependencies + change.</li> + <li>XML rendering fixes to properly handle character entity declarations and XML and unicode + escapes.</li> + </ul> + <li>Save screenshot support for the layout preview and layout editor windows.</li> + <li>Template bug fixes.</li> + <li>Lint bug fixes.</li> + <li>Various fixes for crash reports. Thank you, and keep filing crash reports!</li> + </ul> + </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" alt=""/>Android Studio v0.1.x</a> <em>(May 2013)</em> </p> @@ -408,13 +491,76 @@ Check for updates</strong>).</p> </div> </div> +<p> </p> + +<p class="note"><strong>Note:</strong> Periodic updates are pushed to Android Studio +without requiring you to update from here. To manually check for updates, select +<strong>Help > Check for updates</strong> (on Mac, select <strong>Android Studio > +Check for updates</strong>).</p> + + + + +<h2 id="Troubleshooting">Troubleshooting</h2> + + +<div class="figure" style="width:330px"> +<img src="{@docRoot}images/tools/studio_error_gradle5.png" width="330"/> +<p class="img-caption"><strong>Figure 1.</strong> Error dialog when opening an existing project.</p> +</div> + +<h3>Error: Gradle project refresh failed</h3> + +<p>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.</p> + +<ol> + <li>Click the link in the error dialog <strong>Search in build.gradle files</strong>. If the dialog +is no longer visible, click <strong>Event Log</strong> +<img src="{@docRoot}images/tools/studio_error_eventlog.png" +style="vertical-align:bottom;margin:0;height:19px"/> in the bottom-right corner of the IDE, +then click <strong>Search in build.gradle files</strong>.</li> + <li>Double-click the line under the <em>build.gradle</em> usage. For example: + <strong>classpath 'com.android.tools.build:gradle:0.4</strong>. This opens the project + <code>build.gradle</code> file.</li> + <li>Edit the <code>classpath</code> to change the gradle version to <code>0.5.+</code>. + For example: + <pre class="no-pretty-print"> +dependencies { + classpath 'com.android.tools.build:gradle:<strong>0.5.+</strong>' +} +</pre> + </li> + <li>Save the file and rebuild your project.</li> +</ol> +<div class="figure" style="width:330px"> +<img src="{@docRoot}images/tools/studio_error_supportlib.png" width="330"/> +<p class="img-caption"><strong>Figure 2.</strong> Error dialog when creating a new project +or opening a project using the support library.</p> +</div> +<h3>Error: Failed to import Gradle project</h3> +<p>If, after updating to Android Studio 0.2.x and creating or opening a project, you receive an +error stating <em>"Could not find any version that matches +com.android.support:support-v4:13.0.+"</em>, then you must install the <strong>Android Studio +Repository</strong>. 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.</p> +<ol> + <li>Open the <strong>Android SDK Manager</strong>.</li> + <li>Expand the <strong>Extras</strong> directory +and install <strong>Android Studio Repository</strong>.</li> +</ol> + </div><!-- end main content --> @@ -430,7 +576,7 @@ Check for updates</strong>).</p> - + <script> var os; var bundlename; @@ -450,15 +596,15 @@ Check for updates</strong>).</p> if (os) { /* set up primary ACE download button */ $('#download-ide-button').show(); - $('#download-ide-button').append("Download Android Studio <span class='small'>v0.1.x</span>" + $('#download-ide-button').append("Download Android Studio <span class='small'>v0.2.x</span>" + "<br/><span class='small'>for " + os + "</span>"); $('#download-ide-button').click(function() {return onDownload(this,true);}).attr('href', bundlename); } else { $('.pax').show(); } - - + + function onDownload(link, button) { var $studioLink; @@ -470,7 +616,7 @@ Check for updates</strong>).</p> $studioLink = $(link); $("#downloadForRealz").html("Download " + $(link).text()); } - + $("#downloadForRealz").attr('href', $studioLink.attr('href')); $("#tos").fadeIn('fast'); |