Welcome to MOTODEV  |  Join  |  Log In
 
ECCN 5E991.NR

Installing MOTODEV Studio for Android

Starting with version 1.2, MOTODEV Studio for Android™ can either be installed as a stand-alone application or as a set of plugins to an existing Eclipse™ installation. If you have an existing Eclipse Galileo 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.

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 XP Professional (32-bit), SP3
  • Microsoft Windows XP Professional x64 Edition, SP1
  • Microsoft Windows 7 Professional (32-bit)
  • Microsoft Windows 7 64-bit
  • Ubuntu 9.10, 32-bit version
  • Ubuntu 9.10, 64-bit version
  • Fedora 11 KDE Desktop Edition (32-bit)
  • Fedora 12 KDE Desktop Edition (64-bit)
  • Mac OS X 10.5.4 (32-bit)
  • Mac OS X 10.5.4 (64-bit)

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™ Runtime Environment (JRE), 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). The Ubuntu systems are running GNOME.

Installing MOTODEV Studio as an Application

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: Before installing and using MOTODEV Studio, carefully read this installation guide and the release notes on the MOTODEV Studio download page.

Microsoft Windows

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

To install:

  1. Download MOTODEV Studio for Android to your desktop. If necessary, unzip or un-tar the downloaded file.
  2. Double-click the MOTODEV Studio installer to launch it.
    The Welcome screen appears.
  3. Click Next.
    You are presented with the license agreement.
  4. Review the terms of the agreement. If you accept the terms, select the appropriate option and click Next.
  5. 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.
  6. 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.
  7. 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.
  8. 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 are installing in Windows 7, you may need to set the MOTODEV Studio executable to run in compatibility mode:

  1. Open the folder in which you installed MOTODEV Studio for Android.
  2. Select the motodevstudio.exe file, then click File > Properties.
  3. In the Compatibility tab, click Run this program in compatibility mode for and select Windows XP (Service Pack 3).

Now proceed to Installing the Android or OPhone SDK.

Mac OS X

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

To install:

  1. 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.
  2. Review the terms of the agreement. If you accept the terms, click Agree.
    The volume opens.
  3. Drag and drop the MOTODEV Studio for Android folder into your Applications folder.
  4. Eject the opened volume, and delete the DMG file from your Downloads directory (or from wherever it was downloaded to).
  5. 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 or OPhone SDK.

Linux

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

To install:

  1. Download MOTODEV Studio for Android to your desktop. If necessary, unzip or un-tar the downloaded file.
  2. Double-click the MOTODEV Studio installer to launch it.
    The Welcome screen appears.
  3. Click Next.
    You are presented with the license agreement.
  4. Review the terms of the agreement. If you accept the terms, select the appropriate option and click Next.
  5. 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.
  6. 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.
  7. 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.
  8. 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:

  1. Create a file named 51-android.rules in the /etc/udev/rules.d/ directory.
  2. 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.
  3. 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 or OPhone SDK.

Installing MOTODEV Studio as Plugins

Motorola makes MOTODEV Studio available as a set of plugins that can be added to an existing installation of Eclipse Galileo, 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.

  1. If you have Google's ADT plugin installed, uninstall it. The MOTODEV Studio for Android plugins download and install the latest ADT from Google, and an existing installation will conflict. For instructions on uninstalling the ADT plugin, see Uninstalling the ADT plugin in Google's online documentation.
  2. From Eclipse's Help menu, select Install New Software.
    The Available Software dialog appears.
  3. Click Add (to the right of the Work with field).
    The Add Site dialog appears.
  4. Specify the location of the MOTODEV Studio plugins.
    • If you are installing the plugins over the Internet, enter the following URL into the Location field and click OK:
      https://studio-android.motodevupdate.com/android/1.2
      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.

    Back on the Install dialog, MOTODEV Studio for Android should now appear in the area in the center of the dialog. If it does 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 <class>General > Network Connections preferences dialog and make any needed adjustments. Or, download the plugin archive and install from that.</class>

  5. Click the checkbox to the left of "MOTODEV Studio for Android", then click Next. 
  6. Assuming that all is correct, the Install Details page is shown.
  7. Click Next.
    You will be presented with the license agreements to be reviewed.
  8. Review the terms of the 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.
  9. 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 or OPhone SDK.

Installing the Android or OPhone SDK

  1. Launch MOTODEV Studio for Android and specify a workspace[1]. If the workspace that you specify does not have a setting for the 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 an 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 selected SDKs into the directory that contains MOTODEV Studio for Android. Note that you can download and install both the Android (from Google) and OPhone SDKs using this option.

      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 or OPhone SDK.

      IMPORTANT: When you are on a network that requires proxy authentication, MOTODEV Studio may only be able to download and install the 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 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 or OPhone SDK on your development computer. You will be prompted to specify the path to the 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 the SDK is installed by selecting Preferences from the Window menu, and then selecting Android from the list of preferences.

  2. If you chose to download the OPhone SDK, after it has been downloaded the OPhone SDK installer is run. Rather than putting the OPhone SDK into the location suggested by their installer (such as C:\Program Files\OPhoneSDK_1.5), Motorola recommends that you instead put it into a directory within the directory containing MOTODEV Studio for Android (for instance, C:\Program Files\Motorola\MOTODEV Studio for Android 1.1\OPhoneSDK_1.5).

    IMPORTANT: So that you can properly view the OPhone SDK licenses, your computer must be able to display Chinese characters.

    NOTE: Within MOTODEV Studio the OPhone SDK presents a target named "Android 1.5" with a vendor of "Android Open Source Project".

  3. If you have installed multiple SDKs, MOTODEV Studio for Android asks you to choose one; MOTODEV Studio will be configured to use that SDK. To use one of the SDKs downloaded and installed into the MOTODEV Studio for Android directory, select Installed within MOTODEV Studio for Android and choose the appropriate SDK. Otherwise, select From filesystem and indicate the location of the SDK within your filesystem.

    NOTE: The first time you select the JIL SDK you will be given the opportunity to install the JIL WDT, which is needed if you want to create JIL widgets. If you have an older version of the JIL WDT installed, a new version will be installed when you select the JIL SDK

  4. If you have elected to use an existing Google Android SDK, you may want to open the Android SDK and AVD Manager and check for updates to that SDK:

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

      IMPORTANT: When you are on a network that requires proxy authentication, the Android SDK and AVD 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.

    3. Ensure that Display updates only is selected. This limits the displayed list of components to those that are not currently installed.
    4. Select those components that you wish to install, and click Install Selected. The selected components are listed for purposes of verification.
    5. Click Install Accepted. The selected components are now installed.

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

Checking for Updates

MOTODEV Studio Updates

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

IMPORTANT: If your development computer runs Mac OS X and your hard drive is formatted with a case-sensitive file system, updating MOTODEV Studio corrupts config.ini — which causes MOTODEV Studio to stop working. To work around this problem, make a copy of config.ini before updating, and after updating replace the corrupted version with this copy.

  1. Select Check for Updates from the MOTODEV Studio Help 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. Navigate to the Install/Update > Available Software Sites preferences, select MOTODEV Studio for Android 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.
  2. In the Available Updates dialog, ensure that MOTODEV Studio for Android Feature is selected.
  3. Click Next.
    You are now presented with a list of the updates you have chosen for review.
  4. Click Next.
    The license associated with the update is now displayed.
  5. Review the license. 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 and AVD Manager to check for new and updated Android SDK components, as described in the Android documentation under Adding SDK Components.

Uninstalling

Microsoft Windows

  1. Click Start, and then select Programs > MOTODEV Studio > MOTODEV Studio for Android version > Uninstall MOTODEV Studio for Android version.
    The uninstall wizard appears.
  2. Click Uninstall.
    The uninstall process begins.
  3. When the uninstall is complete, click Finish to exit the uninstaller.

Mac OS X

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

Linux

  1. 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.
  2. Click Uninstall.
    The uninstall process begins.
  3. 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.

Back to Top
Was This Document Helpful?
Yes  No 

Additional Comments (Optional)



Submit

Share This Page

Bookmark and Share

Table of Contents