Easy way to create custom application installer, developer manual, rev. 09/2015


Easy way to create custom application installer

developer manual

1. Introduction
2. Create a simple application
3. Build installer


1. Introduction

This document describes, how to create Q4OS self-extracting convenient installer for your own applications, files and directory structure. This procedure will create both '*.deb' file for manual installation with 'dpkg' command, and '*.esh' fully automated, convenient installer. The installer will flawlessly install and deliver an application or set of files to Q4OS users.

First of all, you have to install Q4OS Development Pack. Download development pack installer from Software downloads section of the Q4OS website and double-click downloaded file from file manager to launch setup. Follow installer instructions to install development pack.


2. Create a simple application

We will create some custom files and directory structure first, it will represent an application. Run commands in terminal to create working directory and application files, you can use cut and 'shift-insert' paste into the terminal:

$ mkdir -p $HOME/my-appdir
$ cd $HOME/my-appdir
$ echo 'kdialog --msgbox "Hello World"' > my-app.sh
$ echo -e 'install:\n\tcp my-app.sh /usr/bin/application.exu' > Makefile
$ chmod a+x my-app.sh

Newly created directory structure represents our application. Let's go to build the installer now.


3. Build installer

Copy the predefined configuration file for the installer. The configuration file is well documented and can be adjusted later to customize installer:

$ cd $HOME/my-appdir
$ cp /program_files/q4os-devpack/appsetup/q4os_setup.cfg.sample installer.cfg

Finally generate installer:

$ export SHOWDEBDIALOG=1
$ dash /program_files/q4os-devpack/bin/create_q4app_setup.sh installer.cfg

Comfortable Q4OS installer will be generated automatically, answer 'Yes' to 'Open installer location ?' question, when process finishes. You can now proceed testing installation of your application double-clicking 'setup_*.esh' file. Upload and publish this file somewhere on the Internet, Q4OS users will be happy for easy setup of your application.



Easy way to create custom application installer, user manual, rev. 09/2015