Created: July 24, 2009
Updated: February 1, 2012

Installing MOTODEV Studio for Android

You can install MOTODEV Studio for Android™ either as a stand-alone application or as a set of plugins to an existing Eclipse™ installation. If you have an existing Eclipse installation and would like to add MOTODEV Studio for Android to it, skip down to Installing MOTODEV Studio as Plugins for instructions. Otherwise, follow the instructions under Installing MOTODEV Studio as an Application to install MOTODEV Studio for Android as a stand-alone application.

Prerequisites

MOTODEV Studio requires Java 6. Note that although most MOTODEV Studio for Android features will work if you only have a JRE (Java Runtime Environment) installed, some features—such as ProGuard code obfuscation—require a full JDK (Java Development Kit). Motorola Mobility recommends that you have a JDK installed on your development computer.

The MOTODEV Video Tutorials view requires Adobe Flash Player. If you do not have it installed, you will need to install the version (32-bit or 64-bit) that matches your development computer's architecture. The 32-bit version can be obtained from http://get.adobe.com/flashplayer/, while the 64-bit version, as of this writing, can be obtained from http://labs.adobe.com/downloads/flashplayer11.html.

Tested Configurations

MOTODEV Studio for Android is tested for compatibility with the following systems. Although MOTODEV Studio may be compatible with other configurations and systems, we guarantee support only for the systems described below.

Microsoft Windows 7 Professional, 32- and 64-bit versions
Microsoft Windows XP Professional (32-bit), SP3
Mac OS X 10.6.4, 64-bit
Ubuntu 11.04, 32- and 64- bit versions, running GNOME

All of the test systems have Intel® Core™ 2 Duo CPUs, 2 GB or more of RAM (4 GB for Mac OS X), the latest Java™ SE Development Kit (JDK), and over 1.5 GB of free disk space (MOTODEV Studio itself only needs 200 MB, but to install both MOTODEV Studio for Android and the Android SDK and plug-ins from Google you need at least 1.5 GB of free disk space).

Installing MOTODEV Studio as an Application

The MOTODEV Studio for Android installation process varies slightly depending upon your underlying operating system. Once you have installed MOTODEV Studio, the process of installing or configuring the Android SDK (documented under Installing the Android SDK) is the same regardless of your operating system.

If you already have a previous version of MOTODEV Studio for Android installed, you may want to uninstall it. Although two versions may coexist, we do not test and thus do not support multiple versions of MOTODEV Studio for Android installed on a single computer. Do not install MOTODEV Studio into a folder that contains an existing version of MOTODEV Studio or any other content. Always install it into a new folder.

Before installing and using MOTODEV Studio, carefully read through this installation guide and the release notes, which can be found on the MOTODEV Studio download page.

Microsoft Windows

First, determine whether you want to install the 32- or 64-bit version of MOTODEV Studio. Then download the appropriate version of MOTODEV Studio for Android, double-click the downloaded executable, and follow the on-screen instructions.

Now proceed to Installing the Android SDK.

Mac OS X

To install, download MOTODEV Studio for Android, double-click the downloaded executable (it is a jar file), and follow the on-screen instructions.

If, during installation, you see motodevstudio wants to use your confidential information stored in "equinox.secure.storage" in your keychain, click Always Allow. This comes from Eclipse; it is asking if it should use standard operating system mechanisms to store the password used to encrypt your confidential information, such as your proxy username and password.

Now proceed to Installing the Android SDK.

Linux

If you will be connecting a handset to your development computer, you will also need to define specific udev rules that make the handset accessible to MOTODEV Studio for Android with read-write permission:

Create a file named 51-android.rules in the /etc/udev/rules.d/ directory.
Edit the above file so that it contains the following line:
SUBSYSTEM=="usb", ATTRS{idVendor}==vendor_id, MODE="0666" Substitute the vendor ID for your device in place of vendor_id. Motorola's vendor ID is "22b8". The vendor id for the HTC G1 handset is "0bb4". Note that the vendor ID must be enclosed in double-quotes.
Save the file.

Depending on the Linux distribution, the line to be entered in 51-android.rules may vary. Some older releases of udev use SYSFS to query the devices properties while newer releases use ATTRS. As well, the subsystem name may need to be changed to "usb_device". Thus, the line might need to be:

SUBSYSTEM="usb_device", SYSFS {idVendor}==vendor_id, MODE="0666"

Now proceed to Installing the Android SDK.

Installing MOTODEV Studio as Plugins

MOTODEV Studio for Android is also available as a set of plugins that can be added to an existing installation of Eclipse, using Eclipse's standard update mechanism. You can install these plugins directly from the Internet, or from an archive file you have downloaded from the MOTODEV web site.

Ensure that you have the correct version of Eclipse as listed in the Eclipse Plug-In Version table on the MOTODEV Studio download page.

Note that if you are installing from the zip archive containing the plugins and don't have an Internet connection, you must already have the required version of Eclipse. If you do not, you must first update Eclipse: the zip archives do not contain any Eclipse packages.
If your Eclipse has Google's ADT plugin installed, and it is not the same as the version used by MOTODEV Studio for Android (see the release notes for the version number used by MOTODEV Studio), uninstall it. The MOTODEV Studio for Android plugins download and install the latest ADT from Google, and an existing installation may conflict. For instructions on uninstalling the ADT plugin, see Uninstalling the ADT plugin in Google's online documentation.
From Eclipse's Help menu, select Install New Software.
The Available Software dialog appears.
Click Add (to the right of the Work with field).
The Add Site dialog appears.
Specify the location of the MOTODEV Studio plugins.
- If you are installing the latest plugins over the Internet, enter the following URL into the Location field and click OK:
  https://studio-android.motodevupdate.com/android/3.0
  Note that you will be asked to log in. Provide your MOTODEV login and password.
- If you are installing the plugins from an archive, click Archive and select the archive you have previously downloaded from the MOTODEV web site. Then, click OK in the Add Site dialog.
Depending on your network, installing the plugins from an archive can take a long time. To speed installation in this specific case, disable the network while installing and clear the “Contact all update sites” option.

Back on the Install dialog, ensure that the Group items by category option is enabled. MOTODEV Studio for Android should now be listed in the center of the dialog. If it is not, and you are installing the plugins over the Internet, you may not have access to the MOTODEV site from within Eclipse. If necessary, switch to the General > Network Connections preferences dialog and make any needed adjustments. Or, download the plugin archive and install from that.
Select the checkbox to the left of "MOTODEV Studio for Android" (this selects all of the features that make up MOTODEV Studio for Android: MOTODEV Studio itself, the Application Validator, and the integration between the two). Click Next.
Assuming that all is correct, the Install Details page is shown.
Click Next.
You will be presented with the license agreements to be reviewed.
Review the terms of each agreement. If you accept the terms, select the appropriate option and click Finish.
The download and installation of the MOTODEV Studio for Android plugins will begin.
Once the MOTODEV Studio for Android plugins have been installed, you will be prompted to restart. Click Yes to restart Eclipse and have the new plugins take effect.

Now proceed to Installing the Android SDK.

Installing the Android SDK

When MOTODEV Studio for Android launches, it checks your workspace[1] for a reference to an SDK. If your workspace does not reference an SDK, MOTODEV Studio for Android looks for one in the directory in which MOTODEV Studio for Android is installed. If no SDK is found, it presents the "Download components" dialog from which you can either download an SDK or specify the location of one already on your hard drive.

If you are on a network that requires proxy authentication, MOTODEV Studio may only be able to download and install an SDK if the proxy information (including username and password) are manually set for both HTTP and HTTPS connections (in Preferences, under General > Network Connections). If during installation you are asked if you want to change the connection preferences, do so. Change the active provider to "Manual" and provide host, port, user, and password values for both the HTTP and HTTPS schemes.

Using the Download Components dialog, do one of the following:

To use an existing Android SDK already on your development computer:
1. Select SDK Location.
2. Using the provided field, indicate the location of the SDK to use. Note that you can use the Browse button to navigate to the SDK location.
3. Click OK.
  MOTODEV Studio for Android configures your workspace to use the selected SDK.
4. If the SDK you selected does not have any downloaded platforms associated with it, you will then be asked whether the Android SDK Manager should be opened so that you can download one or more platforms. If so:
  1. Click Yes.
    The Android SDK Manager opens.
  2. At the bottom of the dialog, ensure that Updates/New is checked. Also verify that the package list is sorted by API level.
  3. Select the desired platform(s) to install. To save space you can omit some components of the platform (click the disclosure triangle next to the package to expose its components). At a minimum you'll need SDK Platform and, if you want to be able to create AVDs (emulators), ARM EABI v7a System Image.
  4. Click Install packages. When the confirmation dialog appears, review and accept the license agreements and click Install.
You may want to take this opportunity to check for updates to your existing SDK. See Android SDK Updates, below.
To download the SDK and install one or more Android platforms:
1. Click Download.
2. When requested, indicate where the downloaded SDK should be stored on your development computer.
  The latest SDK and platform tools will be downloaded to your computer and stored in the specified location.
3. You will now be asked whether the Android SDK Manager should be opened so that you can download one or more platforms. Click Yes.
  The Android SDK Manager opens.
4. At the bottom of the dialog, ensure that Updates/New is checked. Also verify that the package list is sorted by API level.
5. Select the desired platform(s) to install. To save space you can omit some components of the platform (click the disclosure triangle next to the package to expose its components). At a minimum you'll need SDK Platform and, if you want to be able to create AVDs (emulators), ARM EABI v7a System Image.
6. Click Install packages. When the confirmation dialog appears, review and accept the license agreements and click Install.

To skip this step entirely (and install the SDK later), click Cancel in the Download Components dialog. Note that although you will be able to launch MOTODEV Studio for Android, until you install and configure an SDK you won’t be able to create an Android project, run the emulator, or perform any other task that requires the Android tools and libraries. If you later download an SDK, tell MOTODEV Studio where the SDK is installed by selecting Preferences from the Window menu and then selecting Android from the list of preferences.

Installing Other Components

If you want to install sample code or support for native (C/C++) development, use MOTODEV Studio's Download Components feature:

Launch MOTODEV Studio for Android.
From the MOTODEV menu select Download components.
On the left side of the Download Components dialog, click the desired options. Select the specific components you want to install from the right side of the dialog.
When you have made all of your desired choices, click OK in the Download Components dialog.

Checking for Updates

At any time you can check for updates to MOTODEV Studio for Android or to the platforms and SDKs you have installed. Be aware, however, that updates from one version of MOTODEV Studio for Android to another are only supported for certain releases. Only if an update is listed on the MOTODEV Studio for Android download page is an update supported. Otherwise, you must perform a full installation.

MOTODEV Studio Updates

MOTODEV Studio makes use of the Eclipse update mechanism for some updates (but read "Checking for Updates," above).

Select Update MOTODEV Studio from the MOTODEV menu. If there are updates, the Available Updates dialog appears. If the dialog does not appear, either there are no updates or Eclipse cannot contact the update server.

To check for network problems, navigate to the Install/Update > Available Software Sites preferences, select MOTODEV Studio for Android <version> Updates from the list of software sites, and click Test Connection. Note that if your computer accesses the Internet through a proxy, you may need to update Eclipse's proxy settings. Proxy settings can be found in the General > Network Connections preferences.

If you see the progress bar stuck at 20% while checking for updates, it is waiting for you to provide your MOTODEV login credentials. Look for a login dialog (it may be hidden behind other dialogs) and log in.
The license associated with the update is now displayed. Review the license and, if you agree with it, select I accept the terms of the license agreement and then click Finish.

The updates are now be downloaded and installed. For some updates you may be notified that a restart of MOTODEV Studio for Android is recommended. Generally you will want to click Yes to restart MOTODEV Studio.

Android SDK Updates

Use the Android SDK Manager to check for new and updated Android SDK components, as described in the Android documentation under Adding SDK Components.

Select Android SDK Manager from the Window menu. The Android SDK Manager will open.
Select Available Packages in the left pane. The right panel will show all components available for download.

When you are on a network that requires proxy authentication, the Android SDK Manager may only be able to list, download, and install new components if the proxy information (including username and password) are manually set for both HTTP and HTTPS connections (in Preferences, under General > Network Connections). Change the active provider to "Manual" and provide host, port, user, and password values for both the HTTP and HTTPS schemes.
At the bottom of the dialog, ensure that Updates/New is checked. Also verify that the package list is sorted by API level.
Select the desired platform(s) to install. To save space you can omit some components of the platform (click the disclosure triangle next to the package to expose its components). At a minimum you'll need SDK Platform and, if you want to be able to create AVDs (emulators), ARM EABI v7a System Image.
Click Install packages. When the confirmation dialog appears, review and accept the license agreements and click Install.

Uninstalling

Launch the uninstaller.
- On Microsoft Windows, click Start, and then select Programs > MOTODEV Studio > MOTODEV Studio for Android version > Uninstall MOTODEV Studio for Android version.
- On Mac OS X, double-click Applications/MOTODEV_Studio_for_Android_version/uninstaller.jar.
- On Linux, click on the applications menu of your windowing system and then select Programs > MOTODEV Studio > MOTODEV Studio for Android version > Uninstall MOTODEV Studio for Android version
The uninstall wizard appears.
Click Uninstall.
The uninstall process begins.
When the uninstall is complete, click Finish to exit the uninstaller.

Footnotes

1. A workspace is a directory that contains your projects along with various settings used by MOTODEV Studio. Among those settings is a reference to the Android SDK.

Created: July 24, 2009
Updated: February 1, 2012

ECCN 5E991.NR: In accordance with United States Export Administration Regulations (EAR), and specifically the Commerce Control List (CCL), this item has been classified 5E991.NR. Export or re-export of this commodity and compliance with the U.S. Export Administration Regulations is ultimately the responsibility of the exporter. For more detailed information related to export or re-export of this item, please consult the EAR at http://www.access.gpo.gov/bis/ear/ear_data.html.