View source for Onelab/Mobile

= Mobile - Test the Beta =
== Android ==
Requirement:
* ''You need an Android device running Android >= 4.0''
<br />
Here is the step to install Onelab on your device:
# Download the file ([http://onelab.info/files/.Onelab.apk Onelab.apk])
# You have to allow installation of non-Market apps <br /> > Settings > Security > Unknown sources
# Then you can install the application <br />To do that, you can upload the file on your SD card and then use a [https://play.google.com/store/search?q=file%20explorer&c=apps file explorer] to open the file. <br />Or you can use Android SDK's tool named adb and install the file: <source lang="bash">adb install Onelab.apk</source>

== iOS (iPad, iPhone, ...)==
Requirement:
* ''You need an iOS device running iOS >= 6.0''
<br />
To install the application on your device, you need to send us your device ID. <br />
To know how to locate this ID you can check [https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html##//apple_ref/doc/uid/TP40012582-CH30-SW46 apple website]. <br />
Then we will add your device in the list of the device for Onelab beta, and you will be able to [https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/TestingYouriOSApp/TestingYouriOSApp.html#//apple_ref/doc/uid/TP40012582-CH8-SW6 install Onelab]. <br />

= How to add a model =
== Android ==
On Android, you can open .geo, .pro files from a [https://play.google.com/store/search?q=file%20explorer&c=apps file explorer].

== iOS ==
To add a model on iOS you can use [http://support.apple.com/kb/HT4094 File Sharing]. <br />
The model have to be in a directory with extension ".onelab". <br />
Example for magnet: <br />
<code>

 magnet.onelab/
    magnet.geo
    magnet.pro
    magnet_data.pro
    Magnetostatics.pro
    infos.xml
</code>
and the file "infos.xml" looks like:
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>

<models>
        <model>
                <title>Magnet</title>
                <summary>Simple magnet example.</summary>
                <file type="pro">magnet.pro</file>
        </model>
</models>
</source>

= Mobile - Build for iOS =
Requirement:
* ''You need to be on a Mac''
* ''You need to have xcode >= 4''
* ''You need to have the iOS SDK >= 6.0''
== Compile the framework for iOS simulator ==
To compile for the simulator, the framework have to be for i386 architecture
Example for Gmsh:
<source lang="bash">
mkdir buildIOSSimulator
cd buildIOSSimulator
cmake -DENABLE_LIB=1 -DDEFAULT=0 -DENABLE_BLAS_LAPACK=1 -DENABLE_MESH=1 -DENABLE_ONELAB=1 -DENABLE_POST=1 -DCMAKE_CXX_FLAGS='-m32' ../
make framework
</source>

== Compile the frameworks for iOS device ==
To compile for an iOS device you need a toolchain (e.g. [https://code.google.com/p/ios-cmake/ ios-cmake]).
<source lang="bash">
mkdir buildIOS
cd buildIOS
cmake -DDEFAULT=0 -DENABLE_LIB=1 -DENABLE_BLAS_LAPACK=1 -DENABLE_MESH=1 -DENABLE_ONELAB=1 -DENABLE_POST=1 -DCMAKE_TOOLCHAIN_FILE=/path/to/iOS.cmake -Gxcode ../
xcodebuild -target lib -configuration Release
</source>

== Create the project ==
To create the project you have to create a new directory and then, create the project with cmake
<source lang="bash">
mkdir iOSProject
cd iOSProject
cmake ../contrib/mobile/
make xcodeProject
</source>
Then you can use "open" command to open the project with xcode.
<source lang="bash">open Onelab/Onelab.xcodeproj</source>

= Mobile - Build for Android =
''This procedure has been tested only on a Linux distribution''
<br />
Requirement:
* ''You need to have Android SDK with a level >= 14''
* ''You also need Android NDK to compile libraries''
== Compile the libraries ==
Most of the Android powered device run on an ARMv7 architecture. <br />
Here is the way to compile Gmsh library for this architecture. <br />
To do this, you need a toolchain (e.g [http://code.google.com/p/android-cmake/ android-cmake])<br />
<source lang="bash">
mkdir buildAndroid
cd buildAndroid
cmake -DCMAKE_TOOLCHAIN_FILE=/path/to/android.toolchain.cmake -DDEFAULT=0 -DENABLE_LIB=1 -DENABLE_BLAS_LAPACK=1 -DENABLE_MESH=1 -DENABLE_ONELAB=1 -DENABLE_POST=1 ../
make androidGmsh
</source>

== Create the project ==
The project need multiples libraries:
* Gmsh
* GetDP
* ONELAB (see below)
* PETSc
* BLAS & LAPACK

The ONELAB library is a small library to interface the application (Java) with Gmsh (Native library).
You can build it from gmsh-svn (it's in /contrib/mobile/)

To use the automated cmake procedure you have to create a directory (e.g. Gmsh) with:
* The library with directory name and without any extension (e.g. Gmsh)
* The headers (they can be obtain with "''make getHeaders''")
The final directory for Gmsh looks like<br />
<code>

 Gmsh/
    Gmsh
    Headers/
        *.h
</code>

Then you can create the project:
<source lang="bash">
make androidProject
</source>
Then you can open the project with [https://developer.android.com/sdk/installing/bundle.html Eclipse] or with [https://developer.android.com/sdk/installing/studio.html Android Studio]
You can also compile using the command line:
<source lang="bash">
android update project --name Onelab --path . --target targetID
ant release
</source>