installation
Device requirements: Android 5.0+ / OpenGL ES 3.0+
IDE requirements: Android Studio 1.0.1 / build tools: 21.1.2
Android SDK requirements: v4 support and v7 appcompat both 21.0.3 (install by SDK manager)
These samples require the latest Android Studio developer setup. To install Android Studio please download it here
If you have an older version of Android Studio you might be best served simply reinstalling it.
This installation guide more or less has been quickly assembled and better details will be provided soon.
It is relatively important to follow the steps below as Android Studio while recently marked as "1.0" still has plenty of quirks. Order more or less matters for a smooth check out and build process to succeed.
Step 1: Create a directory to download both repos to (modern-java6-android-glframework & modern-java6-android-gldemos). Perhaps name it "ModernGLDemos".
Step 2: Open Android Studio 1.0.1
Step 3: Select "Check out project from Version Control" then select "Github" in the list.
Step 4: You may have to enter in a password for Android Studio (make one up and write it down):
Step 5: Enter in the "https" github URL for the modern-java6-android-glframework repo. The URL you need is:
https://github.com/typhonrt/modern-java6-android-glframework.git
Step 6: (no image) Hit "yes" to open the project.
Step 7: Verify that "Use default gradle wrapper (recommended)" is selected.
Step 8: Gradle will start chugging along, but this dialog may pop up asking you to restart Android Studio... Do not click on it as Gradle is still working in the background. You can click "no".
Step 9: Gradle will finish processing and compile the project and if you click the "project" tab on the upper left side the left pane window will open and you should see 5 modules. You can close this project now as it is just the GL framework code. Next you will check out the demos codebase essentially repeating step 3 - 9 with a different repo URL.
Step 10: Repeat checking out the modern-java6-android-gldemos repo essentially starting from "step 3" above, but use the following URL:
https://github.com/typhonrt/modern-java6-android-gldemos.git
Step 11: Select yes to open the project and essentially repeat step 6, 7, and you may see step 8 (don't reload the project) as Gradle is still chugging along. However what is different with the gldemos repo is that it references the glframework repo and you'll see quickly flashing in the upper right a green dialog mentioning an "unregistered VCS root detected" This is the glframework root which is referenced by gldemos. This is what the dialog looks like and you must quickly hit "Configure":
Step 12: You must hit the "add root" link which is notated in red and on the right. It may be hard to see since the dialog can't be resized easily.
Step 13: You'll see the VCS root added for the glframeworks repo which you just checked out.
Step 14: Almost there. Let Gradle finish and expand the "project" tab on the upper right. The top module "java6-android-gldemos" is the only module of the gldemos repo and the rest are references from the glframeworks repo. You can now connect an Android device and hit the "play" button seen in the upper right of this image:
If all has worked then you'll hopefully be compiling the source code and soon be deploying to a device. If you haven't enabled developer mode on your device yet follow this tutorial
Enjoy the demo code as there is more coming soon!
