Skip to content

Latest commit

 

History

History
117 lines (102 loc) · 3.44 KB

INSTALL.md

File metadata and controls

117 lines (102 loc) · 3.44 KB

XyGrib ver 1.1.1 - Cmake build system

This includes instructions to download sources and build XyGrib yourself.

There is an option to use pre-build binaries for all desktops by downloading the appropriate installer for your system. These are found both in https://gihub.com/opengribs/XyGrib/releases or on https://opengribs.org in the download section.

Prerequisities

macOS

  • Install Homebrew
  • Install the requred packages: brew tap indilib/indi; brew install git cmake libnova openjpeg libpng qt5 proj

Linux

  • Install the required libraries
    • Ubuntu (21.04+):
      sudo add-apt-repository ppa:ubuntugis/ppa
      sudo apt-get update
      sudo apt-get install build-essential git cmake qtbase5-dev qtchooser qt5-qmake qtbase5-dev-tools  qttools5-dev libpng-dev libopenjp2-7-dev libnova-dev libproj-dev zlib1g-dev libbz2-dev libgdal-dev
    • Ubuntu (16.04-20.04):
      sudo add-apt-repository ppa:ubuntugis/ppa
      sudo apt-get update
      sudo apt-get install build-essential git cmake qt5-default libpng-dev libopenjp2-7-dev libnova-dev libproj-dev zlib1g-dev libbz2-dev libgdal-dev
    • Ubuntu Trusty: sudo apt-get install build-essential git cmake qt5-default libpng-dev libopenjpeg-dev libnova-dev libproj-dev zlib1g-dev libbz2-dev
    • Fedora 30:
      • Build: sudo dnf install gcc cmake make qt5-devel libpng-devel openjpeg2-devel libnova-devel proj-devel zlib-devel bzip2-devel
      • Run: libnova openjpeg2 qt5-qtbase qt5-qtbase-gui proj
    • openSUSE Tumbleweed: sudo zypper install gcc git cmake libqt5-qtbase-devel libpng-devel openjpeg2-devel libnova-devel libproj-devel zlib-devel libbz2-devel
    • NIXOS: nixpkgs contains a package for XyGrib
      • To get a a build environment containing all prerequisities run nix-shell -p xygrib
      • If you simply want to install it, use nix-env -i xygrib

Build and package

Options

XyGrib has two CMake options

  • GNU_PACKAGE (DEFAULT: OFF)
Files will be installed in GNU standard installation directories such as prefix/bin and prefix/share.
Packagers are recommended to test this option.
  • GEN_TRANSLATION (DEFAULT: ON)
Create targets to generate translation files.
Turning this off removes the need for qt-linguist, part of qttools qt5 submodule, during build.

macOS

  • Get the source
git clone https://github.com/opengribs/XyGrib.git
  • Build

To build, you'll need to tell CMake where Qt is located. This will be something like /usr/local/Cellar/qt/5.8.1 The exact version number may differ, check the version you have installed.

mkdir build
cd build
QT5_DIR="/usr/local/Cellar/qt/5.11.1"
cmake .. -DCMAKE_PREFIX_PATH=$QT5_DIR/
make
  • Package (To be integrated to the cmake build process)
cd ..
mv build/src/XyGrib.app .
./mac-package.sh

Linux

  • Get the source
git clone https://github.com/opengribs/XyGrib.git
  • Build
git clone https://github.com/opengribs/XyGrib.git
mkdir build
cd build
cmake ..
make
  • Install
cmake -DCMAKE_INSTALL_PREFIX=/wherever ..
sudo make install
  • Package
  • Debian / Ubuntu (This create 1 deb for the app and 1 deb for the supplementary maps)
dpkg-buildpackage -b

Windows

  • Get the source
git clone https://github.com/opengribs/XyGrib.git
  • Build
git clone https://github.com/opengribs/XyGrib.git
mkdir build
cd build
cmake ..
cmake --build .
  • Package
  • TBD