Creating your first installer

Creating your first installer

Understanding iquail

The installer you are going to build will be a python script.

But don't worry you don't need to be an expert in python to use iquail.

I recommend you to use vscode or pycharm to write iquail scripts.

Things you will always need to call in order to write your installer:

import iquail

iquail.run(solution, installer, builder(optional), controller (optional))

Explaining iquail.run arguments

• solution: This argument defines how your project is going be retrieved during installation For example, your project can be downloaded during the installation, or it can be embedded in the installer. List of solutions: SolutionFtp, SolutionGitHub, SolutionPacked

• installer: This argument defines installation information. (name, icon, publisher, if your app is console or gui, etc). See iquail.Installer() for more informations

• builder: This argument defines build information. (installer icon, additional build commands). See doc of iquail.build.Builder() for more informations

• controller: This argument defines the behavior of the installer. With this argument you can define if you want a GUI during the installation or console. You can also change the behavior of iquail (see this example). There is two controllers by default: ControllerConsole for console installation and ControllerTkinter for GUI installation.

Examples script

Download examples here

Lets build an example installer on windows:

> cd Documents\GitHub\iQuail\examples
> test_packed_gui.py --iquail_build
> dist\test_github_gui.exe

And on unix (linux/ osx)

$ cd Documents/GitHub/iQuail/examples
$ ./test_packed_gui.py --iquail_build
$ ./dist/test_packed_gui

Generated binary will be located in folder ./dist/