In Part One of Starting Android Development, we discussed setting up your project in Eclipse.  Now it’s time to explain exactly what’s going on and how Android development works.  This information will help you keep things in perspective as you program, and it will help you when it comes to debugging time.

Let’s take a look at the Eclipse screen after you’ve set up a given project:

For the purposes of this explanation, let’s look at the directories in the left pane of the Eclipse screen.  Under the name of the project you’ve just created, you should see several subfolders.  Let’s explain what they do:

• src: This holds the source code for your project.
  • com.droidweb.conversion: This is the package holding your source code.  Several packages can make up a single project.  This is especially true when you include others’ packages to provide some type of functionality for your program.  For example, in a conversion application I wrote (ConvertAll+), I imported a package to handle different currencies.
    • convert.java: Inside the package are individual .java files.  This is where the goodies (the source code itself) are.
• gen: This is a folder for automatically generated stuff Android uses to help your program operate properly.  There’s nothing in here that you need to mess with.  It will automatically update itself as necessary.  Sometimes when you import projects and they return errors, the solution is to delete this folder and let Eclipse regenerate it for you . . . but more about that later.
  • com.droidweb.conversion: This is the package holding automatically generated code corresponding to the package of the same name in the /src/ folder.
    • R.java: R.java is an automatically created and maintained file that keeps up with the resources your project utilizes.  In a lot of your Android programming, you’re going to use static variables that really translate into numerical (usual hex) values.  R.java makes the translation between these variables and their numerical values.
• Android 1.5 (or appropriate Android source version): This contains the actual Android source code on top of which you’re going to build your applications.  As such, I’m not really going to discuss this much.
• assets:  Why, this is what you set your — oh wait — wrong thing. . . . Usually you won’t mess with this folder, but if you have raw files to be read by your application, then they can be put here; but it’s probably better that it goes in the /res/raw folder.  More about that later.
• res: res stands for resources.  Here is where you put your resources (images, files, etc).
  • drawable: This is where the images you’re going to use go.  Android supports a variety of image files, including .jpg, .gif (static), png, etc.
  • layout: This is where the .xml files describing your program layouts go.  I’ll spend a post on those later.
  • values: This is where .xml files defining values can be stored.  An example is a network topography program I worked on.  In the custom view drawing routine, I predefined the colors of good / bad links in a .xml file in the /srv/values folder.
• AndroidManifest.xml: This is the file that will be the source of the most headaches for you (well, starting out it will be . . .).  This is where your project is described in a form that Android devices can understand.  Application permissions, activity descriptions, and more are found here.  This file itself will be the topic of a future post onto itself — yes, it’s that important.

Next time we’ll discuss program flow in a typical Android program.

Want to get root access on your Motorola Droid device?  Then you’re in luck, thanks to an exploit on Android 2.0 and 2.01.

The first 8 steps below apply the Android 2.0.1 update to your Droid device.  This applies a number of bug fixes, including:

• Smooth Scrolling
• Better battery life
• Auto-focus will now work all the time

Note: Droidweb.com takes no responsibility for any damage done to your phone as a result of following these directions.  If something goes wrong, try one of the following forums:

• http://forum.xda-developers.com/showthread.php?t=597175
• http://alldroid.org/viewtopic.php?f=210&t=567

I have not tried this hack personally yet, but I do know of successful attempts to root the Droid.  Post any problems in one of the forums above or in the comments section below.

1. If you want the 2.0.1 update (I have no idea why you wouldn’t), update your phone to Android 2.0.1.  If your phone is already running 2.0.1, then skip to step 8.
2. Download the following file: http://alldroid.org/download/file.php?id=646
3. Rename the download update.zip
4. Copy update.zip to the root directory of the SDcard of your phone
5. Reboot your phone to recovery mode by holding down x while the phone turns on. Once you see the /!\ emblem, press the Volume Up and Camera buttons at the same time.
6. Select “Install update.zip”
7. Reboot your phone once process completes.
8. Download the following file: http://alldroid.org/download/file.php?id=659
9. Rename the download update.zip
10. Copy update.zip to the root directory of the phone’s SD card
11. Reboot your phone to recovery mode by holding down x while the phone turns on. Once you see the /!\ emblem, press the Volume Up and Camera buttons at the same time.
12. Install update.zip
13. Reboot your phone.

Thanks to Zinx Verituse at on Alldroid.org for these instructions.

One of the most popular categories of download for the Android platform is games. This is justly so; if there is one thing I crave for on my phone in my spare time is games. The IPhone has its share of professional games available for the platform, why can’t Android? Until now there have been good games for Android, but no good 3-D experiences. This is about to change.  Here are some of the developments recently with Android and 3-D gaming.

• Developers at Bendroid have been hard at work producing exciting 3-D games for Android. So far they have produced the acclaimed Mystique game. Released serially (Like old novels used to be), this horror game showcases the potential Android has, specifically with OpenGL. Chapter 1: Foetus is free and I highly recommend you check it out.



• Toronto based OmniGSoft.com works on bringing graphically intensive applications anywhere, including to the GPhone.  They’ve released several games for the platform including Nine Hole Golf, Volcano Island, Super-G Stunt, Snow Rally Canada and Snow Rally City Stage.
• Programmers are working on porting Quake to the Android phone.  Android and Me is holding a contest to complete the port.  Currently the prize is up to $261.  Check it out here.

Hopefully development will continue on 3-D multiplayer games for Android, keeping this platform competitive in the grand scheme of things.  What type of games / applications would you like to see on Android?