The library can be found, installed, or updated from the Arduino IDE using the official Arduino Library Manager (available from IDE version 1.6.2).
The library can be installed on the system by following the same steps as with other Arduino library.
Refer to Installing Additional Arduino Libraries tutorial for details on how to install a third party library.
The library unit tests can be build on Windows/Linux platform to maintain the product stability and level of quality.
This section explains how to compile and build the software and how to get a test environment ready.
The following software must be installed on the system before compiling source code:
- Google C++ Testing Framework v1.8.0
- RapidAssist v0.9.1
- win32Arduino v2.4.0
- CMake v3.4.3 (or newer)
These are the base requirements to build source code:
- GNU-compatible Make or gmake
- POSIX-standard shell
- A C++98-standard-compliant compiler
- Microsoft Visual C++ 2010 or newer
The SoftTimers unit test uses the CMake build system to generate a platform-specific build environment. CMake reads the CMakeLists.txt files, checks for installed dependencies and then generates files for the selected build system.
The following steps show how to build the library:
-
Download the source code from an existing tags and extract the content to a local directory (for example
c:\projects\SoftTimers
or~/dev/SoftTimers
). -
Open a Command Prompt (Windows) or Terminal (Linux) and browse to the project directory.
-
Enter the following commands to generate the project files for your build system:
mkdir build
cd build
cmake ..
- Build the source code.
Windows
cmake --build . --config Release
Linux
make
SoftTimers comes with unit tests which help maintaining the product stability and level of quality.
Test are build using the Google Test v1.8.0 framework. For more information on how googletest is working, see the google test documentation primer.
To run tests, open a shell prompt and browse to the build/bin
folder and run softtimers_unittest
executable. For Windows users, the executable is located in build\bin\Release
.
Test results are saved in junit format in file softtimers_unittest.release.xml
.
The latest test results are available at the beginning of the README.md file.