Welcome to the ZenBox wiki! Here you can find information about how to install and manage the necessary development software for ZenBox.

As ZenBox is an Android application (currently being built for Android 4.2), a proper development environment first needs to be set up.

For all platforms, you'll need to install both the Android SDK, and the Android NDK in order to work with both android software, and any native software in use with the application.

This wiki assumes you are using eclipse as your development environment, and that you have at least cloned the sources from github and are ready to use them in an eclipse project.

Make sure to download the SDK and the NDK. The SDK can be extracted wherever you deem necessary, but the NDK must be extracted such that the path leading to it has no spaces (this is for compatibility reasons).

Once the tools have been extracted, the eclipse IDE is bundled with the SDK. You can delete it if you already happen to have eclipse installed, however. After this, run "SDK Manager.exe" (which can be found inside the SDK's top level directory), check the "Tools," "Android 4.2" (there should be some API number next to it as well), and if you feel like it, check the "Extras" box as well. Then click the install packages button and make sure to select "accept all" (hitting accept will just accept one license). Then sit back and let all the tools install.

(there's nothing here yet, as the wiki writer doesn't own any apple products, and is too lazy to look it up at the moment).

Once the wiki writer stops being lazy, then there will be descriptions (and even links!) to other distros, like Ubuntu, Debian, Mint, Fedora, etc (but not Gentoo).

Given there has been no testing as of yet by the wiki writer, this arch wiki page should be sufficient for installing at least the SDK. More info on the NDK will be here soon!

Set up the project properly as per the OpenCV for android installation instructions. You don't necessarily need to have the projects open concurrently with the main ZenBox project, but you will need to make sure everything is set up properly (so that even the projects that require native support compile properly).

The instructions for how to setup the pure data library for android can be found here. Just follow the instructions documented in the readme at the bottom of the page.

This hasn't been filled in yet, as the project details aren't yet specified.

If the two above installations have gone smoothly, only minor adjustments will need to be made to the ZenBox project after it's been cloned from github.

First and foremost, make sure to clone the git repo:

git clone git://github.com/awdavies/ZenBox.git

Then make sure to open eclipse, and import the project from the root git directory you just cloned (it should be the only project that shows up).

The project.properties file will needed to be created manually. First go to the ZenBox directory, then go into the second ZenBox directory (there should be the directory 'src' in there somewhere). And create the file. The following line should be added first, and the rest of the settings will then be cleared up through the rest of the next few sections:

target=android-16

Afterwards, you'll need to link to the OpenCV library in the project properties; by default, this isn't linked as the OpenCV installation could be anywhere (given this particular implementation that doesn't include the OpenCV libraries). First, import the OpenCV library project (you won't need to include all of the OpenCV tutorial projects, so leave those out). Go to the Android menu after going to ZenBox's properties, and then go down the libraries section and hit "add." Select the OpenCV library and hit okay.

The pure data library for android can be downloaded here. Just follow the instructions for installation. Then, similar to the OpenCV setup, make sure to link the ZenBox project to the PdCore project within the Android tab when going to ZenBox's properties.