QRail is a Qt library to access linkedconnections.org data resources in an easy way.
- Connection Scan Algorithm based route planner
- Liveboard, get all the departing or arriving trains in a station
- Station database with search functionality (by ID, location, ...)
- Modular approach
- CI builds and tests
All the latest features are available from the develop
branch.
This branch might be unstable, never use it in production!
Stable features are released from the develop
to the master
branch.
This branch aims to be stable at all times. If you want to use QRail in production, please checkout the release tags!
- Install Qt 5.9:
sudo apt install qt5-default qt5-qmake qtpositioning5-dev
- Install GCC, make, ...:
sudo apt install build-essentials
- Build
qrail
:qmake CONFIG+=debug && make -j4
- Build the tests:
cd tests && qmake CONFIG+=debug && make -j4
- Run the tests:
./qrail-tests
In order to run QRail you need to have a Sailfish OS device or use the Sailfish Emulator from the Sailfish IDE. You can find the Sailfish IDE on https://sailfishos.org/wiki/Application_Development You must have set up a device (with developer mode enabled) if you want to deploy it to a physical Sailfish OS device.
- Open
qrail.pro
in the Sailfish IDE - Check if the kit (
SailfishOS-3.0.2.8-armv7hl
for the Sony Xperia X), build mode (debug
is fine) and that the deployment device (Xperia X (ARM)
for the Sony Xperia X) are correct. - Click on the hammer button to build QRail.
- Open
tests/qrail-tests.pro
in the Sailfish IDE - Click on the run (green arrow) button to run the tests.
These instructions can also be executed from the command line:
For the QRail library:
qmake CONFIG+=debug
make -j4
For the tests:
cd tests
qmake CONFIG+=debug
make -j4
The tests are depending on the https://lc.dylanvanassche.be as Linked Connections Server. They are automatically executed on the Travis CI build infrastructure with every Git commit.