SymphonyElectron/installer/mac
Vishwas Shashidhar 310186f2dd
fix: SDA-2068: show welcome screen per installation (#1020)
* SDA-2068: show welcome screen per installation - macOS

* SDA-2068: show welcome screen per installation - windows

Signed-off-by: Vishwas Shashidhar <vishwas.shashidhar@symphony.com>

* SDA-2068: support welcome screen on install for Windows
2020-06-13 11:42:57 +05:30
..
background.png SDA-2016: fix simplified installer issues (#986) 2020-05-06 13:16:20 +05:30
intro.html Electron-391 (Redesigned Windows & macOS installer) (#346) 2018-04-30 17:02:51 +05:30
postinstall.sh fix: SDA-2068: show welcome screen per installation (#1020) 2020-06-13 11:42:57 +05:30
preinstall.sh SDA-1062: warn users before closing running app (#972) 2020-04-21 11:18:27 +05:30
README.md SDA-1818: simplify mac installer (#973) 2020-04-27 16:34:56 +05:30
symphony-mac-packager.pkgproj SDA-2016: fix simplified installer issues (#986) 2020-05-06 13:16:20 +05:30

Advanced Mac Installer

Overview

Using Packages, we can build a .pkg file for an existing app (.app). The tool allows us to customise the installation procedure to capture the admin entered values from /tmp/sym_settings.txt and /tmp/sym_permissions.txt

Pre-requisites

Build Process

Once we have Packages installed, we'll just need to run the following command which should take care of creating the .pkg build for us.

packagesbuild -v installer/mac/symphony-mac-packager.pkgproj

The above command creates the build 'Symphony.pkg' and places it into the directory installer/mac/build relative to the project root.

Note that the packages project file 'symphony-mac-packager.pkgproj' contains link to the pre install and the post install scripts both of which are relative to 'symphony-mac-packager.pkgproj'.

More command line documentation here

Implementation Details

  • Pre installation script checks to see if the version we are installing is higher than the already installed version. If the installed version is lower, it deletes the installed version.
  • Post installation script reads data from the temp files and replaces the values in the 'Symphony.config' file in the installed app

Known Issues

  • During installation, there is a section called "Destination Select" which is skipped based on the OS and it's settings. This is a known bug.