Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

changes to deprecate eclipse docs and update migration guide

Browse Source 
Change-Id: Icb3c0d93a968d5b1db829ff1db51ecdc47374803
This commit is contained in:
smain@google.com
2014-12-08 11:28:16 -08:00
parent 88b8b4a5d0
commit 6ae492e672
8 changed files with 39 additions and 163 deletions
Download Patch File Download Diff File Expand all files Collapse all files

41
docs/html/sdk/installing/index.jd
View File

@@ -272,47 +272,6 @@ Continue: Adding SDK Packages</a></p>
<!-- ################### ADT BUNDLE ####################### -->
<div id="adt" heading="Installing the Eclipse ADT Bundle" style="display:none">
<p>The Eclipse ADT Bundle provides everything you need to start developing apps, including
the Android SDK tools and a version of the Eclipse IDE with built-in ADT
(Android Developer Tools) to streamline your Android app development.</p>
<p>If you didn't download the Eclipse ADT bundle, go <a href="{@docRoot}tools/eclipse/index.html"
><b>download the Eclipse ADT bundle now</b></a>, or switch to the
<a href="{@docRoot}sdk/installing/index.html?pkg=studio">Android Studio
install</a> or <a href="{@docRoot}sdk/installing/index.html?pkg=tools">stand-alone SDK Tools
install</a> instructions</i>.</p>
<div class="procedure-box">
<p><b>To set up the ADT Bundle:</b></p>
<ol>
<li>Unpack the ZIP file
(named {@code adt-bundle-&lt;os_platform>.zip}) and save it to an appropriate location,
such as a "Development" directory in your home directory.</li>
<li>Open the {@code adt-bundle-&lt;os_platform>/eclipse/} directory and launch
<strong>Eclipse</strong>.</li>
</ol>
<p class="caution"><strong>Caution:</strong> Do not move any of the files or directories
from the {@code adt-bundle-&lt;os_platform>} directory. If you move the {@code eclipse/}
or {@code sdk/} directory, ADT will not be able to locate the SDK and you'll
need to manually update the ADT preferences.</p>
</div>
<p>Eclipse with ADT is now ready and loaded with the Android developer tools, but there are still
a couple packages you should add to make your Android SDK complete.</p>
<p class="paging-links">
<a href="{@docRoot}sdk/installing/adding-packages.html" class="next-page-link">
Continue: Adding SDK Packages</a></p>
</div>
<!-- ################ END ADT BUNDLE ##################### -->

15
docs/html/sdk/installing/installing-adt.jd
View File

@@ -15,12 +15,17 @@ 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.
</p>
<p class="note"><strong>Note:</strong> You should install the ADT plugin
only if you already have an Eclipse installation that you want to continue using. If you do not
have Eclipse installed, you should instead <b><a href="{@docRoot}sdk/index.html">install
the complete Android SDK</a></b>, which includes the latest IDE for Android developers.</p>
<p>Your existing Eclipse installation must meet these requirements:</p>
<p class="caution"><strong>Caution:</strong>
The ADT plugin for Eclipse is no longer in active development. If you're currently using it,
you should <a href="{@docRoot}sdk/installing/migrate.html">migrate
to Android Studio</a> as soon as possible. For more details about Android Studio, see the
<a href="{@docRoot}tools/studio/index.html">Android Studio</a> guide.</p>
<p>You should install the ADT plugin
only if you already have an Eclipse installation that you want to continue using.
Your existing Eclipse installation must meet these requirements:</p>
<ul>
<li><a href="http://eclipse.org/mobile/">Eclipse</a> 3.7.2 (Indigo) or greater
<p class="note"><strong>Note:</strong> Eclipse 3.6 (Helios) is no longer

34
docs/html/sdk/installing/migrate.jd
View File

@@ -6,7 +6,8 @@ page.title=Migrating to Android Studio
<div id="qv">
<h2>See also</h2>
<ul>
<li><a href="http://confluence.jetbrains.com/display/IntelliJIDEA/FAQ+on+Migrating+to+IntelliJ+IDEA">IntelliJ FAQ on migrating to IntelliJ IDEA</a></li>
<li><a href="http://confluence.jetbrains.com/display/IntelliJIDEA/FAQ+on+Migrating+to+IntelliJ+IDEA"
class="external-link">IntelliJ FAQ on migrating to IntelliJ IDEA</a></li>
<li><a href="http://confluence.jetbrains.com/display/IntelliJIDEA/Working+in+Eclipse+Compatibility+Mode" class="external-link"
>Eclipse Compatibility Mode</a></li>
<li><a href="http://confluence.jetbrains.com/display/IntelliJIDEA/FAQ+on+Migrating+to+IntelliJ+IDEA" class="external-link"
@@ -17,23 +18,11 @@ page.title=Migrating to Android Studio
<p>If you're currently using Eclipse with ADT, we recommend you migrate to
<a href="{@docRoot}tools/studio/index.html">Android Studio</a> as soon as possible, because
the ADT plugin for Eclipse is no longer in active development.</p>
the <a href="{@docRoot}tools/help/adt.html">ADT plugin</a>
for Eclipse is no longer in active development.</p>
<p>To migrate existing Android projects from Eclipse,
you should export your projects from Eclipse in order to generate
Gradle build files:</p>
<ol>
<li>In Eclipse, select <strong>File &gt; Export</strong>.</li>
<li>Select <strong>Generate Gradle build files</strong> inside the Android folder, then click
<strong>Next</strong>.</li>
<li>Click <strong>Browse</strong> to find your project to export.</li>
<li>Select your project from the list, click <strong>OK</strong>, then <strong>Finish</strong>.</li>
</ol>
<p>You can then import the project into Android Studio:</p>
<p>To migrate existing Android projects, simply import them using Android Studio:</p>
<ol>
<li>In Android Studio, close any projects currently open. You should see the
@@ -45,11 +34,10 @@ Gradle build files:</p>
<strong>OK</strong>. (You do not need to specify the Gradle home.)</li>
</ol>
<p>It's possible to import an existing Android project to Android Studio even if you
don't generate a Gradle build file from Eclipse&mdash;Android Studio will successfully build and
run projects using an existing Ant build file. However, in order to take advantage of build
variants and other advanced features in the future,
you should generate a Gradle build file using
the ADT plugin or write your own Gradle build file for use with Android Studio.</p>
<p>Android Studio properly updates the project structure and creates the appropriate
Gradle build file.</p>
<p><a href="{@docRoot}tools/studio/index.html">Learn more about Android Studio</a>.</p>
<p>For more help getting started with Android Studio and the IntelliJ user experience,
<a href="{@docRoot}tools/studio/index.html">learn more about Android Studio</a> and
read <a href="http://confluence.jetbrains.com/display/IntelliJIDEA/FAQ+on+Migrating+to+IntelliJ+IDEA"
class="external-link">FAQ on Migrating to IntelliJ IDEA</a>.</p>

2
docs/html/sdk/installing/studio-build.jd
View File

@@ -13,7 +13,7 @@ page.title=Build System Overview
<li><a href="{@docRoot}sdk/installing/studio.html">
Getting Started with Android Studio</a></li>
<li><a href="{@docRoot}tools/studio/index.html">Android Studio Basics</a></li>
<li><a href="{@docRoot}tools/eclipse/migrate-adt.html">Migrating from Eclipse</a></li>
<li><a href="{@docRoot}sdk/installing/migrate.html">Migrating from Eclipse</a></li>
</div>
</div>

37
docs/html/tools/eclipse/index.jd
View File

@@ -1,37 +0,0 @@
page.title=Eclipse ADT
@jd:body
<div id="qv-wrapper">
<div id="qv">
<h2>See also</h2>
<ol>
<li><a href="{@docRoot}tools/sdk/index.html">Downloading Android Studio</a></li>
<li><a href="{@docRoot}tools/studio/index.html">Android Studio</a></li>
<li><a href="{@docRoot}tools/eclipse/migrate-adt.html">Migrating to Android Studio</a></li>
</ol>
</div>
</div>
<p>The Android Developer Tools (ADT) plugin for Eclipse provides a professional-grade development
environment for building Android apps. It's a full Java IDE with advanced features to help you build,
test, debug, and package your Android apps. </p>
<p>Android developers are encouraged to <a href="{@docRoot}tools/eclipse/migrate-adt.html">migrate
to Android Studio</a> as the Eclipse ADT is no longer in active development.
</p>
<p>The Android Studio build system replaces the Apache Ant build software used with Eclipse ADT
with an Android plugin for <em>Gradle</em>. <a href="http://www.gradle.org/">Gradle</a> is an
advanced build toolkit that manages dependencies and allows you to define custom build logic. Android
Studio also adds support for Maven-based build dependencies, build variants, advanced code
completion and refactoring. For more details about Android Studio, see the
<a href="{@docRoot}tools/studio/index.html">Android Studio</a> guide.
<p>If you still wish to get started with the ADT plugin,
<a href="{@docRoot}tools/eclipse/installing-adt.html">download and install the Eclipse ADT plugin.</a>
</p>
</div>
</div>

57
docs/html/tools/help/adt.jd
View File

@@ -24,63 +24,29 @@ page.tags=adt
</li>
<li><a href="#refactoring">Layout Factoring Support</a></li>
<li><a href="#Updating">Updating the ADT Plugin</h2>
<li><a href="#Updating">Updating the ADT Plugin</a></li>
</ol>
<h2>Related videos</h2>
<ol>
<li><a href="{@docRoot}videos/index.html#v=Oq05KqjXTvs">Android Developer Tools
Google I/O Session</a>
</li>
</ol>
<h2>See also</h2>
<ol>
<li><a href="http://tools.android.com/recent">Android Tools change blog</a></li>
</ol>
</div>
</div>
<p>ADT (Android Developer Tools) is a plugin for Eclipse that provides a suite of
tools that are integrated with the Eclipse IDE. It offers you access to many features that help
you develop Android applications quickly. ADT
you develop Android applications. ADT
provides GUI access to many of the command line SDK tools as well as a UI design tool for rapid
prototyping, designing, and building of your application's user interface.</p>
<p>Because ADT is a plugin for Eclipse, you get the functionality of a well-established IDE,
along with Android-specific features that are bundled with ADT. The following
describes important features of Eclipse and ADT:</p>
<dl>
<dt><strong>Integrated Android project creation, building, packaging, installation, and
debugging</strong></dt>
<p class="caution"><strong>Caution:</strong>
The ADT plugin for Eclipse is no longer in active development. If you're currently using it,
you should <a href="{@docRoot}sdk/installing/migrate.html">migrate
to Android Studio</a> as soon as possible. For more details about Android Studio, see the
<a href="{@docRoot}tools/studio/index.html">Android Studio</a> guide.</p>
<dd>ADT integrates many development workflow tasks into Eclipse, making it easy for you to
rapidly develop and test your Android applications.</dd>
<p>If you still wish to use the ADT plugin for Eclipse, see
<a href="{@docRoot}sdk/installing/installing-adt.html">Installing Eclipse Plugin.</a>
</p>
<dt><strong>SDK Tools integration</strong></dt>
<dd>Many of the <a href="#tools">SDK tools</a> are integrated into Eclipse's menus,
perspectives, or as a part of background processes ran by ADT.</dd>
<dt><strong>Java programming language and XML editors</strong></dt>
<dd>The Java programming language editor contains common IDE features such as compile time
syntax checking, auto-completion, and integrated documentation for the Android framework APIs.
ADT also provides custom XML editors that let you
edit Android-specific XML files in a form-based UI. A graphical layout editor lets you design
user interfaces with a drag and drop interface.</dd>
<dt><strong>Integrated documentation for Android framework APIs</strong></dt>
<dd>You can access documentation by hovering over classes, methods, or variables.</dd>
</dl>
<p>You can find the most up-to-date and more detailed information about changes and new features
on the <a href="http://tools.android.com/recent">Recent Changes</a> page at the Android Tools
Project site.</p>
<h2 id="tools">SDK Tools Integration</h2>
@@ -568,5 +534,6 @@ to install it. </p>
<p>If you encounter problems during the update, remove the existing ADT plugin from Eclipse, then
perform a fresh installation, using the instructions for <a href="#installing">Installing the ADT
perform a fresh installation, using the instructions for <a
href="{@docRoot}sdk/installing/installing-adt.html">Installing the ADT
Plugin</a>.</p>

5
docs/html/tools/studio/index.jd
View File

@@ -102,9 +102,8 @@ the <strong>Project</strong drop-down. </p>
<h3>New Project and Directory Structure</h3>
<p>When you use the <em>Project</em> view of a new project in Android Studio or
(<a href="{@docRoot}tools/eclipse/migrate-adt.html"> a project migrated from Eclipse</a>), you
should notice that the project structure appears different than you may be used to. Each
<p>When you use the <em>Project</em> view of a new project in Android Studio, you
should notice that the project structure appears different than you may be used to in Eclipse. Each
instance of Android Studio contains a project with one or more application modules. Each
application module folder contains the complete source sets for that module, including
{@code src/main} and {@code src/androidTest} directories, resources, build

11
docs/html/tools/tools_toc.cs
View File

@@ -159,13 +159,6 @@ class="en">Support Library</span></a></div>
class="en">Tools Help</span></a></div>
<ul>
<li><a href="<?cs var:toroot ?>tools/help/adb.html">adb</a></li>
<li class="nav-section">
<div class="nav-section-header"><a href="<?cs var:toroot ?>tools/help/adt.html">ADT</a></div>
<ul>
<li><a href="<?cs var:toroot ?>sdk/installing/installing-adt.html">
<span class="en">Installing the Eclipse Plugin</span></a></li>
</ul>
</li>
<li><a href="<?cs var:toroot ?>tools/help/android.html">android</a></li>
<li><a href="<?cs var:toroot ?>tools/help/avd-manager.html">AVD Manager</a></li>
<li><a href="<?cs var:toroot ?>tools/help/bmgr.html">bmgr</a>
@@ -293,11 +286,13 @@ class="en">Support Library</span></a></div>
<li class="nav-section">
<div class="nav-section-header">
<a href="<?cs var:toroot ?>tools/eclipse/index.html">
<a href="<?cs var:toroot ?>tools/help/adt.html">
<span class="en">Eclipse with ADT</span></a>
</div>
<ul>
<li><a href="<?cs var:toroot ?>sdk/installing/migrate.html">Migrating to Android Studio</a></li>
<li><a href="<?cs var:toroot ?>sdk/installing/installing-adt.html">
<span class="en">Installing the Eclipse Plugin</span></a></li>
<li><a href="<?cs var:toroot ?>tools/projects/projects-eclipse.html">Managing Projects</a></li>
<li><a href="<?cs var:toroot ?>tools/building/building-eclipse.html">Building and Running</a></li>
<li><a href="<?cs var:toroot ?>tools/building/building-cmdline-ant.html">Building with Ant</a></li>