How to compile and run the example code » History » Version 2
Distorted Admin, 06/02/2016 01:32 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 | # Download and install Android Studio: https://developer.android.com/studio/index.html |
||
9 | 2 | Distorted Admin | # Start it up and click on Menu->File->New->New Project to create a new, empty Project. |
10 | 1 | Distorted Admin | ## In the 'New Project' window set: |
11 | ### Application Name: Distorted Android |
||
12 | ### Company Domain: distorted.org |
||
13 | ### Package Name: click 'edit' and change the default to 'org.distorted.examples' |
||
14 | ## 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 | ## Click 'Finish' and an empty project will be created for you. |
||
17 | 2 | Distorted Admin | |
18 | 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 | 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 | ## 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 | ## It will ask you if you want to open the new project file - don't do it. |
||
25 | ## Repeat the above two steps again, this time setting the Git URL to 'http://distorted.org/git/distorted-examples.git' |
||
26 | # Add the two newly created directories as modules to your Project: |
||
27 | ## 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 remote the 'app' directory from it. |