Magic Lantern Developer Wiki
Build Cross-platform Applications
Status: Beta
Brought to you by:
wizzerworks
Menu
▾
▴
SDK_Build_Environment_for_Android_Platform
There is a newer version of this page. You can find it here.
SDK Build Environment for Android Platform
This page discusses how to build the Magic Lantern SDK for Android platforms using Android Studio.
Note: This technique is currently under development and extremely volatile.
- SDK Build Environment for Android Platform
- Dependencies
- Assumptions
- Download Source
- Build Core Math utility library
- Build Core Runtime Engine library
- Build Application Framework Base library
- Build Application Framework Media Reference library
- Build Application Framework Roles library
- Build Application Framework Props library
- Build Application Framework Stages library
- Build Application Framework Sets library
- Build Application Framework Actors library
- Image Test Application
Dependencies
This section identifies dependencies for building the Magic Lantern SDK.
- Google's Android Studio, version 2.1.2 (see [Android Studio Installation] for more details).
- Oracle Java Development Kit (JDK), version 1.8.0_91 Required by Android Studio (download from http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html).
Assumptions
These instructions assume the following:
- The dependencies above are installed in their default locations.
- You already know how to use the Android Studio IDE
Download Source
The source for the Android Studio projects are currently located on Github under the Magic Lantern Studio organization (https://github.com/magic-lantern-android-studio).
Create a Project Directory
In a console window, create a project directory:
$ mkdir ~/MagicLantern
Retrieve Source Using Git
In a console window, clone the git repositories from Github:
$ cd ~/MagicLantern
$ git clone https://github.com/magic-lantern-android-studio/core-math.git
$ git clone https://github.com/magic-lantern-android-studio/core-runtime.git
$ git clone https://github.com/magic-lantern-android-studio/parts-base.git
$ git clone https://github.com/magic-lantern-android-studio/parts-actors.git
$ git clone https://github.com/magic-lantern-android-studio/parts-roles.git
$ git clone https://github.com/magic-lantern-android-studio/parts-sets.git
$ git clone https://github.com/magic-lantern-android-studio/parts-stages.git
$ git clone https://github.com/magic-lantern-android-studio/parts-mrefs.git
$ git clone https://github.com/magic-lantern-android-studio/parts-props.git
$ git clone https://github.com/magic-lantern-android-studio/titles-imagetest.git
$ git clone https://github.com/magic-lantern-android-studio/mle-tools.git
You should now have eleven Android Studio projects located in
| Project | Description |
|---|---|
| ~/MagicLantern/core-math | Magic Lantern Math utility library |
| ~/MagicLantern/core-runtime | Magic Lantern Runtime Engine library |
| ~/MagicLantern/parts-base | Magic Lantern Parts support library |
| ~/MagicLantern/parts-actors | Magic Lantern Actors library |
| ~/MagicLantern/parts-roles | Magic Lantern Roles library |
| ~/MagicLantern/parts-sets | Magic Lantern Sets library |
| ~/MagicLantern/parts-stages | Magic Lantern Stages library |
| ~/MagicLantern/parts-mrefs | Magic Lantern Media Reference library |
| ~/MagicLantern/parts-props | Magic Lantern Properties library |
| ~/MagicLantern/titles-imagetest | Magic Lantern Image Test application |
| ~/MagicLantern/mle-tools | Magic Lantern Tools |
Retrieve source using repo
Alternatively, you can use the "repo" tool from Google (see [repo Installation Instructions]) to download the source.
$ cd ~/MagicLantern
$ repo init -u https://github.com/magic-lantern-android-studio/mle-tools.git
$ repo sync
Build Core Math utility library
To build the Magic Lantern Core Math library, mlmath.jar, open the existing Android Studio project found at "~/MagicLantern/core-math". In the Android Studio launch screen, select "Open an existing Android Studio project". In the "Open File or Project" dialog panel, navigate to "~/MagicLantern/core-math" directory and select "OK". This will bring up the main Android Studio IDE, showing the "core-math" project in the "Project" window (you may need to expand this Window to see the project. By default, the project should successfully build.
Note: You may need to install the build tools and sync the project before the build is successful. The "Messages Gradle Sync" window will display an Error if this is the case.
