Project

General

Profile

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

Distorted Admin, 06/02/2016 01:38 PM

1 1 Distorted Admin
h1. How to compile and run the example code
2
3
This tutorial explains how to turn the 'library' and 'examples' code into an application you can run on your Android phone.
4
5
We are going to assume you are fairly familiar with Android development.
6
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
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 3 Distorted Admin
### Application Name: *Distorted Android*
12 4 Distorted Admin
### Company Domain: *distorted.org*
13
### Package Name: click 'edit' and change the default to *org.distorted.examples*
14 5 Distorted Admin
## In the *'Target Android Devices'* window, make sure *Phone and Tablet* is checked. Everything else can be unchecked.
15
## In the *'Add an Activity to Mobile'* select *Add No Activity*.
16 4 Distorted Admin
## Click *Finish* and an empty project will be created for you.
17 2 Distorted Admin
18 5 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 2 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
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
### Go to your Project directory and remove the *'app'* directory from it.