From 441e8b9f95efd289c589d8f9855ecbce7a26081e Mon Sep 17 00:00:00 2001 From: Scott Main Date: Fri, 19 Apr 2013 17:42:08 -0700 Subject: add docs for new IDE installing guide, migration guide, tips docs, and download page Change-Id: Ia884c95a20de28863a80ba1e985841a44e5e453c --- docs/html/images/tools/android-studio.png | Bin 0 -> 120146 bytes docs/html/images/tools/avd-manager-studio.png | Bin 0 -> 1845 bytes docs/html/images/tools/monitor-studio.png | Bin 0 -> 1748 bytes docs/html/images/tools/project-layout.png | Bin 0 -> 47374 bytes docs/html/images/tools/sdk-manager-studio.png | Bin 0 -> 1743 bytes docs/html/sdk/index.jd | 20 +- docs/html/sdk/installing/migrate.jd | 51 +++ docs/html/sdk/installing/studio-tips.jd | 213 ++++++++++++ docs/html/sdk/installing/studio.jd | 471 ++++++++++++++++++++++++++ docs/html/tools/tools_toc.cs | 13 + 10 files changed, 766 insertions(+), 2 deletions(-) create mode 100644 docs/html/images/tools/android-studio.png create mode 100644 docs/html/images/tools/avd-manager-studio.png create mode 100644 docs/html/images/tools/monitor-studio.png create mode 100644 docs/html/images/tools/project-layout.png create mode 100644 docs/html/images/tools/sdk-manager-studio.png create mode 100644 docs/html/sdk/installing/migrate.jd create mode 100644 docs/html/sdk/installing/studio-tips.jd create mode 100644 docs/html/sdk/installing/studio.jd diff --git a/docs/html/images/tools/android-studio.png b/docs/html/images/tools/android-studio.png new file mode 100644 index 0000000..4d93a86 Binary files /dev/null and b/docs/html/images/tools/android-studio.png differ diff --git a/docs/html/images/tools/avd-manager-studio.png b/docs/html/images/tools/avd-manager-studio.png new file mode 100644 index 0000000..15c09f8 Binary files /dev/null and b/docs/html/images/tools/avd-manager-studio.png differ diff --git a/docs/html/images/tools/monitor-studio.png b/docs/html/images/tools/monitor-studio.png new file mode 100644 index 0000000..2d1363f Binary files /dev/null and b/docs/html/images/tools/monitor-studio.png differ diff --git a/docs/html/images/tools/project-layout.png b/docs/html/images/tools/project-layout.png new file mode 100644 index 0000000..880c233 Binary files /dev/null and b/docs/html/images/tools/project-layout.png differ diff --git a/docs/html/images/tools/sdk-manager-studio.png b/docs/html/images/tools/sdk-manager-studio.png new file mode 100644 index 0000000..f99c471 Binary files /dev/null and b/docs/html/images/tools/sdk-manager-studio.png differ diff --git a/docs/html/sdk/index.jd b/docs/html/sdk/index.jd index 45c9e81..2ffc886 100644 --- a/docs/html/sdk/index.jd +++ b/docs/html/sdk/index.jd @@ -271,7 +271,7 @@ To get the ADT Bundle or stand-alone SDK Tools, please visit the web site at developer.android.com/sdk/

- + @@ -284,6 +284,9 @@ href="http://developer.android.com/sdk/index.html">developer.android.com/sdk/ + + +

Choose the SDK package for your OS from the table below.

@@ -295,12 +298,25 @@ href="" style="display:none;width:265px;margin:0 auto;display:block" > +
+ + +
+

Android Studio Early Access Preview

+ +

A new Android development environment called Android Studio, +based on IntelliJ IDEA, is now available as an early access preview. +For more information, see +Getting Started with Android Studio.

+ +
+

If you prefer to use an existing version of Eclipse or another IDE, you can instead take a more customized approach to installing -the Android SDK. See the following instructions.

+the Android SDK. See the following instructions:

  1. Update your Eclipse ADT Plugin + (you must have version 22.0 or higher).
    2. +
  2. In Eclipse, select File > Export.
    3. +
  3. In the window that appears, open Android and select Generate Gradle +build files.
    4. +
  4. Select the projects you want to export for Android Studio and click +Finish.
    5. +
+ +

Your selected projects remain in the same location but now contain a {@code .gradle} +build file and are ready for Android Studio.

+ + +

Import into Android Studio

+
    +
  1. In Android Studio, select File > Import Project.
    2. +
  2. Locate a project you exported from Eclipse, select the project's root directory and + click OK.
    3. +
  3. Select Create project from existing sources and click + Next.
    4. +
  4. Follow the walk-through to complete the import process.
    5. +
+ + +

Now that your projects are imported to Android Studio, +read Tips and Tricks for some +help getting started.

+ + +

Note: +It's possible to import an existing Android project to Android Studio even if you +don't generate a Gradle build file from Eclipse—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, +we strongly suggest that you generate a Gradle build file using +the ADT plugin or write your own Gradle build file for use with Android Studio. +For more information about the Gradle build system, see the +Gradle +Plugin User Guide.

diff --git a/docs/html/sdk/installing/studio-tips.jd b/docs/html/sdk/installing/studio-tips.jd new file mode 100644 index 0000000..259087b --- /dev/null +++ b/docs/html/sdk/installing/studio-tips.jd @@ -0,0 +1,213 @@ +page.title=Android Studio Tips and Tricks + +@jd:body + + +

If you're unfamiliar with the IntelliJ IDEA interface, you might be wondering +how to accomplish some common tasks in Android Studio. This page provides some tips +to help you get going.

+ +

For complete user documentation for the IntelliJ IDEA interface +(upon which Android Studio is based), refer to the +IntelliJ IDEA documentation.

+ +
+ +

Figure 1. Gradle project structure

+
+ +

Project Structure

+ +

When you create a new project in Android Studio (or +migrate a project from Eclipse), +you'll notice that the project structure appears differently than you may be used to. +As shown in figure 1, almost all your project files are now inside the {@code src/} directory, +including resources and the manifest file.

+ +

The new project structure is due to the switch to a Gradle-based build system. This structure +provides more flexibility to the build process and will allow multiple build variants (a feature not +yet fully implemented). Everything still behaves as you expect, but some of the files have moved +around. For the most part, you should need to modify only the files under the {@code src/} +directory. More information about the Gradle project structure is available in the +Gradle +Plugin User Guide.

+ + + +

Basic Operations

+ +

The following topics describe how to perform +some basic development tasks with Android Studio.

+ +

Creating virtual devices

+ +

All the capabilities of the Android +Virtual Device Manager are accessible directly from +the Android Studio interface. Click the Android Virtual Device Manager + in the toolbar to open it and create +new virtual devices for running your app in the emulator.

+ + +

Installing SDK updates

+ +

The SDK Manager +is also accessible to download new Android tools, platforms, and libraries +for your app. Click the SDK Manager + in the toolbar to open it and check +for updates.

+ + +

Creating new files

+ +

You can quickly add new code and resource files by clicking the appropriate directory in the +Project pane and pressing CTRL + N (CMD + N, on Mac). Based on the type of +directory selected, Android Studio offers to create the appropriate file type.

+ +

For example, if you select a layout directory, press CTRL + N, and select +Layout resource file, a dialog opens so you can name the file (you can exclude +the {@code .xml} suffix) and choose a root view element. The editor then switches to the layout +design editor so you can begin designing your layout.

+ + +

Creating layouts

+ +

Android Studio offers an advanced layout editor that allows you to drag-and-drop widgets +into your layout and preview your layout while editing the XML.

+ +

While editing in the Text view, you can preview the layout on devices by opening +the Preview pane available on the right side of the window. Within the +Preview pane, you can modify the preview by changing various options at the top of the pane, including +the preview device, layout theme, platform version and more. To preview the layout on multiple +devices simultaneously, select Preview All Screen Sizes from the device drop-down. +

+ +

You can switch to the graphical editor by clicking Design at the +bottom of the window. While editing in the Design view, you can show and hide the +widgets available to drag-and-drop by clicking Palette on the +left side of the window. Clicking Designer on the right side of the window reveals +a panel with a layout hierarchy and a list of properties for each view in the layout.

+ + +

Debugging

+ +

When you build and run your app with Android Studio, you can view adb and device log messages +(logcat) in the DDMS pane by clicking Android at the bottom of the window.

+ +

If you want to debug your app with the Android Debug Monitor, you can launch it by +clicking Monitor in the toolbar. The Debug Monitor is where +you can find the complete set of DDMS +tools for profiling your app, controlling device +behaviors, and more. It also includes the Hierarchy Viewer tools to help +optimize your layouts.

+ + + + + +

Keyboard Commands

+ +

The following tables list keyboard shortcuts for common operations.

+ +

Note: If you're using Mac OS X, update your keymap to use +the Mac OS X 10.5+ version keymaps under Android Studio > Preferences > Keymap.

+ + + +

Table 1. Programming key commands

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ActionAndroid Studio Key Command
Command look-up (autocomplete command name)CTRL + SHIFT + A
Project quick fixALT + ENTER
Reformat codeCTRL + ALT + L (Win)
+ OPTION + CMD + L (Mac)
Show docs for selected APICTRL + Q (Win)
+ F1 (Mac)
Show parameters for selected methodCTRL + P
Generate methodALT + Insert (Win)
+ CMD + N (Mac)
Jump to sourceF4 (Win)
+ CMD + down-arrow (Mac)
Delete lineCTRL + Y (Win)
+ CMD + Backspace (Mac)
Search by symbol nameCTRL + ALT + SHIFT + N (Win)
+ OPTION + CMD + O (Mac)
+ + + + +

Table 2. Project and editor key commands

+ + + + + + + + + + + + + + + + + + + + + + + +
ActionAndroid Studio Key Command
BuildCTRL + F9 (Win)
+ CMD + F9 (Mac)
Build and runSHIFT + F10 (Win)
+ CTRL + R (Mac)
Toggle project visibilityALT + 1 (Win)
+ CMD + 1 (Mac)
Navigate open tabsALT + left-arrow; ALT + right-arrow (Win)
+ CTRL + left-arrow; CTRL + right-arrow (Mac)
+ +

For a complete keymap reference guide, see the IntelliJ IDEA +documentation.

+ diff --git a/docs/html/sdk/installing/studio.jd b/docs/html/sdk/installing/studio.jd new file mode 100644 index 0000000..856121a --- /dev/null +++ b/docs/html/sdk/installing/studio.jd @@ -0,0 +1,471 @@ +page.title=Getting Started with Android Studio +@jd:body + + + + +
+ +

EARLY ACCESS PREVIEW

+ + + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

This download includes:

+
    +
  • Android Studio early access preview
    • +
  • All the Android SDK Tools to design, test, debug, and profile your app
    • +
  • The latest Android platform to compile your app
    • +
  • The latest Android system image to run your app in the emulator
    • +
+ +
+
+ + + +

Android Studio is a new Android development environment based on IntelliJ +IDEA. Similar to Eclipse with the +ADT Plugin, Android Studio provides integrated Android developer tools +for development and debugging. On top of the +capabilities you expect from IntelliJ, Android Studio offers:

+ +
    +
  • Gradle-based build support.
    • +
  • Android-specific refactoring and quick fixes.
    • +
  • Lint tools to catch performance, usability, version compatibility and other problems.
    • +
  • ProGuard and app-signing capabilities.
    • +
  • Template-based wizards to create common Android designs and components.
    • +
  • A rich layout editor that allows you to drag-and-drop UI components, preview layouts on + multiple screen configurations, and much more.
    • +
+ +

Caution: Android Studio is currently available as +an early access preview. Several features +are either incomplete or not yet implemented and you may encounter bugs. If you are not +comfortable using an unfinished product, you may want to instead +download (or continue to use) the +ADT Bundle (Eclipse with the ADT Plugin).

+ + + + +

+ + + + + + + + + + + +

Installing Android Studio

+
    +
  1. Download the Android Studio package from above.
    2. +
  2. Install Android Studio and the SDK tools: +

    Windows:

    +
      +
    1. Launch the downloaded EXE file, {@code android-studio-bundle-<version>.exe}. +
    2. Follow the setup wizard to install Android Studio. +
    +

    Mac OS X:

    +
      +
    1. Open the downloaded DMG file, {@code android-studio-bundle-<version>.dmg}. +
    2. Drag and drop Android Studio into the Applications folder. +
    +

    Linux:

    +
      +
    1. Unpack the downloaded Tar file, {@code android-studio-bundle-<version>.tgz}, into an appropriate + location for your applications. +
    2. To launch Android Studio, navigate to the {@code android-studio/bin/} directory + in a terminal and execute {@code studio.sh}. +

      You may want to add {@code android-studio/bin/} to your PATH environmental + variable so that you can start Android Studio from any directory.

      +
      3. +
    +
    3. +
+ +

That's it! You're ready to start developing apps with Android Studio.

+ +
+

Note: On Windows and Mac, the individual tools and +other SDK packages are saved within the Android Studio application directory. +To access the tools directly, use a terminal to navigate into the application and locate +the {@code sdk/} directory. For example:

+

Windows: \Users\<user>\AppData\Local\Android\android-studio\sdk\

+

Mac: /Applications/Android\ Studio.app/sdk/

+
+ + +

Starting a Project

+ +

When you launch Android Studio for the first time, you'll see a Welcome +screen that offers several ways to get started:

+ +
    +
  • To start building a new app, click New Project. +

    This starts the New Project wizard, which helps you set up a project using an app template. +

    • +
  • To import an existing Android app project, click Import Project. +

    Note: If you previously developed your Android project + with Eclipse, you should first use the new export feature in the ADT plugin to prepare + your project with the new Gradle build system. For more information, read + Migrating from Eclipse.

    +
    • +
+ +

For additional help using Android Studio, read Tips and Tricks.

+ + +

As you continue developing apps, you may need to install additional versions +of Android for the emulator and other packages such as the Android Support Library. +To install more packages, use +the SDK Manager, which you can +open from Android Studio by clicking SDK Manager + in the toolbar.

+ + + + + + + + + + + + + + + +
+ + + + +
+ + + + + + + + + diff --git a/docs/html/tools/tools_toc.cs b/docs/html/tools/tools_toc.cs index 91a018c..a63492e 100644 --- a/docs/html/tools/tools_toc.cs +++ b/docs/html/tools/tools_toc.cs @@ -12,6 +12,7 @@ + +
  • +
    + Android Studio +
    + +
  • Exploring the SDK
  • Download the NDK -- cgit v1.1