This guide will assume no prior knowledge of Eclipse or Android development. If I forget this in some step, just tell me and I'll fix it. The goal is that anyone who want to test their LÖVE game on Android should be able to follow this guide.
If another similar guide exists somewhere, please tell me about it.
Step 1: Install Eclipse
On Ubuntu, it's simply sudo apt-get install eclipse. On any other OS, head over to eclipse.org and download the latest version. The one called "Classic Eclipse" is recommended by google.
Step 2: Get the Android SDK
Just download it from http://developer.android.com/sdk/index.html
If you're on Windows, there's an installer that is recommended.
Step 3: Get the ADT plugin for Eclipse
Start up Eclipse. Go to "Help" -> "Install new Software"
Where it says "Work with:", click on the arrow facing down to see what sources you have. The ADT plugin has some dependencies so you have to make sure there's somewhere it can get those from. If you don't see anything that does this, click on "Add..." and pick a name ("Indigo"), and under "Location" type "http://download.eclipse.org/releases/indigo" (assuming the version of Eclipse you are using is Indigo).
Then add another one ("Add..."), called "ADT plugin" with the location "https://dl-ssl.google.com/android/eclipse/". Now, you should see "Developer Tools" below. Mark that, and make sure "Contact all update sites during install to find required software" is marked, and hit "Next". Follow the instructions.
Once installed, click on the button that looks like an Android sitting on a box with a white arrow on it (it's called "Opens the Android SDK Manager"). Download at least one Android version. At the time of writing, API 8 (Android 2.2) is necessary to have.
If you want an Android Emulator, find the button in Eclipse that looks like an Android inside of a Android phone (it's called "Opens the Android Virtual Device Manager") Create an Android emulator, based on the Android version chosen before. LÖVE games don't really work in the emulator so it's a bit pointless.
Step 4: Get the love-native-android source
Head over to https://github.com/hagish/love-native-android and download it. The button says "zip".
Start up Eclipse, and hit "File"->"New" -> "Android Project". Give it a name, "LoveNative", and choose "Create project from existing source". Choose the location of the love-native-android source. Click OK.
Step 5: Get and apply the NDK
Download the NDK from http://developer.android.com/sdk/ndk/index.html.
In Eclipe, right click on "LoveNative" and hit "Properties". Under "Builders", make sure there's one called "ndk-build". Mark it and hit "Edit". Make sure the "Location" looks at the file ndk-build inside the NDK (it probably doesn't). Also make sure the "Working Directory" looks at the folder "jni" inside your project. Hit "Ok".
Step 6: Build and run!
Right click on your project (LoveNative) and under Android Tools, choose Export Signed Application Package. Follow the instructions. Send the .apk file to your phone/tablet and test it!
Step 7: ???
Step 8: PROFIT!
Old version:
Code: Select all
[b]Step 1: Install Eclipse[/b]
On Ubuntu, it's simply sudo apt-get install eclipse. On any other OS, head over to eclipse.org and download the latest version. The one called "Classic Eclipse" is recommended by google.
[b]Step 2: Get the Android SDK[/b]
Just download it from http://developer.android.com/sdk/index.html
If you're on Windows, there's an installer that is recommended.
[b]Step 3: Get the ADT plugin for Eclipse[/b]
Start up Eclipse. Go to "Help" -> "Install new Software"
Where it says "Work with:", click on the arrow facing down to see what sources you have. The ADT plugin has some dependencies so you have to make sure there's somewhere it can get those from. If you don't see anything that does this, click on "Add..." and pick a name ("Indigo"), and under "Location" type "http://download.eclipse.org/releases/indigo" (assuming the version of Eclipse you are using is Indigo).
Then add another one ("Add..."), called "ADT plugin" with the location "https://dl-ssl.google.com/android/eclipse/". Now, you should see "Developer Tools" below. Mark that, and make sure "Contact all update sites during install to find required software" is marked, and hit "Next". Follow the instructions.
Once installed, click on the button that looks like an Android sitting on a box with a white arrow on it (it's called "Opens the Android SDK Manager"). Download an Android version, for example the latest (4.0.3 at the time of writing).
Find the button in Eclipse that looks like an Android inside of a Android phone (it's called "Opens the Android Virtual Device Manager") Create an Android emulator, based on the Android version chosen before.
[b]Step 4: Get the love-native-android source[/b]
Head over to https://github.com/hagish/love-native-android and download it. The button says "zip".
Start up Eclipse, and hit "File"->"New" -> "Android Project". Give it a name, "LoveNative", and choose "Create project from existing source". Choose the location of the love-native-android source. Click OK.
[b]Step 5: Change the source code to look for your .love file[/b]
Under "LoveNative" -> "jni", open "love.cpp". Look for these lines:
[code]
argv[1] = new char[strlen("/mnt/sdcard/love/iyfct")+1];
strcpy(argv[1], "/mnt/sdcard/love/iyfct");
In order to get your .love file in the emulator, I suggest opening up the Android web browser inside of the emulator and download a file manager, for example OI File Manager (just google it), as well as your .love, and use the file manager to place your .love where you want it. I suggest /mnt/sdcard/love/yourlovehere.love
Step 6: Get and apply the NDK
Download the NDK from http://developer.android.com/sdk/ndk/index.html.
In Eclipe, right click on "LoveNative" and hit "Properties". Under "Builders", make sure there's one called "ndk-build". Mark it and hit "Edit". Make sure the "Location" looks at the file ndk-build inside the NDK (it probably doesn't). Also make sure the "Working Directory" looks at the folder "jni" inside your project. Hit "Ok".
Step 7: Build and run!
First, we need to change a little thing: In the folder "jni", open "Android.mk". On line 731, it says "LOCALCFLAGS := ...". Add "-fexceptions" to those flags. Save and close.
Right click on your project (LoveNative) and under "Run as..." choose "Android Application". It takes a while to compile all the stuff.
Step 8: ???
The app dies when you try to run it.
Note: In order to get it to install, you may need to give the emulator more memory. The app is 6 MB installed. To do this, right click on the project, under "Run As..." hit "Run Configurations". In the tab "Target", mark your Android emulator, and under "Additional Emulator Command Line Options" write "-partition-size 512".
However, this doesn't really matter since love-native-android doesn't support the OpenGLES version used by the emulator. If you, however, sign the app as an apk and install it on an actual Android phone, it should work now.
Step 9: PROFIT!
[/code]
Sorry.
