diff options
Diffstat (limited to 'docs/html/tools')
| -rw-r--r-- | docs/html/tools/devices/emulator.jd | 2 | ||||
| -rw-r--r-- | docs/html/tools/revisions/gradle-plugin.jd | 153 | ||||
| -rw-r--r-- | docs/html/tools/revisions/studio.jd | 29 | ||||
| -rw-r--r-- | docs/html/tools/studio/index.jd | 115 | ||||
| -rw-r--r-- | docs/html/tools/support-library/features.jd | 32 | ||||
| -rw-r--r-- | docs/html/tools/tools_toc.cs | 3 |
6 files changed, 310 insertions, 24 deletions
diff --git a/docs/html/tools/devices/emulator.jd b/docs/html/tools/devices/emulator.jd index 42240b9..5bdd4e2 100644 --- a/docs/html/tools/devices/emulator.jd +++ b/docs/html/tools/devices/emulator.jd @@ -122,7 +122,7 @@ machine.</p> mobile devices, including: </p> <ul> - <li>An ARMv5 CPU and the corresponding memory-management unit (MMU)</li> + <li>An ARMv5, ARMv7, or x86 CPU</li> <li>A 16-bit LCD display</li> <li>One or more keyboards (a Qwerty-based keyboard and associated Dpad/Phone buttons)</li> diff --git a/docs/html/tools/revisions/gradle-plugin.jd b/docs/html/tools/revisions/gradle-plugin.jd new file mode 100644 index 0000000..23170e1 --- /dev/null +++ b/docs/html/tools/revisions/gradle-plugin.jd @@ -0,0 +1,153 @@ +page.title=Android Plugin for Gradle Release Notes + +@jd:body + +<div id="qv-wrapper"> +<div id="qv"> + + <h2>See also</h2> + <ol> + <li><a href="{@docRoot}sdk/installing/studio-build.html">Build System Overview</a></li> + <li><a href="{@docRoot}tools/building/plugin-for-gradle.html">Android Plugin for Gradle</a></li> + </ol> + +</div> +</div> + + +<p>The Android build system uses the Android Plugin for Gradle to support building Android +applications with the <a href="http://www.gradle.org/">Gradle</a> build toolkit. The plugin runs +independent of Android Studio so the plugin and the Gradle build system can be updated +independently of Android Studio.</p> + +<p class="note"><strong>Note:</strong> When you update Android Studio or open a project in a +previous version of Android Studio, Android Studio prompts you to automatically update the plugin +and Gradle to the latest available versions. You can choose to accept these updates based +on your project's build requirements. </p> + + +<h2 id="revisions">Revisions</h2> + +<p>The sections below provide notes about successive releases of +the Android Plugin for Gradle, as denoted by revision number. To determine what revision of the +plugin you are using, check the version declaration in the project-level +<strong>build.gradle</strong> file. </p> + +<p>For a summary of known issues in Android Plugin for Gradle, see <a +href="http://tools.android.com/knownissues">http://tools.android.com/knownissues</a>.</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 Plugin for Gradle, Revision 1.1</a> <em>(February 2015)</em> + </p> + + <div class="toggle-content-toggleme"> + + <dl> + <dt>Dependencies:</dt> + + <dd> + <ul> + <li>Gradle 2.2.1 or higher.</li> + <li>Build Tools 21.1.1 or higher.</li> + </ul> + </dd> + + <dt>General Notes:</dt> + <dd> + <ul> + <li>Fixed issue with Gradle build failure when accessing the + <code>extractReleaseAnnotations</code> module. + (<a href="http://b.android.com/81638">Issue 81638</a>).</li> + <li>Fixed debugging issue when displaying method input parameters at breakpoints. + (<a href="http://b.android.com/82031">Issue 82031</a>).</li> + <li>Fixed manifest merger issues when importing libraries with a <code>targetSdkVersion</code> + less than 16.</li> + <li>Fixed density ordering issue when using Android Studio with JDK 8.</li> + </ul> + </dd> + </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 Plugin for Gradle, Revision 1.0</a> <em>(December 2014)</em> + </p> + + <div class="toggle-content-toggleme"> + + <dl> + <dt>Dependencies:</dt> + + <dd> + <ul> + <li>Gradle 2.2.1 or higher.</li> + <li>Build Tools 21.1.1 or higher.</li> + </ul> + </dd> + + <dt>General Notes:</dt> + <dd> + <ul> + <li>Initial plugin release.</li> + </ul> + </dd> + </div> +</div> + + + + +<h2>Updating the Android Plugin for Gradle Version</h2> +<p>The Android Plugin for Gradle version is specified in the +<strong>File > Project Structure</strong> menu or the project-level +<code>build.gradle</code> file. The plugin version applies to all modules built in that +Android Studio project. This example updates the Android Plugin for Gradle to version 1.1: +<pre> +... + dependencies { + classpath 'com.android.tools.build:gradle:1.1' + } +... +</pre> + + +<p class="caution"><strong>Caution:</strong> You should not use dynamic dependencies (+) in +version numbers. Using this feature can cause unexpected version updates and difficulty +resolving version differences. +</p> + +<p>If you're building with Gradle but using not Android Studio, the build process downloads the +latest Android Plugin for Gradle plugin when it runs. </p> + + + +<h2>Updating the Gradle Version </h2> + +<p>Android Studio requires Gradle version 2.2.1 or later. To view and +update the Gradle version, edit the Gradle distribution reference in the +<code>gradle/wrapper/gradle-wrapper.properties</code> file. This example shows the +Android Plugin for Gradle version set to 2.2.1.</p> + +<pre> +... +distributionUrl=http\://services.gradle.org/distributions/gradle-2.2.1-all.zip +... +</pre> + + + + +<p>For more details about the supported Android Plugin for Gradle properties and syntax, click +the link to the +<a href="{@docRoot}tools/building/plugin-for-gradle.html">Plugin Language Reference</a>.</p> + + + + + diff --git a/docs/html/tools/revisions/studio.jd b/docs/html/tools/revisions/studio.jd index 3806933..af25d9c 100644 --- a/docs/html/tools/revisions/studio.jd +++ b/docs/html/tools/revisions/studio.jd @@ -29,7 +29,7 @@ everything you need to begin developing Android apps:</p> <p>For an introduction to Android Studio, read the <a href="{@docRoot}tools/studio/index.html">Android Studio</a> guide.</p> -<p>Periodic updates are pushed to Android Studio without requiring you to update from here. To +<p>Periodic updates are pushed to Android Studio without requiring you to update. To manually check for updates, select <strong>Help > Check for updates</strong> (on Mac, select <strong>Android Studio > Check for updates</strong>).</p> @@ -43,6 +43,33 @@ Android Studio, as denoted by revision number. </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 v1.1</a> <em>(February 2015)</em> + </p> + + <div class="toggle-content-toggleme"> + <p>Various fixes and enhancements:</p> + <ul> + <li>Added support for the <a href="{@docRoot}design/wear/index.html">Android Wear</a> watch + template. </li> + <li>Modified new project and module creation to include + <a href="{@docRoot}tools/projects/index.html#mipmap"><code>res/mipmap</code></a> folders for + density-specific launcher icons. These <code>res/mipmap</code> folders replace the + <a href="{@docRoot}guide/topics/resources/drawable-resource.html"><code>res/drawable</code></a> + folders for launcher icons. </li> + <li>Updated launcher icons to have a + <a href="{@docRoot}design/material/index.html">Material Design</a> look and added an + <code>xxxhdpi</code> launcher icon. </li> + <li>Added and enhanced <a href="{@docRoot}tools/help/lint.html"><code>lint</code></a> checks + for region and language combinations, launcher icons, resource names, and other common + code problems.</li> + <li>Added support for Best Current Practice (BCP) language tag 47. </li> + </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 v1.0.1</a> <em>(December 2014)</em> </p> diff --git a/docs/html/tools/studio/index.jd b/docs/html/tools/studio/index.jd index 993b3fe..11c1c74 100644 --- a/docs/html/tools/studio/index.jd +++ b/docs/html/tools/studio/index.jd @@ -10,6 +10,7 @@ page.title=Android Studio Overview <li><a href="#build-system">Android Build System</a></li> <li><a href="#debug-perf">Debug and Performance</a></li> <li><a href="#install-updates">Installation, Setup, and Update Management</a></li> + <li><a href="#proxy">HTTP Proxy Settings</a></li> <li><a href="#other">Other Highlights</a></li> @@ -379,6 +380,120 @@ code-level preference: +<h2 id="proxy">Proxy Settings</h2> +<p>Proxies serve as intermediary connection points between HTTP clients and web servers that add +security and privacy to internet connections.</p> + +<p>To support running Android Studio behind a firewall, set the proxy settings for the +Android Studio IDE and the SDK Manager. Use the Android Studio IDE HTTP Proxy settings page to set +the HTTP proxy settings for Android Studio. The SDK Manager has a separate HTTP Proxy settings +page.</p> + +<p>When running the Android Plugin for Gradle from the command line or on machines where +Android Studio is not installed, such as continuous integration servers, set the proxy settings +in the Gradle build file.</p> + +<p class="note"><strong>Note:</strong> After the initial installation of the Android Studio bundle, +Android Studio can run with internet access or off-line. However, Android Studio requires an +internet connection for Setup Wizard synchronization, 3rd-party library access, access to remote +repositories, Gradle initialization and synchronization, and Android Studio version updates.</p> + + +<h3>Setting up the Android Studio Proxy</h3> +<p>Android Studio supports HTTP proxy settings so you can run Android Studio behind a firewall or +secure network. To set the HTTP proxy settings in Android Studio:</p> +<ol> + <li>From the main menu choose <strong>File > Settings > IDE Setting -- HTTP Proxy</strong>. + +<li>In Android Studio, open the IDE Settings dialog. + <ul> + <li>On Windows and Linux, choose + <strong>File > Settings > IDE Setting -- HTTP Proxy</strong>. </li> + <li>On Mac, choose + <strong>Android Studio > Preferences > IDE Setting -- HTTP Proxy</strong>. </li> + </ul> + The HTTP Proxy page appears.</li> + <li>Select <strong>auto-detection</strong> to use an auto-configuration URL to configure the + proxy settings or <strong>manual</strong> to enter each of the settings. For a detailed explanation + of these settings, see + <a href="https://www.jetbrains.com/idea/help/http-proxy.html">HTTP Proxy</a>. </li> + <li>Click <strong>Apply</strong> to enable the proxy settings. </li> +</ol> + +<h3>Android Plugin for Gradle HTTP proxy settings</h3> +When running the Android Plugin from the command line or on machines where Android Studio is not +installed, set the Android Plugin for Gradle proxy settings in the Gradle build file.</p> + +<p>For application-specific HTTP proxy settings, set the proxy settings in the +<strong>build.gradle</strong> file as required for each application module.</p> +<pre> +apply plugin: 'com.android.application' + +android { + ... + + defaultConfig { + ... + systemProp.http.proxyHost=proxy.company.com + systemProp.http.proxyPort=443 + systemProp.http.proxyUser=userid + systemProp.http.proxyPassword=password + systemProp.http.auth.ntlm.domain=domain + } + ... +} +</pre> + + + +<p>For project-wide HTTP proxy settings, set the proxy settings in the +<code>gradle/gradle.properties</code> file. </p> + +<pre> +# Project-wide Gradle settings. +... + +systemProp.http.proxyHost=proxy.company.com +systemProp.http.proxyPort=443 +systemProp.http.proxyUser=username +systemProp.http.proxyPassword=password +systemProp.http.auth.ntlm.domain=domain + +systemProp.https.proxyHost=proxy.company.com +systemProp.https.proxyPort=443 +systemProp.https.proxyUser=username +systemProp.https.proxyPassword=password +systemProp.https.auth.ntlm.domain=domain + +... +</pre> + + +<p>For information about using Gradle properties for proxy settings, see the + <a href="http://www.gradle.org/docs/current/userguide/build_environment.html">Gradle User Guide</a>.</p> + +<p class="note"><strong>Note:</strong> When using Android Studio, the settings in the Android +Studio IDE HTTP proxy settings page override the HTTP proxy settings in the +<strong>gradle.properties</strong> file.</p> + + + +<h3>SDK Manager HTTP Proxy Settings </h3> +<p>SDK Manager proxy settings enable proxy internet access for Android package and library +updates from SDK Manager packages. </p> + +<p>To set the SDK Manager settings for proxy internet access, start the SDK Manager and open the +SDK Manager page. </p> + +<ul> + <li>On Windows, select <strong>Tools > Options</strong> from the menu bar. </li> + <li>On Mac and Linux, choose <strong>Tools > Options</strong> from the system menu bar. </li> + </ul> + +<p>The Android SDK Manager page appears. Enter the settings and click <strong>Apply</strong>. </p> + + + <h2 id="other">Other Highlights</h2> <h3> Translation Editor</h3> diff --git a/docs/html/tools/support-library/features.jd b/docs/html/tools/support-library/features.jd index 079dd71..0f0a0c0 100644 --- a/docs/html/tools/support-library/features.jd +++ b/docs/html/tools/support-library/features.jd @@ -143,10 +143,9 @@ numbers, can cause unexpected version updates and regression incompatibilities.< <p>The Gradle build script dependency identifier for this library is as follows:</p> <pre> -com.android.support:support-v4:21.0.+ +com.android.support:support-v4:21.0.0 </pre> -<p>This dependency notation specifies the latest release version with the 21.0 prefix.</p> <h2 id="multidex">Multidex Support Library</h2> @@ -171,10 +170,9 @@ com.android.support:support-v4:21.0.+ </p> <pre> -com.android.support:multidex:1.0.+ +com.android.support:multidex:1.0.0 </pre> -<p>This dependency notation specifies the latest release version with the 1.0 prefix.</p> <h2 id="v7">v7 Support Libraries</h2> @@ -226,10 +224,9 @@ com.android.support:multidex:1.0.+ <p>The Gradle build script dependency identifier for this library is as follows:</p> <pre> -com.android.support:appcompat-v7:21.0.+ +com.android.support:appcompat-v7:21.0.0 </pre> -<p>This dependency notation specifies the latest release version with the 21.0 prefix.</p> <h3 id="v7-cardview">v7 cardview library</h3> @@ -249,10 +246,9 @@ libraries with resources</a>.</p> <p>The Gradle build script dependency identifier for this library is as follows:</p> <pre> -com.android.support:cardview-v7:21.0.+ +com.android.support:cardview-v7:21.0.0 </pre> -<p>This dependency notation specifies the latest release version with the 21.0 prefix.</p> <h3 id="v7-gridlayout">v7 gridlayout library</h3> @@ -271,10 +267,9 @@ com.android.support:cardview-v7:21.0.+ <p>The Gradle build script dependency identifier for this library is as follows:</p> <pre> -com.android.support:gridlayout-v7:21.0.+ +com.android.support:gridlayout-v7:21.0.0 </pre> -<p>This dependency notation specifies the latest release version with the 21.0 prefix.</p> <h3 id="v7-mediarouter">v7 mediarouter library</h3> @@ -308,7 +303,7 @@ script dependency identifier <code>com.android.support:support-v7-mediarouter:&l where "<revision>" is the minimum revision at which the library is available. For example:</p> <pre> -com.android.support:mediarouter-v7:21.0.+ +com.android.support:mediarouter-v7:21.0.0 </pre> <p class="caution">The v7 mediarouter library APIs introduced in Support Library @@ -335,11 +330,9 @@ title card.</p> <p>The Gradle build script dependency identifier for this library is as follows:</p> <pre> -com.android.support:palette-v7:21.0.+ +com.android.support:palette-v7:21.0.0 </pre> -<p>This dependency notation specifies the latest release version with the 21.0 prefix.</p> - <h3 id="v7-recyclerview">v7 recyclerview library</h3> @@ -360,11 +353,9 @@ libraries with resources</a>.</p> <p>The Gradle build script dependency identifier for this library is as follows:</p> <pre> -com.android.support:recyclerview-v7:21.0.+ +com.android.support:recyclerview-v7:21.0.0 </pre> -<p>This dependency notation specifies the latest release version with the 21.0 prefix.</p> - <h2 id="v8">v8 Support Library</h2> @@ -405,11 +396,9 @@ com.android.support:recyclerview-v7:21.0.+ <p>The Gradle build script dependency identifier for this library is as follows:</p> <pre> -com.android.support:support-v13:18.0.+ +com.android.support:support-v13:18.0.0 </pre> -<p>This dependency notation specifies the latest release version with the 18.0 prefix.</p> - <h2 id="v17-leanback">v17 Leanback Library</h2> @@ -448,9 +437,8 @@ with resources</a>. </p> <p>The Gradle build script dependency identifier for this library is as follows:</p> <pre> -com.android.support:leanback-v17:21.0.+ +com.android.support:leanback-v17:21.0.0 </pre> -<p>This dependency notation specifies the latest release version with the 21.0 prefix.</p> diff --git a/docs/html/tools/tools_toc.cs b/docs/html/tools/tools_toc.cs index ab6c739..62c21a6 100644 --- a/docs/html/tools/tools_toc.cs +++ b/docs/html/tools/tools_toc.cs @@ -249,6 +249,9 @@ class="en">Support Library</span></a></div> <li><a href="<?cs var:toroot ?>tools/revisions/build-tools.html"> <span class="en">SDK Build Tools</span> </a></li> + <li><a href="<?cs var:toroot ?>tools/revisions/gradle-plugin.html"> + <span class="en">Android Plugin for Gradle</span> + </a></li> <li><a href="<?cs var:toroot ?>tools/revisions/platforms.html"> <span class="en">SDK Platforms</span></a></li> <li><a href="<?cs var:toroot ?>tools/sdk/eclipse-adt.html"> |