Project

General

Profile

How to compile and run the example code » History » Version 23

Distorted Admin, 06/08/2016 09:57 AM

1 1 Distorted Admin
h1. How to compile and run the example code
2
3 22 Distorted Admin
This tutorial explains how to turn the 'library' and 'examples' code into an application you can run on your Android phone.
4 10 Distorted Admin
5 1 Distorted Admin
We are going to assume you are fairly familiar with Android development.
6 20 Distorted Admin
I personally use Android Studio; you can use Eclipse or even command line for your development but setting up the project will be different.
7 16 Distorted Admin
8 3 Distorted Admin
# Download and install *Android Studio*: https://developer.android.com/studio/index.html
9
# Start it up and click on *Menu->File->New->New Project* to create a new, empty Project.
10 5 Distorted Admin
## In the *'New Project'* window set:
11 23 Distorted Admin
### Application Name: *Examples*
12 4 Distorted Admin
### Company Domain: *distorted.org*
13 23 Distorted Admin
### Accept 'Package Name' to be *org.distorted.examples*
14 1 Distorted Admin
## In the *'Target Android Devices'* window, make sure *Phone and Tablet* is checked. Everything else can be unchecked.
15 4 Distorted Admin
## In the *'Add an Activity to Mobile'* select *Add No Activity*.
16 1 Distorted Admin
## Click *Finish* and an empty project will be created for you.
17 16 Distorted Admin
18 2 Distorted Admin
Now we will need to download the sources and add both *'library'* and *'examples'* as new modules to the empty Project we've just created.
19 12 Distorted Admin
At the time I am writing this, *Android Studio 2.1.1* does not seem to support adding new modules directly from a Git repository; that's why we will have to do this in two steps.
20 2 Distorted Admin
21
# Download (git clone) the sources to a local directory:
22 5 Distorted Admin
## *Menu->VCS->Checkout from Version Control->Git*
23
## In the *'Clone Repository'* window, set *'Git Repository URL'* to *'http://distorted.org/git/distorted-library.git'*; you can leave the *'Parent Directory'* and *'Directory Name'* as they are.
24 2 Distorted Admin
## It will ask you if you want to open the new project file - don't do it.
25 5 Distorted Admin
## Repeat the above two steps again, this time setting the Git URL to *'http://distorted.org/git/distorted-examples.git'*
26 2 Distorted Admin
# Add the two newly created directories as modules to your Project:
27 5 Distorted Admin
## *Menu->File->New->Import Module...*
28
## Set source directory to wherever the cloned *'distorted-library'* is and click *'Finish'*.
29
## At this moment it may complain about missing Android SDK platforms and prompt you to *'Add root'* of the new VCS. Do both. Once you do it, you should see a new module called *'distorted-library'* in your Project's module list, right next to the automatically created *'app'* module.
30
## Repeat the above, this time giving it the location where *'distorted-examples'* got downloaded to. New module *'distorted-examples'* will appear.
31
## Now you can (and should!) remove the empty *'app'* module: 
32
### *Menu->File->Project Structure...*
33
### Click on the *'app'* module in the left
34
### Click on the *red minus sign* to remove it
35 1 Distorted Admin
### Go to your Project directory and remove the *'app'* directory from it.  
36 13 Distorted Admin
37
Now we should have the Project ready and Gradle successfully building it. Let's now try and run it then. 
38
39
Because the Library uses *Open GL ES 2.1*, which is - at the time I am writing this - not supported on the Emulators, the only way is to test it on a real phone. 
40
41
# Connect your phone to your computer via a USB cable. It needs to support OpenGL ES 2.1 - any fairly recent Android phone should.
42
# Make sure it is in Developer mode and USB Debugging is on.
43
# *Menu->Run->Run 'distorted-examples'*
44
# In the *'Select Deployment Target'* window select your phone and click *'Ok'*
45
# The *'Distorted Examples'* app will get installed on your phone. 
46
47 14 Distorted Admin
Next: [[About the Distorted Examples App]]