Subversion Repositories AndroidProjects

-- libgdx --
Hi there, you seem to have downloaded libgdx so let me explain to you how to setup your projects. 
The following assumes that you are going the proper libgdx way, that is developing your app on the 
Desktop and then painlessly droping it on your Android device without any further code modifications. 
We go through this step by step.

1) Setting up the desktop Java project
Open Eclipse and create a new Java project called gdx-helloworld. Within the project create a new 
folder called "libs/" and drop files of this zip file into it. In the package explorer you should then 
have something like this:

gdx-helloworld
 -> src/
 -> JRE System Library
 -> libs/
    -> armeabi/
       - >libandroidgl20.so
       - >libgdx.so
        -> armeabi-v7a/
           - >libandroidgl20.so
           - >libgdx.so
        -> docs/
           - > index.html and other files containing the Java Doc.
    -> gdx.jar
    -> gdx-backend-android.jar
    -> gdx-backend-jogl.jar
    -> gdx-backend-jogl-natives.jar
    -> gdx-backend-lwjgl.jar
    -> gdx-backend-lwjgl-natives.jar
    -> gdx-natives.jar
    -> gdx-twl.jar
    -> gdx-sources.jar          
    -> README
    
Next right click on the the gdx-helloworld project in the package explorer and select properties. Select 
"Java Build Path" to the left in the new dialog and then click the Libraries tab. In the libraries tab 
click "Add Jars", browse to the gdx-helloworld/libs folder and select gdx.jar, gdx-natives.jar, 
gdx-backend-jogl.jar, and gdx-backend-jogl-natives.jar Now you have added all that's needed for the Java 
desktop project to compile. 

Create a new package in the "src/" folder of the gdx-helloworld project, say "com.badlogic.helloworld" 
and create a new class called "HelloWorld" in this package. Here's the source to put into this class:

=========== CODE ===========
package com.badlogic.helloworld;
import com.badlogic.gdx.ApplicationListener;

public class HelloWorld implements ApplicationListener 
{
        @Override
        public void resume() {
                
        }
        
        @Override
        public void resize(int width, int height) {
                
        }
        
        @Override
        public void render() {
        
        }
        
        @Override
        public void pause() {
                
        }
        
        @Override
        public void dispose() {
                
        }
        
        @Override
        public void create() {
        
        }
}
=========== CODE ===========

Next we need to create a start class that will actually execute the above application on the desktop. Create
a new Java class in the same package called "HelloWorldDesktop": 
=========== CODE ===========
package com.badlogic.helloworld;
import com.badlogic.gdx.backends.jogl.JoglApplication;

public class HelloWorldDesktop {
        public static void main(String[] argv) {
                new JoglApplication(new HelloWorld(), "Hello World", 480, 320, false);
        }
}

Simply start the app by right clicking on the project and selecting Run as.. -> Java Application. You will have
to select the HelloWorldDesktop class from the dialog that pops up.  

2) Setting up the Android project
Now we want the above HelloWorld class to run on Android. For this we create a new Android project
and call it let's say gdx-helloworld-android. Specify Android 1.5 as the target platform. Specify 3
as the minimum SDK version. As an activity name chose for example HelloWorldAndroid. As a package name
use "com.badlogic.helloworld".

In the manifset file make sure you have this:

<uses-sdk minSdkVersion="3" targetSdkVersion="8"/>

This will ensure that you can run on all Android versions to date (1.5 - 2.2). 
 
Also copy over the contents of this zip file to a folder called "libs/" in your Android project. Note that you
only need to copy a subset of the files! Here's how your android project should look like now:

gdx-helloworld-android
 -> src/
    -> com.badlogic.helloworld/
       -> HelloWorldAndroid.java
 -> gen/
 -> Android 1.5
 -> assets/
 -> libs/
    -> armeabi/
       -> libandroidgl20.so
       -> libgdx.so
        -> armeabi-v7a/
           - >libandroidgl20.so
           - >libgdx.so    
    -> gdx.jar
    -> gdx-backend-android.jar        
 -> res/
 -> AndroidManifset.xml
 -> default.properties
 
 Go to the properties of the Android project and select "Java Build Path" again. Add the gdx-helloworld 
project in the project tab and the gdx.jar and gdx-backend-android.jar in the Libraries tab. You don't have to 
add the gdx-backend-jogl.jar or gdx-backend-jogl-natives.jar jars as those are only needed for the desktop 
Java version. 

Now open the HelloWorldAndroid.java file and paste the following code in:

=========== CODE ===========
package com.badlogic.helloworld;

import android.os.Bundle;
import com.badlogic.gdx.backends.android.AndroidApplication;
import com.badlogic.gdx.helloworld.HelloWorld;

public class GDXHelloWorld extends AndroidApplication
{       
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        initialize(new HelloWorld(), false);        
    }
}
=========== CODE ===========  
 
Now we are almost ready to start the thing on the device. Open the AndroidManifest.xml and add 

android:configChanges="keyboard|keyboardHidden|orientation"

to the <activity> tag. Your manifest should look something like this then:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="com.badlogic.helloworld"
      android:versionCode="1"
      android:versionName="1.0">
    <application android:icon="@drawable/icon" android:label="@string/app_name">
        <activity android:name=".HelloWorldAndroid"
                  android:label="@string/app_name"
                  android:configChanges="keyboard|keyboardHidden|orientation">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

    </application>
    <uses-sdk android:minSdkVersion="3" android:targetSdkVersion="8"/>

</manifest> 

Now you can start the Activity as you do with any normal android application in eclipse. Et voila, profit!

You never have to change the android project again unless you add assets. The rest is done in the Java project.
Just verify that it works on the device every now and then starting the Activity of the android project.

You can download both demo projects completely setup (minus the run configurations) at:
http://libgdx.googlecode.com/files/gdx-helloworld.zip

Have fun!