{"id":485,"date":"2011-07-03T12:40:00","date_gmt":"2011-07-03T12:40:00","guid":{"rendered":"http:\/\/www.javacodegeeks.com\/2012\/10\/android-game-development-create-the-project.html"},"modified":"2012-10-21T20:02:42","modified_gmt":"2012-10-21T20:02:42","slug":"android-game-development-create-project","status":"publish","type":"post","link":"https:\/\/www.javacodegeeks.com\/2011\/07\/android-game-development-create-project.html","title":{"rendered":"Android Game Development – Create The Project"},"content":{"rendered":"
Now that we have our idea<\/a> let\u2019s get the environment up and start coding.<\/p>\n

To install Android follow the steps found on the official documentation<\/a> page. I use eclipse so if you are a Java guy it should be pretty familiar. If you have never developed in Java but did some other coding in C++ or C# for example it should be pretty simple to catch up. I would recommend starting with some Java tutorials and then switch to Android. If you haven\u2019t programmed before\u2026well that\u2019s though but it\u2019s solvable. Google for some programming tutorials and don\u2019t get discouraged! Then check back here.<\/p>\n

I will use Android 2.2 as it is the latest at the time of this writing and I suspect it will take a long time till I finish this project so it just might be quite used. Also because we plan to use multi-touch we need version 2.x.<\/p>\n

First let\u2019s create the AVD (Android Virtual Device). Click on the little Android icon or choose Window -> Android SDK and AVD Manager and click on the New\u2026 button.<\/p>\n

Set the name to MyDevice, the target to Android 2.2 \u2013 API Level 8. Set 128 MiB for the SD Card. Set the Skin to Built-in HVGA and the Hardware to Abstracted LCD density to 160. These are the current default settings.<\/p>\n

<\/a><\/div>\n

Click Create AVD and the virtual device should be created.<\/p>\n

Now let\u2019s create the project.<\/p>\n

Select from the menu: New -> Project and choose Android Project.<\/p>\n

Fill in as per the screen-shot and click Finish.<\/p>\n

The Application name is the name given to our game. The package name is just the name space to group our classes.<\/p>\n

Select Android 2.2 for Build Target.<\/p>\n

The most important is the Create Activity. The Activity is the class instantiated when the application is started. Don\u2019t have to worry about it right now just remember that is the first thing being called.<\/p>\n

<\/a><\/div>\n

In a nutshell the Activity<\/strong> handles our input (gets the touches on the screen), creates the window where we will display our game and so on. This usually is a full screen window and we will use one as such.<\/p>\n

Let\u2019s run the created application. Right click on the project and choose Run As -> Android Application. Choose the configured device and wait for it to load. Remember not to close the Virtual Device once it has started as every time you will run your project, eclipse will redeploy it to the currently running device and will save you a lot of time if it\u2019s already started.<\/p>\n

You should see a screen like the one below. If the device asks you to unlock the screen do it by dragging the unlock button with your mouse.<\/p>\n

<\/a><\/div>\n

Now let\u2019s examine what has just happened. Open the DroidzActivity.java<\/i><\/strong> file.

<\/div> <\/div><\/p>\n
package net.obviam.droidz;\r\n\r\nimport android.app.Activity;\r\nimport android.os.Bundle;\r\n\r\npublic class DroidzActivity extends Activity {\r\n    \/** Called when the activity is first created. *\/\r\n    @Override\r\n    public void onCreate(Bundle savedInstanceState) {\r\n        super.onCreate(savedInstanceState);\r\n        setContentView(R.layout.main);\r\n    }\r\n}\r\n<\/pre>\n
You\u2019ll notice one method. The onCreate()<\/strong> method on line 09. This method is called when the activity is being created at the application launch. It\u2019s sets the view (the display) to be the default R (check R.java) which is the default resource view automatically generated by the android tools behind the scenes.<\/p>\n
This file feeds on multiple configuration files to provide the activity with the view. It reads the main.xml from the res (which stands for resources) directory and parses it.<\/p>\n
Let\u2019s open the res\/layout\/main.xml<\/i><\/strong> file:<\/p>\n
<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n<LinearLayout xmlns:android=\"http:\/\/schemas.android.com\/apk\/res\/android\"\r\n    android:orientation=\"vertical\"\r\n    android:layout_width=\"fill_parent\"\r\n    android:layout_height=\"fill_parent\"\r\n    >\r\n<TextView\r\n    android:layout_width=\"fill_parent\"\r\n    android:layout_height=\"wrap_content\"\r\n    android:text=\"@string\/hello\"\r\n    \/>\r\n<\/LinearLayout>\r\n<\/pre>\n
You\u2019ll notice that a LinearLayout is used that fills up the whole screen and has a vertical positioning (Line 2). Line 3 tells that our orientation is horizontal while lines 4 and 5 instruct android to use the whole display (currently the parent is the display) for the view.<\/p>\n
Line 7 defines a TextView which is just a label that takes up a whole line of the contained text\u2019s height. The value is a placeholder read from the @string file. @string is also a placeholder for the strings.xml file and opening this file you\u2019ll immediately notice that this is the place where the actually displayed value comes from. Worth noting that the R.java file is regenerated after we modify strigs.xml and for each resource entry a corresponding constant is generated and it will be used internally.<\/p>\n
Open the \/res\/values\/strings.xml<\/i><\/strong> file:<\/p>\n
<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n<resources>\r\n    <string name=\"hello\">Hello World, DroidzActivity!<\/string>\r\n    <string name=\"app_name\">droidz<\/string>\r\n    <string name=\"warning\">Robots are rising<\/string>\r\n<\/resources>\r\n<\/pre>\n
These are the resource strings. Apart from line 5 which I added everything is generated. To add the warning message to the display just after the hello message modify the main.xml file and add a new TextView that will display our @warning message.<\/p>\n
The new main.xml<\/i><\/strong> file looks like this:<\/p>\n
<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n<LinearLayout xmlns:android=\"http:\/\/schemas.android.com\/apk\/res\/android\"\r\n    android:orientation=\"vertical\"\r\n    android:layout_width=\"fill_parent\"\r\n    android:layout_height=\"fill_parent\"\r\n    >\r\n<TextView\r\n    android:layout_width=\"fill_parent\"\r\n    android:layout_height=\"wrap_content\"\r\n    android:text=\"@string\/hello\"\r\n    \/>\r\n<TextView\r\n    android:layout_width=\"fill_parent\"\r\n    android:layout_height=\"wrap_content\"\r\n    android:text=\"@string\/warning\"\r\n    \/>\r\n<\/LinearLayout>\r\n<\/pre>\n
If you run the activity then you should have a screen displaying the new warning message too.<\/p>\n
<\/a><\/div>\n
Worth noting that eclipse regenerated the R.java file and if you open it you will notice a similar line to this:<\/p>\n
public static final int warning=0x7f040002;\r\n<\/pre>\n
It is generated by the android tooling and it keeps the IDs and pointers to the actual resources that are used in the activity.<\/p>\n
Go ahead and play with the current setting and see what the options are for different display widgets.<\/p>\n
Next we will actually load some images and draw them onto the screen.<\/p>\n
Reference:<\/strong> Creating the Android Project<\/a> from our JCG<\/a> partner Tamas Jano from “Against The Grain<\/a>” blog.<\/p>\n
Do not forget to check out our new Android Game<\/i><\/strong> ArkDroid<\/a> (screenshots below)<\/span><\/span><\/i><\/strong>. You feedback will be more than helpful!<\/div>\n
<\/a><\/a><\/a><\/div>\n
Related Articles:<\/strong><\/div>\n