The following topic will explain how to get Ping-Viewer source code and how to build it.
If you just want to test (and not debug) a recent build of Ping-Viewer you can use the Continuous Build. Versions are provided for all platforms [Windows, Linux and Mac].
Source code for Ping-Viewer is kept on GitHub here: https://github.com/bluerobotics/ping-viewer, and it's licensed under GPLv3.
To get the source files:
1. Clone the repo (or your fork) including submodules and go inside folder:
git clone https://github.com/bluerobotics/ping-viewer --recursive && cd ping-viewer
2. Update submodules (required each time you pull new source code):
git submodule update --init --recursive
Note: Github source-code zip files cannot be used because these do not contain the appropriate submodule source code. You must use git!
Ping-Viewer builds are supported for Windows, Linux and macOS. This is possible with the Qt toolkit as its cross-platform support library.
- macOS: v10.14 or higher
- Linux: 64 bit, gcc-8 or clang-7 compiler versions or higher
- Windows: 10 or higher, Visual Studio 2017 compiler (64 bit)
- Qt version: 5.12 (only)
Tip: For more information see: Qt 5 supported platform list.
Install Visual Studio 2017 (Windows Only)
The Windows compiler can be found here: Visual Studio 2017 compiler (64 bit).
When installing, you must minimally select all Visual C++ components.
- Download and run the Qt Online Installer.
- In the installer Select Components dialog choose: 5.12.
Then install just the following components: - Qt binary version: - Windows: MSVC 2017 64-bit - MacOS: macOS Clang 64-bit - Linux: Desktop gcc 64-bit - Everything else may be necessary except Android tools.
- Install Additional Packages (Platform Specific)
- Windows: USB Driver.
Building using Qt Creator
- Launch Qt Creator and open the pingviewer.pro project.
- Select the appropriate kit for your needs:
- macOS: Desktop Qt 5.12 Clang 64 bit
- Linux: Desktop Qt 5.12 GCC 64 bit
- Windows: Desktop Qt 5.12 MSVC2017 64 bit
- Build and run with the Green Play icon.
Building with terminal
- Go outside the cloned folder of Ping-Viewer
- Create the build folder
- Go inside build folder
- Run qmake command
- And build it
- And after that you'll be able to run the project
Tip: You can use
make -jNwhere N is the number of threads in your computer to improve the compiling speed.