mirror of
https://github.com/Yubico/yubioath-flutter.git
synced 2024-11-29 23:20:03 +03:00
92 lines
3.0 KiB
Plaintext
92 lines
3.0 KiB
Plaintext
== Building from source
|
|
|
|
_This document documents how to build from source for Linux/Unix. Windows and
|
|
Mac OS users should use the
|
|
https://developers.yubico.com/yubioath-desktop/Releases[installers] instead._
|
|
|
|
To build from source, you need the following tools and dependencies:
|
|
|
|
- `g++`
|
|
- `make`
|
|
- Python 3
|
|
- Qt 5 development tools, including `qmake`
|
|
- Qt QML development tools
|
|
|
|
You can use the `Build-Depends` field in the
|
|
https://github.com/Yubico/yubioath-desktop/blob/master/debian/control[Ubuntu
|
|
package control file] as a guide to identifying which of your distribution's
|
|
packages you need.
|
|
|
|
With these installed, the build procedure is:
|
|
|
|
$ git clone --recurse-submodules https://github.com/Yubico/yubioath-desktop.git
|
|
$ cd yubioath-desktop
|
|
$ qmake && make
|
|
|
|
From version 4.3.0 forward, you can also use the source tarball which now also
|
|
bundles source dependencies:
|
|
|
|
$ wget https://developers.yubico.com/yubioath-desktop/Releases/yubioath-desktop-4.3.0.tar.gz{,.sig}
|
|
$ gpg --verify yubioath-desktop-4.3.0.tar.gz.sig
|
|
$ tar xf yubioath-desktop-4.3.0.tar.gz
|
|
$ cd yubioath-desktop-4.3.0
|
|
$ qmake && make
|
|
|
|
The runtime dependencies are:
|
|
|
|
* QML modules:
|
|
** https://github.com/thp/pyotherside[PyOtherSide]
|
|
** Qt Labs Settings
|
|
** Qt Quick Controls
|
|
** Qt Quick Dialogs
|
|
* The https://developers.yubico.com/yubikey-manager/[YubiKey Manager] Python
|
|
library
|
|
|
|
You can use the `Depends` field in the
|
|
https://github.com/Yubico/yubioath-desktop/blob/master/debian/control[Ubuntu
|
|
package control file] as a guide to identifying which of your distribution's
|
|
packages you need.
|
|
|
|
With these installed, you can just run the program:
|
|
|
|
$ ./yubioath-desktop
|
|
|
|
|
|
=== Installation and packaging
|
|
|
|
The files you need to install in your system, or include in a distribution
|
|
package, are:
|
|
|
|
- The `yubioath-desktop` binary, installed somewhere on the `$PATH`
|
|
- The icon `resources/icons/yubioath.png`, installed as `yubioath.png` somewhere
|
|
on the
|
|
https://standards.freedesktop.org/icon-theme-spec/icon-theme-spec-latest.html#directory_layout[Freedesktop]
|
|
or
|
|
https://doc.qt.io/qt-5/appicon.html#setting-the-application-icon-on-common-linux-desktops[Qt]
|
|
icons search path
|
|
- (Optional) The Desktop Application descriptor
|
|
`resources/yubioath-desktop.desktop`, installed somewhere on the
|
|
https://standards.freedesktop.org/menu-spec/latest/ar01s02.html[Freedesktop
|
|
applications search path]
|
|
|
|
For example, these installation paths are likely to work:
|
|
|
|
- `/usr/bin/yubioath-desktop`
|
|
- `/usr/share/applications/yubioath-desktop.desktop`
|
|
- `/usr/share/pixmaps/yubioath.png`
|
|
|
|
|
|
==== Debian based distributions
|
|
|
|
On Debian based distributions, it might be enough to use the included package
|
|
definition files for Ubuntu:
|
|
|
|
$ debuild -us -uc
|
|
|
|
If your distribution does not provide a package with the YubiKey Manager Python
|
|
library, you can build that as well from the bundled dependency:
|
|
|
|
$ cd vendor/yubikey-manager
|
|
$ debuild -us -uc
|
|
$ sudo dpkg -i ../python3-yubikey-manager_VERSION_all.deb
|