How to compile and run the example code » History » Version 10
Distorted Admin, 06/02/2016 01:41 PM
1 | 1 | Distorted Admin | h1. How to compile and run the example code |
---|---|---|---|
2 | |||
3 | 10 | Distorted Admin | This tutorial explains how to turn the 'library' and 'examples' code into an application you can run on your Android phone. |
4 | |||
5 | 9 | Distorted Admin | 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 | 1 | Distorted Admin | |
8 | 10 | Distorted Admin | <pre> |
9 | 3 | Distorted Admin | # Download and install *Android Studio*: https://developer.android.com/studio/index.html |
10 | # Start it up and click on *Menu->File->New->New Project* to create a new, empty Project. |
||
11 | 5 | Distorted Admin | ## In the *'New Project'* window set: |
12 | 3 | Distorted Admin | ### Application Name: *Distorted Android* |
13 | 4 | Distorted Admin | ### Company Domain: *distorted.org* |
14 | ### Package Name: click 'edit' and change the default to *org.distorted.examples* |
||
15 | 5 | Distorted Admin | ## In the *'Target Android Devices'* window, make sure *Phone and Tablet* is checked. Everything else can be unchecked. |
16 | 4 | Distorted Admin | ## In the *'Add an Activity to Mobile'* select *Add No Activity*. |
17 | 1 | Distorted Admin | ## Click *Finish* and an empty project will be created for you. |
18 | 10 | Distorted Admin | </pre> |
19 | 5 | Distorted Admin | |
20 | 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. |
21 | 6 | 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. |
22 | 2 | Distorted Admin | |
23 | # Download (git clone) the sources to a local directory: |
||
24 | 5 | Distorted Admin | ## *Menu->VCS->Checkout from Version Control->Git* |
25 | ## 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. |
||
26 | 2 | Distorted Admin | ## It will ask you if you want to open the new project file - don't do it. |
27 | 5 | Distorted Admin | ## Repeat the above two steps again, this time setting the Git URL to *'http://distorted.org/git/distorted-examples.git'* |
28 | 2 | Distorted Admin | # Add the two newly created directories as modules to your Project: |
29 | 5 | Distorted Admin | ## *Menu->File->New->Import Module...* |
30 | ## Set source directory to wherever the cloned *'distorted-library'* is and click *'Finish'*. |
||
31 | ## 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. |
||
32 | ## Repeat the above, this time giving it the location where *'distorted-examples'* got downloaded to. New module *'distorted-examples'* will appear. |
||
33 | ## Now you can (and should!) remove the empty *'app'* module: |
||
34 | ### *Menu->File->Project Structure...* |
||
35 | ### Click on the *'app'* module in the left |
||
36 | ### Click on the *red minus sign* to remove it |
||
37 | ### Go to your Project directory and remove the *'app'* directory from it. |