Chapter 1

Getting Started

WHAT'S IN THIS CHAPTER?

System requirements for Android Studio

Java installation instructions for Microsoft Windows, Mac OSX, and Linux

Android Studio installation instructions for Microsoft Windows, Mac OSX, and Linux

In this chapter you get started with setting up your development environment so you can start Android development with Android Studio. To that end, this chapter covers the basic installation instructions for Android Studio and its system requirements.

Although the Android operating system is based on Linux, the Android SDK and tools are available for all major operating systems, so you can set up your development environment for the operating system you are working with. Throughout this book we use Mac OS as the main environment; however, we cover Linux and Windows setup as well.

SYSTEM REQUIREMENTS FOR WINDOWS, MAC OS X, AND LINUX

To use Android Studio, your development system must meet the minimum system requirements. This section lists the minimum requirements for Windows, Mac OS X, and Linux.

Microsoft Windows

Microsoft Windows 10/8/7/Vista/2003 (32 or 64 bit)

2GB RAM minimum, 4GB RAM recommended

400MB hard disk space

At least 1GB for Android SDK, emulator system images, and caches

1280 × 800 minimum screen resolution

Java Runtime Environment (JRE) 6 or higher

Java Development Kit (JDK) 7

Optional for accelerated emulator: Intel processor with support for Intel VT-x, Intel EM64T (Intel 64), and Execute Disable (XD) Bit functionality

Mac OS X

Mac OS X 10.8.5 or higher, up to 10.9 (Maverick)

2GB RAM minimum, 4GB RAM recommended

400MB hard disk space

At least 1GB for Android SDK, emulator system images, and caches

1280 × 800 minimum screen resolution

Java Runtime Environment (JRE) 6

Java Development Kit (JDK) 7

Optional for accelerated emulator: Intel processor with support for Intel VT-x, Intel EM64T (Intel 64), and Execute Disable (XD) Bit functionality

Linux

GNOME or KDE desktop

GNU C Library (glibc) 2.15 or later

2GB RAM minimum, 4GB RAM recommended

400MB hard disk space

At least 1GB for Android SDK, emulator system images, and caches

1280 × 800 minimum screen resolution

Java Runtime Environment (JRE) 6 or higher

Oracle Java Development Kit (JDK) 7

More details about system requirements can be found at https://developer.android.com/sdk/index.html#Requirements.

Keep in mind that based on the size of the project, number of your dependencies, and emulator usage, you will likely need more resources. Typically, you will need at least 8GB of RAM and GPU support to run an emulator and work smoothly with better compilation times.

In most cases, developers need to test applications on multiple devices. Because they usually don't have enough devices to test adequately, they rely on emulators. Emulators require a high amount of storage and memory to run faster.

NOTE

Emulators are virtual devices, so having a CPU with virtualization support is crucial for developers to get the best experience with Android emulators.

INSTALLING JAVA

Java is essential for all operating systems. You must install Java SE (Standard Edition) Development Kit (JDK) for your operating system.

NOTE

We suggest the Java distribution provided by Oracle. It is possible to encounter problems with OpenJDK or other Java distributions.

NOTE

At the time of this writing, Java SE 8 is the latest version of JDK.

The JDK 7 download page can be accessed directly at http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html. When you navigate there, the page shown in Figure 1.1 appears.

Figure 1.1 JDK download page

To download the required installation binary or packages, select the Accept License Agreement option and then click the download link of the binary or package for your operating system.

The following sections provide installation instructions for Oracle Java version 7 on 64 bit Windows, Mac OS X, and Linux.

Installing Java for Windows OS

Java installation on Windows is pretty straightforward. As mentioned in the previous section, installing JDK provides JRE as well.

NOTE

Depending on the version of your Windows installation, you need to download and install either the 64 bit or 32 bit version of the JDK. Since most modern computers are equipped with 64 bit CPUs, we will continue with installation of the 64 bit version. If you have a 32 bit Windows installation, use the 32 bit JDK, which is listed as the Windows x86 version.

Download the jdk-7u79-windows-x64.exe file and run it to start the installation.

Install Java

Start the Java installation by clicking the jdk-7u79-windows-x64.exe file after downloading it; you will see the dialog box shown in Figure 1.2.

Figure 1.2 Java installation setup wizard

Click the Next button to continue.

In the window that opens, all items are selected by default to be installed on your local hard drive. You can change the installation path and which installation modules to install. For Android application development, the Public JRE and Development Tools options must be selected if they are not already installed on your machine. (If they are already installed, they will not be listed inside the window.) You may deselect Source Code, which is used to install public Java API classes. It is not mandatory to install the source code. Make your selections in the dialog shown in Figure 1.3.

We suggest that you continue with the default selections and use the default installation path, then click Next to finish the installation.

Figure 1.3 Java installation setup window

Setting Paths for Java on Windows 10

After the installation finishes, you need to set the Windows 10 environment paths for Java to configure the system environment. You need to set a path for the JAVA_HOME system variable.

WARNING

In earlier versions of Windows, the steps for setting the environment path might be a little different.

Right-click the Start menu icon and click File Explorer. In the window that opens, right-click This PC and select Properties to open the System window.

From the options at the left of the System window, select Advanced system settings. This will open the dialog box shown in Figure 1.4 with the Advanced tab enabled.

Click the Environment Variables… button shown in Figure 1.4.

From the Environment Variables window that opens, click the New button and set the Java path with your installation directory. As shown in Figure 1.5, the path is C:\Program Files\Java\jdk1.7.0_79 for our 64 bit installation. If you installed the x86 version, your path would be different, such as C:\Program Files (x86)\Java\jdk1.7.0_79.

Figure 1.4 Java path setup for Windows 10

Figure 1.5 Java Environment Variables setup for Windows 10 64-bit

Installing Java for MacOS X

Java used to be a part of Mac OS X and was shipped by Apple. This changed several years ago. Apple also decided to remove Java from Mac OS so JDK, which is provided by Oracle, needs to be installed separately.

Start by downloading the jdk-7u79-macosx-x64.dmg file from the page shown in Figure 1.1.

Launch the dmg file to display the window shown in Figure 1.6.

Double click the JDK 7 Update 79.pkg file link to start the installation.

Select the installation directory you want and complete the installation in the window shown in Figure 1.7.

Figure 1.6 Mac OS X Java installation

Figure 1.7 Java installation Max OS X

Now JDK is ready to use on Mac OS X. You can check the installed JDK version from System Preferences of Mac OS X or type 'java –version' in the terminal window to see whether Java installed properly.

Installing Java for Linux

Two types of installation packages are available for Linux. If you use a distribution with an rpm package manager like Fedora, you can download the rpm package and install Java via rpm. In this section you install JDK with the tar.gz package on Ubuntu 14.04.

Download jdk-7u79-x64.tar.gz from the download page shown in Figure 1.1 and extract it to the directory where you downloaded the tar.gz file using the following command:

user@ubuntu$ tar xzvf jdk-7uXX-x64.tar.gz

That command will extract JDK into the jdk1.7.0_79 folder where you ran the command.

Move that folder to /usr/local/java with the following command:

user@ubuntu$ mv jdk1.7.0_79 /usr/local/java

Edit the /etc/profile file to set Java paths for your session. You can copy and paste the following lines to the end of the /etc/profile file.

##Java Path

JAVA_HOME=/usr/local/java/jdk1.7.0_79

JRE_HOME=$JAVA_HOME/jre

PATH=$PATH:$JAVA_HOME/bin:$JRE_HOME/bin

export JAVA_HOME

export JRE_HOME

export PATH

Install Java binaries for system-wide use with the following commands:

Install the Java binary:

user@ubuntu$ sudo update-alternatives --install /usr/bin/java java

/usr/local/java/jdk1.7.0_79/bin/java 1

Install the Java Compiler binary javac:

user@ubuntu$ sudo update-alternatives --install /usr/bin/javac javac

/usr/local/java/jdk1.7.0_79/bin/javac 1

Install the Java Web Start binary javaws:

user@ubuntu$ sudo update-alternatives --install /usr/bin/javaws javaws

/usr/local/java/jdk1.7.0_79/bin/javaws 1

Set Oracle Java as the default Java for your system with the following commands:

user@ubuntu$ sudo update-alternatives --set java

/usr/local/java/jdk1.7.0_79/bin/java

user@ubuntu$ sudo update-alternatives --set javac

/usr/local/java/jdk1.7.0_79/bin/javac

user@ubuntu$ sudo update-alternatives --set javaws

/usr/local/java/jdk1.7.0_79/bin/javaws

When you are done with the previous instructions, JDK and JRE will be ready to use when you restart Ubuntu. You can test whether Java installed correctly with version control. The command and output for that will look like this:

user@ubuntu~$ java -version

java version 1.7.0_79

Java(TM) SE Runtime Environment (build 1.7.0_79-b15)

Java HotSpot(TM) 64-Bit Server VM (build 24.79-b02, mixed mode)

INSTALLING ANDROID STUDIO

Android Studio installation, like Java installation, differs by operating system. The following sections provide installation instructions for Windows, Mac OS X, and Linux platforms.

The direct link for the installation binaries is https://developer.android.com/sdk/index.html.

The download link that's available when you go to this site will be correct for the operating system you are running, as shown in Figure 1.8.

Figure 1.8 Android Studio download page

NOTE

Download options have installers bundled with Android SDK tools.

Installing Android Studio for Microsoft Windows 10

This section covers the installation instructions for Android Studio on Microsoft Windows 10.

WARNING

Make sure you are connected to Internet while you are installing the Android Studio because installation process includes downloading required Android SDK installation files from the web.

Click the Download Android Studio for Windows link to download the latest Android Studio installer exe file.

Run the exe file after the download completes. You will see the window shown in Figure 1.9.

Click the Next button to select installation components. The Android Studio option can't be changed, but you can deselect the Android SDK, Emulator, and Intel HAXM installations, as shown in Figure 1.10.

The next window prompts you for installation paths for Android Studio and Android SDK separately.

As shown in Figure 1.11, the installation asks about Intel HAXM memory configuration, and lets you choose a custom memory configuration.

Figure 1.9 Android Studio Setup window

Figure 1.10 Android Studio Setup configuration for Windows

Figure 1.11 Intel HAXM configuration dialog for Windows

TIP

Recommended memory for HAXM is 2GB, but you can change that based on your hardware. We recommend that you install HAXM if you plan to use the emulator.

HAXM is a hardware-assisted virtualization engine that lets you use your computer's processor to generate x86 Android images. Without HAXM, the emulator's performance will greatly suffer.

You are now ready to launch Android Studio on Windows. The first time you launch Android Studio, it asks you to select the theme for the IDE, as shown in Figure 1.12.

Figure 1.12 Android Studio theme selection on Windows

Finally, the installation completes and Android Studio is ready to work on Android application projects.

Installing Android Studio for Mac OS X

This section covers the basic steps to install Android Studio on Mac OS X.

From the page shown in Figure 1.8, click the Download Android Studio for MAC link.

Download the android-studio-ide-141.2178183-mac.dmg file, which includes the Android Studio IDE installer for Mac OS.

Launch the file you just downloaded.

Drag and drop the Android Studio.app icon into Applications folder, as shown in Figure 1.13.

Figure 1.13 Android Studio installer for Mac OS X

After copying Android Studio to the Applications folder, Android Studio is ready to launch. You can then remove the .dmg file from your system.

When you first launch Android Studio, it asks if you want to install Android SDK, the Android emulator, and Intel HAXM. It will also ask for the setup path for them, as shown in Figure 1.14.

Figure 1.14 Android Studio Setup Wizard for Max OS X

If you selected Intel HAXM installation, you are asked for the amount of RAM memory you want to make available for the virtual devices, as shown in Figure 1.15.

Figure 1.15 Intel HAXM configuration for Mac OS X

After you click Finish from the Emulator Settings dialog box, a window with an installation summary will display as shown in Figure 1.16.

Figure 1.16 Summary window for Max OS X installation

Installing Android Studio for Linux

Navigate to the download page shown in Figure 1.9 to download Android Studio for Linux (android-studio-ide-141.2178183-linux.zip). After you've downloaded the file, follow these steps:

Enter the following command to extract the setup file to the android-studio folder where you executed the command:

user@ubuntu$ unzip android-studio-ide-141.2178183-linux.zip

In this example you move the android-studio folder to the /opt directory. You can select your own home directory as well, to make it available only to you.

user@ubuntu$ sudo mv android-studio /opt

Start Android Studio with the ./opt/android-studio/bin/studio.sh command.

When you first launch Android Studio on Linux, it will display the screen shown in Figure 1.17.

Then the setup wizard will ask for Standard or Custom installation.

Select Custom installation to see the installation packages.

The wizard moves to the window shown in Figure 1.18 where you can select an Android Studio UI theme.

Figure 1.18 shows that the IntelliJ theme has been selected for this installation.

Select the Android Studio, Android SDK, and Emulator as shown in Figure 1.19.

Indicate the installation path for Android SDK in the Android SDK Location field at the bottom of the dialog box, as shown in Figure 1.19. Click Finish to complete the Android SDK installation.

Figure 1.17 Android Studio Setup Wizard for Linux

Figure 1.18 Theme selection window for Linux

Figure 1.19 Android SDK configuration on Linux

LAUNCHING ANDROID STUDIO FOR THE FIRST TIME

When you first launch Android Studio, you will see the Complete Installation dialog box shown in Figure 1.20, which enables you to import settings from a previous installation. Because we made a clean installation for this example, we selected the last option in the dialog box. If you have a previous installation with customization you'd like to import, you can specify your previous installation path (see the first two options in Figure 1.20).

Figure 1.20 First launch of Android Studio

Welcome to Android Studio

Welcome to the world of Android development! When you finish installing Android Studio, you will finally reach the screen shown in Figure 1.21. Android Studio is ready to work with Android projects.

Figure 1.21 Welcome to Android Studio

STANDALONE SDK INSTALLATION

In this book, the main focus is on using Android Studio for development at an advanced level. Therefore, the book covers Android SDK and tools installations together with Android Studio. If you would like to explore Android SDK and tools separately, you can get the standalone installation binaries for your choice of operating system.

Standalone installation will help you either work with an IDE other than Android Studio, or to use the tools alone. The binaries are available at http://developer.android.com/sdk/index.html at the bottom of the page.

As you did in this chapter, you can download the compatible binary for your operating system and follow similar installation steps to continue. After you download and extract the SDK, you can add its location to Android Studio using Settings⇨Appearance & Behavior⇨System Settings⇨Android SDK⇨Android SDK Location.

SUMMARY

In this chapter, we wanted to make sure you have all the necessary tools to work on the examples in the following chapters. We started by providing the requirements for the basic computer system needed to install the required software.

We then covered the installation of Android Studio for Windows, Mac OS, and Linux. We continue with what is required to begin Android application development in Android Studio in Chapter 2.

Chapter 2

Android Studio Basics

WHAT'S IN THIS CHAPTER?

How to create an Android Studio project

Android project structure

Creating and configuring virtual devices

Building and running your project via ADB

Migrating Android projects from Eclipse IDE

Welcome to Android Studio! Whether you are an Eclipse-based ADT veteran or a total newbie to Android development, you will enjoy Android Studio, which is based on IntelliJ IDEA and offers new tools, a UI editor, a whole new build system, memory/CPU analyzers, and many more new features and functionalities.

After long years of the Eclipse-based ADT plugin suite, Google announced (at Google I/O 2014) that Android Studio would be the official supported IDE for Android Development. Of course, you can still use ADT if you are coming from a strong Eclipse background; however, you will probably face problems that you may need to solve on your own.

As an Eclipse committer who has written code for several Eclipse projects, I preferred to stay with ADT for a long time. However, with the announcement that Android Studio is the official IDE, resistance is futile.

If you are new to Android development, it may even be easier to adapt to Android Studio because your previous Eclipse experience might not necessarily help you a lot on the IntelliJ platform.

CREATING A NEW SAMPLE PROJECT

Figure 2.1 shows the welcome screen of Android Studio, which is the first screen you will see when you launch Android Studio. From here, you can start a new project. In this chapter, you will work on a sample project, so let's open an existing project by importing the code.

Figure 2.1 Welcome to Android Studio window

Click the Import an Android code sample option in the list shown in Figure 2.1.

Numerous sample projects are hosted in GitHub. Because those projects are always up-to-date and new ones are added when a new API or functionality is introduced, it is a good idea to use them as a reference template for your own projects. Plus, all those samples are under the Apache software license, which makes them available to be used freely even in commercial products.

Because everyone loves selfies, in this example you build yet another selfie app.

Scroll down to Camera and select Camera2 Basic from the list shown in Figure 2.2.

Keep the Application name and Project location that appear on the Sample Setup screen (see Figure 2.3).

Figure 2.2 Import Sample—Browse Samples window

Figure 2.3 Import Sample—Sample Setup window

Click Finish.

Your project will be downloaded from GitHub, and the main IDE window, which is mostly empty, will appear.

Once you click Finish, Android Studio creates the project and switches to the main development layout. Before you figure out where to find your project files, let's take a look at Android SDK configuration in the following sidebar.

ANDROID SDK CONFIGURATION INSIDE ANDROID STUDIO

Android SDK can be downloaded and configured within Android Studio too with using Android Studio Preferences window. The following steps walk you through the configuration process.

Click the SDK Manager icon on the right side of the top toolbar, as shown in Figure 2.4.

The Android Studio Default Preferences window opens, as shown in Figure 2.5. The window focuses on the SDK integration option, listing the installed and available SDK versions as well as showing if any of them are eligible for an update.

Figure 2.4 SDK Manager button in Android Studio

Figure 2.5 Android Default Preferences for Android SDK window

You can use the checkboxes next to installed versions and click Apply to start the installation of the desired version. As shown in Figure 2.5, a typical setup may include installed, not installed, and partially installed SDK versions.

You can also choose to start the standalone SDK Manager by clicking the Launch Standalone SDK Manager link shown at the bottom of Figure 2.5. After clicking that link, you see the detailed installation options shown in Figure 2.6.

NOTE

We recommend that you install and update to the latest version of Android SDK Tools and Android SDK Platform tools. The SDK version you should use mostly depends on your project requirements. As a starting point, we recommend installing the latest SDK, which is API 23, and a widely accepted version such as API 19 or 20.

Figure 2.6 Android SDK Manager installation window

Scroll down to Extras and make sure Support Repository, Support Library, Google Play Services, Google Repository, Google USB Driver (only for Windows), and Intel x86 Emulator Accelerator are selected.

Once you make sure all components are selected, click the Install button and accept the license. The SDK Manager will start the download, which may take a while depending on your selections.

NOTE

Android SDK Manager can also be used for deleting unused SDKs and build tools.

Alternatively, you can use the Android Studio Preferences view and select the SDK version you want to install.

Using Different SDKs

When the SDK installations are complete, you can start working with one of them. As long as your Android project does not make use of a feature that is introduced with a specific version of an SDK, you can easily convert your project to work with an older SDK.

NOTE

We recommend that you work with the latest version of the SDK to build and compile your project, but use the minSDK attribute to support the earliest supported version.

NOTE

We cover build and support versions of the SDK in this and following chapters.

Android Project Structure

Everything looks great? Well, not exactly because you should probably be looking at an empty screen, as shown in Figure 2.7.

NOTE

We say that you should probably be looking at an empty screen because we want these instructions to remain version agnostic. It is possible that future updates might cause a change and your screen might not be empty.

Figure 2.7 Android Studio after importing the sample project

Although the initial project screen shows nothing about your project, Android Studio gives you a list of hints about how to move to the next step. For this example, press Command+1 on Mac or Alt+1 on Windows to open the project view. The project view, shown in Figure 2.8, displays all the contents of your project.

WARNING

If you are coming from an ADT background, be aware that Android project structure has changed dramatically with Gradle. With Android Studio, project resources are grouped by types, which does not correspond to their locations on the file system. Although this is a clever approach and is handy, it can also be tricky if you are used to the projects view from ADT.

Figure 2.8 Project view on Android