Building and Installing in a UNIX-like Environment using the GPSTk script - Terminal

The following procedure will build and install the GPSTk under the following environments.

OS X Developer Tools under Mavericks (10.9.3)

The following procedure will build and install the GPSTk.

  1. Ensure that prerequisites such as CMake have been installed.
  2. Download the GPSTk source distribution.
  3. Extract the GPSTk tarball. For example, using GNU tar
    tar xvzf gpstk.tar.gz
  4. Navigate to the root GPSTk directory
  5. Run the GPSTk script with the desired parameters
    Build and Install using default paths
    $ ./script_gpstk.sh [-h] [-b] [-i] [-v] [-c] [-r ] [-s ]
    -b     clean_build,   rm -rf gpstk_root/build 
    -i clean_install, rm -rf gpstk_install
    -d build_doxygen, build doxygen files
    -p build_python, build python swig bindings (autobuilds doxygen)
    -c core_only, only builds core library code
    -t test_switch, initialize test framework
    -v graphviz, generate dependency graph (.DOT and .PDF files)
    -r gpstk_root, default = ~/git/gpstk/dev, path to GPSTk top-level CMakeLists.txt file (and source tree)
    -s gpstk_install, default = /opt/gpstk, path to GPSTk install, e.g. ~/git/gpstk/install

Building and Installing in OSX using CMake - Terminal

The following procedure will build and install the GPSTk, under the following environments:
OS X Developer Tools under Mavericks (10.9.3)

  1. Ensure that OS X Developer Tools and CMake have been installed.
  2. Download the GPSTk source distribution.
  3. Extract the GPSTk tarball. For example, using GNU tar
    tar xvzf gpstk.tar.gz
  4. Create a directory for your build. For example, change into the gpstk/ directory and type
    mkdir build
  5. Change into the gpstk/build directory, this will be where all of the build files will reside.
  6. If GPSTk will be installed as a system library in /usr/local, execute the following commands:
    cmake ../ or ../dev (if using Developer repo)
    make
    To install to a different directory, the install directory must be set-up when CMake configures the makefiles. Execute the following commands:
    cmake -DCMAKE_INSTALL_PREFIX:PATH=/path/to/install ../ or ../dev (if using Developer repo)
    make
  7. To install GPSTk, execute
    make install
  8. To build the source documentation using doxygen: Change into the gpstk/dev directory (if using Developer repo) or the gpstk/ directory (if using the tarball), and type
    doxygen 

Building and Installing in OSX using CMake - Xcode IDE

The following procedure will build and install the GPSTk, under the following environments:
XCode 5.1.1 IDE under under Mavericks (10.9.3)

  1. Ensure that OS X Developer Tools and CMake have been installed.
  2. Download the GPSTk source distribution.
  3. Extract the GPSTk tarball. For example, using GNU tar
    tar xvzf gpstk.tar.gz
  4. Open a Terminal window in which to build the Xcode Project file using CMake.
  5. Create a directory for your build. For example, change into the gpstk/ directory and type
    mkdir build_Xcode
  6. Change into the gpstk/build directory, this will be where all of the build and project files will reside.
  7. If GPSTk will be installed as a system application in /usr/local, only the CMake generator must be declared when building the project files:
    • Execute the following commands:
      cmake -G "Xcode" ../ or ../dev (if using Developer repo)
      make
  8. If GPSTk will be installed to a custom directory, the target installation directory and CMake generator must be declared when building the project files:
    • Execute the following commands:
      cmake -DCMAKE_INSTALL_PREFIX:PATH=/path/to/install -G "Xcode" ../ or ../dev (if using Developer repo)
      make
  9. Once CMake is finished, open XCode IDE
  10. Left-click on "Open Other..." button at bottom left of "Welcome to Xcode" window
  11. In the File Explorer, navigate to the build folder and choose the Xcode project file, gpstk.xcodeproj.
  12. Wait until Xcode has completely loaded the project and finished indexing files.
  13. In the top left portion of the IDE, click on "ALL_BUILD" and the various projects that make up the GPSTk can be seen ("ALL_BUILD", which will build all projects except for "install").


  14. In the top left portion of the IDE, click on "My Mac 64-bit" to choose between 32-bit or 64-bit build architecture.
  15. To Build the GPSTk, select the "ALL_BUILD" project, the desired build architecture, and click on the Run button at the top left of the IDE.
  16. Once Xcode has finished building the code, verify that all projects were built and no errors occurred (should match the below image).
  17. To Install the GPSTK, select the "install" project, the desired build architecture, and click on the Run button at the top left of the IDE.
  18. Once Xcode has finished installing the binaries, verify no errors occurred (should match the below image).
  19. To verify that the applications are working, open a Terminal window, navigate to the target installation folder, and run an application (timeconvert.exe in image below)
This topic: Documentation > BuildingGPSTkUnderOSX
History: r11 - 23 Apr 2014 - 16:40:31 - BryanParsons
 
This site is powered by the TWiki collaboration platformCopyright amp; by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback