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 Lion (10.7.5)

  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 ../dev../ 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 IDE under Lion (10.7.5)

  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: r9 - 05 Dec 2013 - 17:44:13 - 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