How to compile and run the example code » History » Version 22
Distorted Admin, 06/03/2016 09:50 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 | 13 | Distorted Admin | ### Application Name: *Distorted Examples* |
12 | 4 | Distorted Admin | ### Company Domain: *distorted.org* |
13 | ### Package Name: click 'edit' and change the default to *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]] |