NOTE: This blog post was originally hosted on Motorola's MOTODEV web site. That site was decommissioned in 2012. I've made every attempt to preserve blog posts and accompanying forum posts with their original content. Many web links are no longer valid, so they have been removed and replaced with emphasized text.
by Eric Cloninger (EricC)
We hope 2010 has been a very good year for you. 2011 certainly looks to be very interesting for Android developers and we're excited to be bringing you new tools.
Google released the Gingerbread SDK on Dec. 6 along with a new set of Eclipse plugins (ADT). We've been working to release a MOTODEV Studio update that will work with that combination. The testing took longer than we thought because ADT must be updated at the same time as the SDK. In previous releases, some combinations of ADT and SDK would work, but not this time. You must use ADT 8.0 (or later) with the Gingerbread SDK. That is the only allowed combination.
Normally, we would dedicate a full release cycle to getting this much functionality out to users, but we know that everyone is excited to start developing with Gingerbread. So, please read this post carefully and let it help guide you to the new tools.
There are several version numbers that you need to be aware of.
SDK Tools: These are the compiler, post-linker, and debug support tools that get released at The Android Developer site. These are usually labeled r<X, where X is an integer. The tools are often released at the same time as a platform SDK, but not always. The current release of tools, released with Gingerbread, is r8.
ADT: Previously, the Google ADT plugins for Eclipse had version numbers such as 0.94, 0.98, etc. With this release, Google is versioning the plugins the same as the tools release. So the new versions of ADT will have numbers of 8.0, 8.0.1, 9.0 etc. The current official version of ADT is 8.0.1. This is what you should be using for your development. There is an expirmental version of ADT 9.0 available, but we have not yet tested it for use with MOTODEV Studio.
Platform SDK: This package contains the libraries used by the version of the OS that your are targeting. The Gingerbread platform version is 2.3, Froyo is 2.2, etc. You can have multiple versions of the platform inside your SDK installation and you can have different apps targeting different versions of the platform using the same version of the tools. This is by design and that's a Good Thing.
MOTODEV Studio: MOTODEV Studio 2.0.0 uses ADT 0.99 and SDK tools r7 to build apps for Froyo (Platform 2.2) and earlier. MOTODEV Studio 2.0.1 is the subject of this release and it uses ADT 8.0.1 and SDK tools r8 to build apps for Gingerbread (Platform 2.3) and earlier. MOTODEV Studio 2.1 is in development and should be released in January 2011.
For this update, I'm going to advise that you use the Google SDK download tool. Install the SDK tools and platforms in a separate location from your existing SDK and tools. Keep the Froyo SDK and tools around until you are certain that the Gingerbread tools are working. Especially if you have AVDs (emulator images) with a lot of effort in them. You can get the SDK download tool from the Android developer site .
We didn't find any problems with workspaces. But, it's never a bad practice to back up your code and workspace periodically.
If you aren't taking advantage of specific functionality in Gingerbread, you can hold off with this release until MOTODEV Studio 2.1 is available next month. There are a lot of changes taking place with the SDK and platform tools and these will all get integrated into MOTODEV Studio 2.1 as a single package.
The easiest way to get MOTODEV Studio 2.0.1 is to just download the full 2.0.1 installer from the MOTODEV Studio page . Just uninstall version 2.0.0 and reinstall version 2.0.1. After the download is completed, this takes about 5 minutes. After which you will be up to your elbows in Gingerbread.
You can update MOTODEV Studio to version 2.0.1 using the online updater. It's easy to invoke, just choose Check for Updates from the Help menu and follow the instructions.
This is where our testing problems occur--mostly due to network timeouts. Because updates are coming from 3 different sources (Motorola, Google, and Eclipse.org), the problems could be at any of these places or any place between your computer and those sites. The network problems have been sporadic and we don't have a conclusive thing to point at as the source of all the problems.
Minimally, this process will take about 10 minutes. Even on a good network connection.
If you get errors with the update mechanism, the workaround that we were able to isolate was:
Download and install the full install package mentioned above in The Big Easy.
If this still does not work for you, go back to the Available Software Sites and choose each of the HTTPS connections and press the Reload button.
If you want to avoid possible network problems with the update site, then you can choose to update MOTODEV Studio using a single archive file. This archive is 125MB and can be found on the download site (under Eclipse Plug-in Version; ignore the bit about Requires an existing Eclipse environment). Locate the link for Eclipse Helios and download the file to your computer.
To install the 2.0.1 update from this file:
At this point, you will need to switch the SDK from R7 (Froyo) to R8 (Gingerbread). Both MOTODEV Studio and the Google plugins recognize this is a problem and will put up dialog boxes. Using the MOTODEV Studio dialog, locate the new SDK and choose it. Dismiss both dialogs with OK.
After a few seconds, you should be in MOTODEV Studio 2.0.1. To verify that everything worked, simply choose Help->About MOTODEV Studio for Android. The about box should clearly show the version number.
You're done! Now, get out there and write some awesome apps!
If the updates still do not work, please choose Help->Collect Log Files. Then, let us know on the MOTODEV Studio Discussion Boards .
Thank you for using MOTODEV Studio.