Difference between revisions of "VES/Developers Guide"

From KitwarePublic
< VES
Jump to: navigation, search
Line 31: Line 31:
  
 
VES is normally built using a [http://www.kitware.com/products/html/BuildingExternalProjectsWithCMake2.8.html superbuild].  A superbuild manages the download, configure, build, and install steps of multiple projects all at once.  The VES superbuild will download [https://gitorious.org/kitware/vtkmodular vtkmodular], then configure and build both vtkmodular and VES using the appropriate cross compiler for the target architecture.  The target architecture may be an android device, iOS device, or the iOS simulator on x86.  When configuring vtkmodular and ves, cmake is invoked in [http://www.vtk.org/Wiki/CMake_Cross_Compiling cross compile mode] using a toolchain file for the target architecture.  The toolchain files are located in the [http://vtk.org/gitweb?p=VES.git;a=tree;f=CMake/toolchains;hb=HEAD CMake/toolchains] directory.
 
VES is normally built using a [http://www.kitware.com/products/html/BuildingExternalProjectsWithCMake2.8.html superbuild].  A superbuild manages the download, configure, build, and install steps of multiple projects all at once.  The VES superbuild will download [https://gitorious.org/kitware/vtkmodular vtkmodular], then configure and build both vtkmodular and VES using the appropriate cross compiler for the target architecture.  The target architecture may be an android device, iOS device, or the iOS simulator on x86.  When configuring vtkmodular and ves, cmake is invoked in [http://www.vtk.org/Wiki/CMake_Cross_Compiling cross compile mode] using a toolchain file for the target architecture.  The toolchain files are located in the [http://vtk.org/gitweb?p=VES.git;a=tree;f=CMake/toolchains;hb=HEAD CMake/toolchains] directory.
 +
 +
==Building==
 +
 +
====Android instructions====
 +
 +
The following commands will compile vtkmodular and ves libraries for the Android.
 +
 +
$ export ANDROID_NDK=/path/to/installed/android-ndk
 +
$ cd Apps/Android/CMakeBuild
 +
$ cmake -P configure.cmake
 +
$ cd build
 +
$ make -j4
 +
 +
Next, build and run the KiwiViewer application.  Ant version 1.8 or higher is required.
 +
 +
$ cd Apps/Android/Kiwi
 +
$
 +
$ # if android, adb, ant, or cmake are not in your PATH, edit tools.sh to enter the correct paths
 +
$
 +
$ ./configure_cmake.sh
 +
$ ./configure_ant.sh
 +
$ ./compile.sh
 +
 +
Use adb to confirm that your device is listed:
 +
 +
$ adb devices
 +
 +
Run KiwiViewer on the device:
 +
 +
$ ./run.sh
 +
 +
====iOS instructions====
 +
 +
The following commands will compile vtkmodular and ves libraries for the iOS simulator and iOS device.
 +
 +
$ cd Apps/iOS/CMakeBuild
 +
$ cmake -P configure.cmake
 +
$ cd build
 +
$ make -j4
 +
 +
Next, build and run the KiwiViewer application using Xcode.
 +
 +
$ open Apps/iOS/Kiwi/Kiwi.xcodeproj

Revision as of 03:24, 19 January 2012

Introduction

The VES Developer's Guide describes how to download and build the VES libraries, and how to use the libraries in Android and iOS applications.

Getting Started

For quick instructions, see the Download & Build Instructions page. This developer's guide will go into more detail than is found on that page.

Checkout the source from Git

Use Git to checkout the VES source code with the command:

$ git clone git://vtk.org/VES.git

Setting up your development environment

Android

You must have the Android SDK and Android NDK installed. To get started with Android development, visit the Android Developer's Guide. It is recommended that you build and run some of the Android sample applications that are provided with the Android SDK to get familiar with running code on your device before attempting to build and run VES/Kiwi based applications. See this README in the VES repository for a guide to setting up the Android development environment.

iOS

You must have Xcode and the iOS SDK installed. To get started with iOS development, visit Apple's iOS Dev Center. It is recommended that you build and run some of the iOS sample applications that are provided with the iOS SDK to get familiar with running code on your device before attempting to build and run VES/Kiwi based applications.


Build with CMake

CMake is used to configure and build VES.

What is a Superbuild?

VES is normally built using a superbuild. A superbuild manages the download, configure, build, and install steps of multiple projects all at once. The VES superbuild will download vtkmodular, then configure and build both vtkmodular and VES using the appropriate cross compiler for the target architecture. The target architecture may be an android device, iOS device, or the iOS simulator on x86. When configuring vtkmodular and ves, cmake is invoked in cross compile mode using a toolchain file for the target architecture. The toolchain files are located in the CMake/toolchains directory.

Building

Android instructions

The following commands will compile vtkmodular and ves libraries for the Android.

$ export ANDROID_NDK=/path/to/installed/android-ndk
$ cd Apps/Android/CMakeBuild
$ cmake -P configure.cmake
$ cd build
$ make -j4

Next, build and run the KiwiViewer application. Ant version 1.8 or higher is required.

$ cd Apps/Android/Kiwi
$
$ # if android, adb, ant, or cmake are not in your PATH, edit tools.sh to enter the correct paths
$
$ ./configure_cmake.sh
$ ./configure_ant.sh
$ ./compile.sh

Use adb to confirm that your device is listed:

$ adb devices

Run KiwiViewer on the device:

$ ./run.sh

iOS instructions

The following commands will compile vtkmodular and ves libraries for the iOS simulator and iOS device.

$ cd Apps/iOS/CMakeBuild
$ cmake -P configure.cmake
$ cd build
$ make -j4

Next, build and run the KiwiViewer application using Xcode.

$ open Apps/iOS/Kiwi/Kiwi.xcodeproj