72 lines
1.7 KiB
Markdown
72 lines
1.7 KiB
Markdown
luftdaten.info flashing tool
|
|
============================
|
|
|
|
Binary builds
|
|
-------------
|
|
|
|
Our main target is having working prebuilt binaries for users to simply
|
|
download and run, to avoid all the setup below.
|
|
|
|
### Linux
|
|
Currently Linux builds require *Python 3.6* (but 3.7 seems to work fine as
|
|
well), GNU make and Qt Linguist tools. Following packages should suffice on
|
|
Ubuntu:
|
|
|
|
sudo apt install qttools5-dev-tools python3.6 make
|
|
|
|
Then, to install python dependencies and build the binary use:
|
|
|
|
make deps dist
|
|
|
|
### Windows
|
|
|
|
Currently Windows builds require *Python 3.6* installed system-wide and added to
|
|
`%PATH%`.
|
|
|
|
To install python and cygwin dependencies and build everything use
|
|
`deploy\windows-build.bat` batch script.
|
|
|
|
### MacOS
|
|
Currently MacOS builds require *Python 3.6*, `dmgbuild` tool (`pip3 install
|
|
dmgbuild`) and Qt SDK installed (just the "Qt >
|
|
5... > macOS" part in installer) with following added to $PATH:
|
|
|
|
export PATH="$HOME/Qt/5.11.1/clang_64/bin:/Library/Frameworks/Python.framework/Versions/3.6/bin:$PATH"
|
|
|
|
Then just install dependencies and build everything using:
|
|
|
|
make deps dmg
|
|
|
|
Development
|
|
-----------
|
|
|
|
Both build & runtime requirements are defined in `requirements.txt` file. In
|
|
order to install these use the following command:
|
|
|
|
pip install -r requirements.txt
|
|
|
|
To manage dynamic UI and translation binaries generation we use a very simple
|
|
GNU make-based build system.
|
|
|
|
To simply build everything needed to run `luftdaten-tool.py` run:
|
|
|
|
make
|
|
|
|
To build and run use:
|
|
|
|
make run
|
|
|
|
To remove all build artifacts use:
|
|
|
|
make clean
|
|
|
|
All requirements are set up using wildcards, so, in theory, `Makefile` shouldn't
|
|
need much changes in near future.
|
|
|
|
Translations
|
|
------------
|
|
|
|
In order to rebuild `*.ts` files use:
|
|
|
|
make i18n-update
|