An adaptable installer for your application
Go to file
2018-08-09 20:03:26 +10:00
.travis Remove broken Cargo caching from Travis 2018-01-31 18:54:15 +11:00
src Fix generating shortcuts for non-English usernames on Windows 2018-08-09 18:59:56 +10:00
static Correct error message copy-pasting 2018-08-09 18:06:16 +10:00
.gitignore Use proper logging solution 2018-08-04 16:28:13 +10:00
.travis.yml Remove broken Cargo caching from Travis 2018-01-31 18:54:15 +11:00
banner.png Clean up documentation 2018-08-09 17:06:20 +10:00
build.rs Remove warning about unused param in non-Windows handle_binary 2018-08-09 20:03:26 +10:00
Cargo.lock Add support for shortcuts on Windows 2018-08-08 19:31:38 +10:00
Cargo.toml Fix location of serde in build dependencies 2018-08-09 16:02:03 +10:00
config.linux.toml Bump configuration versions for example configs 2018-08-09 17:11:14 +10:00
config.windows.toml Bump configuration versions for example configs 2018-08-09 17:11:14 +10:00
LICENSE Add readme and license 2018-01-31 14:42:28 +11:00
liftinstall.png Add logo 2018-08-09 15:50:38 +10:00
README.md Clean up documentation 2018-08-09 17:06:20 +10:00

Usage Documentation - Quick Start - License

Build Status

An installer for your application. Designed to be customisable to the core, hookable from external applications, and have a decent UI.

This is designed to be a more modern interpretation of Qt's Installer Framework, which is hard to develop on, poorly documented, has hardcoded package listing format which requires very specific setups for packages and where packages must be built using their tool. Finally, it is poorly supported, with rare updates and a large list of bugs.

Building

For more detailed instructions, look at the usage documentation above.

There are are few system dependencies depending on your platform:

  • For all platforms, cargo should be available on your PATH. Rustup is the recommended way to achieve this. Stable or Nightly Rust works fine.
  • For Windows (MSVC), you need Visual Studio installed.
  • For Windows (Mingw), you need gcc/g++ available on the PATH.
  • For Mac, you need Xcode installed, and Clang/etc available on the PATH.
  • For Linux, you need gcc/g++, webkit2gtk, and libssl. For Ubuntu 18.04 this would look like:
apt install -y build-essential libwebkit2gtk-4.0-dev libssl-dev

In order to build yourself an installer, as a bare minimum, you need to:

  • Add your favicon to static/favicon.ico
  • Modify the bootstrap configuration file as needed (config.PLATFORM.toml).
  • Have the main configuration file somewhere useful, reachable over HTTP.
  • Run:
cargo build --release

Contributing

PRs are very welcome. Code should be run through Rustfmt before submission.

License

LiftInstall is licensed under the Apache 2.0 License, which can be found in LICENSE.