Installing MOTODEV Studio for Android

ECCN 5E991.NR

Tested Configurations

MOTODEV Studio for Android is tested for compatibility with the following systems. Although MOTODEV Studio may be compatible with other systems, Motorola offers support only for the systems described below.

Microsoft Windows

Microsoft Windows XP Professional Version 2002 with Service Pack 3
Java™ Runtime Environment (JRE) 6.0 Update 13
Intel® Core™ 2 Duo CPU, 2.33 GHz
2 GB RAM
Over 1.5 GB of free disk space (needed to install both MOTODEV Studio for Android and the Android™ SDK and plug-ins from Google; MOTODEV Studio itself only needs 150 MB)

Mac OS X

Mac OS X version 10.5.7
Java 2 Runtime Environment, Standard Edition 5.0 32-bit
Intel Core 2 Duo CPU, 2.4 GHz
4 GB RAM
Over 1.5 GB of free disk space (needed to install both MOTODEV Studio for Android and the Android SDK and plug-ins from Google; MOTODEV Studio itself only needs 150 MB)

Ubuntu Linux

Ubuntu Linux version 9.0.4
GNOME version 2.26.1
Java™ Runtime Environment (JRE) 6.0 Update 14 32-bit
Intel Core 2 Duo CPU, 2.4 GHz
2 GB RAM
Over 1.5 GB of free disk space (needed to install both MOTODEV Studio for Android and the Android SDK and plug-ins from Google; MOTODEV Studio itself only needs 150 MB)

Fedora Linux

Fedora Linux version 11
KDE version 4.2.2
Java™ Runtime Environment (JRE) 6.0 Update 14 32-bit
Intel Core 2 Duo CPU, 2.4 GHz
2 GB RAM
Over 1.5 GB of free disk space (needed to install both MOTODEV Studio for Android and the Android SDK and plug-ins from Google; MOTODEV Studio itself only needs 150 MB)

Installing MOTODEV Studio

The MOTODEV Studio for Android installation process depends 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.

NOTE: Carefully read this installation guide and the release notes before installing and using MOTODEV Studio.

Microsoft Windows

If you already have a previous version of MOTODEV Studio for Android installed, uninstall it before proceeding.

To install:

Download MOTODEV Studio for Android to your desktop. If necessary, unzip or un-tar the downloaded file.
Double-click the MOTODEV Studio installer to launch it.
The Welcome screen appears.
Click Next.
You are presented with the license agreement.
Review the terms of the agreement. If you accept the terms, select the appropriate option and click Next.
The installer now verifies that you have the necessary version of Java installed. If you don’t, you will need to install the required Java version and then restart the MOTODEV Studio installation process. If you have the correct version of Java, click Next.
You are now prompted to specify a destination directory. Specify the directory into which MOTODEV Studio should be installed and click Next.
If necessary, the installer will create the specified destination directory. By default, the installer places MOTODEV Studio into Program Files/Motorola/MOTODEV Studio for Android version.
You are now presented with a summary of the installation settings (destination directory, installation type, and amount of disk space required). Review the settings, and if they are correct click Next.
MOTODEV Studio for Android is now installed.
After the files have been copied, you are presented with options to launch the application, create a desktop shortcut, and create a quick link shortcut. Select or clear the options as desired, then click Finish.

Now proceed to Installing the Android SDK.

Mac OS X

If you already have a previous version of the MOTODEV Studio for Android installed, uninstall it before proceeding.

To install:

Download the MOTODEV Studio for Android DMG (Apple Disk Image) file. If necessary, double-click the downloaded DMG file (your browser may open it for you).
The license agreement is displayed.
Review the terms of the agreement. If you accept the terms, click Agree.
The volume opens.
Drag and drop the MOTODEV Studio for Android folder into your Applications folder.
Eject the opened volume, and delete the DMG file from your Downloads directory (or from wherever it was downloaded to).
If you want MOTODEV Studio for Android to appear in the dock, drag the file named motodevstudio.app from the MOTODEV Studio for Android folder to the dock.

Now proceed to Installing the Android SDK.

Linux

If you already have a previous version of MOTODEV Studio for Android installed, uninstall it before proceeding.

To install:

Download MOTODEV Studio for Android to your desktop. If necessary, unzip or un-tar the downloaded file.
Double-click the MOTODEV Studio installer to launch it.
The Welcome screen appears.
Click Next.
You are presented with the license agreement.
Review the terms of the agreement. If you accept the terms, select the appropriate option and click Next.
The installer now verifies that you have the necessary version of Java installed. If you don’t, you will need to install the required Java version and then restart the MOTODEV Studio installation process. If you have the correct version of Java, click Next.
You are now prompted to specify a destination directory. Specify the directory into which MOTODEV Studio should be installed and click Next.
If necessary, the installer will create the specified destination directory. By default, the installer places MOTODEV Studio into home_dir/Motorola/MOTODEV Studio for Android version.
You are now presented with a summary of the installation settings (destination directory, installation type, and amount of disk space required). Review the settings, and if they are correct click Next.
MOTODEV Studio for Android is now installed.
After the files have been copied, you are presented with options to launch the application, create a desktop shortcut, and create a quick link shortcut. Select or clear the options as desired, then click Finish.

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 with read-write permission by MOTODEV Studio for Android:

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 uses 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 the Android SDK

Launch MOTODEV Studio for Android and specify a workspace[1]. If the workspace that you specify does not have a setting for the Android SDK (as is the case when you specify a workspace directory that does not yet exist), MOTODEV Studio displays a dialog containing the following options:

Download SDKs from the update Site and configure one of them.
Choose this option if you have not yet installed the Android SDK. MOTODEV Studio will verify that you can connect to the appropriate web servers (helping you to establish that connection, if necessary), after which it will download, unpack, and install the latest Android SDK into the directory that contains MOTODEV Studio for Android.

IMPORTANT: On Microsoft Windows 7 and Windows Vista hosts, if the User Account Control (UAC) is enabled, do not use this option. Due to UAC restrictions it will not work. Instead, you must manually download and install the Android SDK.

IMPORTANT: When you are on a network that requires proxy authentication, MOTODEV Studio may only be able to download and install the Android 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.

NOTE: When you allow MOTODEV Studio to download and install the Android SDK, the progress bar does not accurately reflect the status of the operation.
Use an existing SDK from the file system.
Choose this option if you have already installed the Android SDK on your development computer. You will be prompted to specify the path to the Android SDK.
Configure the SDK later.
Choose this option if you do not want to configure the SDK at this time. Note that although you will be able to run MOTODEV Studio for Android, until you configure the 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 the SDK, tell MOTODEV Studio where it is installed by selecting Preferences from the Window menu, and then selecting Android from the list of preferences.

Note that while running MOTODEV Studio for Android if you switch to a workspace that does not have a reference to the Android SDK, MOTODEV Studio attempts to locate it. If the SDK is not located in the directory in which MOTODEV Studio for Android is installed, you will again be presented with the above dialog, giving you the option to download the SDK or specify its location.

Checking for Updates

MOTODEV Studio makes use of the Eclipse™ update mechanism to ensure that it is always up-to-date. To check for updates:

Select Software Updates from the MOTODEV Studio Help menu.
The Software Updates and Add-ons dialog appears.
Click the Installed Software tab to bring it to the front, if necessary.
On the Installed Software tab, select MOTODEV Studio for Android Feature.
Click Update.

If there are available updates, they will now be downloaded and installed.

Uninstalling

Microsoft Windows

Click Start, 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.

Mac OS X

Delete the directory within your Applications directory that contains MOTODEV Studio for Android.
If MOTODEV Studio for Android is in your dock, drag it out.

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.

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.