Setup kit

From Axel Public Wiki
Jump to navigation Jump to search

The LogicLab Setup-Kit allows the customer to create and distribute a custom version of the LogicLab IDE, additional components and catalog.

With your first release of LogicLab, you receive, available on your customer page, a Setup-Kit with the necessary file structure to produce a LogicLab install executable.

You can then further customize the Setup-Kit to obtain a final LogicLab setup executable file, ready to be distributed. LogicLab can be customized in many ways (program name, install location, splash screen, about screen and informations, version, icons) and you can directly change these items by editing simple batch scripts.

LogicLab updates released by Axel are distributed as simple ZIP files containing the program binaries. These files are called LogicLab redistributable packages ("redist" for short) and are available on you customer page. The same applies for other products you may have in your setup package, like PageLab, SimuLab and SoftScope.

Please note: Only LogicLab stable releases are available on customer page; BETA releases are located only in Quixplorer page.

To create your your LogicLab custom setup executable file for distribution please follow this procedure:

Pre-requirements

  • The login and password assigned by Axel for your customer page at www.axelsw.it/trac
  • Inno Setup compiler available on our website here or from the original location for the latest version here
  • Last version of your Setup-Kit available on your Quixplorer page
    FolderQuix.png
    reachable from your customer page

Customization for the executable

These are just the most common types of customization. Please have a look to Setup\CustomVersions\LLMakeCustomVersions.bat for the full range of possible customizations.

Application name

Edit LLMakeCustomVersions.bat and change set MAINTITLE=... and set APPTITLE=...

Edit LogicLab.pct and welcome.pct on your LogicLab/template folder and change the, in the node template, the attribute title="..."

URL in About dialog

Edit LLMakeCustomVersions.bat and change set URL=...

Using custom icon

In order to use your custom icon for LogicLab your Setup\CustomVersions\res\icon.ico file must contains the minimum following icon sizes:

   256 x 256 pixels  – 32bit
   48 x 48 pixels  – 32bit
   24 x 24 pixels  – 32bit
   32 x 32 pixels  – 32bit
   16 x 16 pixels  – 32bit

also make sure that set ICON=.... is enabled in LLMakeCustomVersions.bat

Custom splash screen

Put your customized image for splash screen and about dialog in Setup\CustomVersions\res\splash.jpg (this is usually a JPEG image of 746x423 pixels). Also make sure that set SPLASH=.... is enabled in LLMakeCustomVersions.bat

Custom version information

Edit the file Setup\CustomVersions\res\version.rc using a normal text editor. Please remember to edit the version number in the same 4 places.

Create your own setup file for the first time

  1. Extract the archive file of your Setup-Kit in your working directory es: C:\MyLogicLabSetup\
  2. Apply the customizations you need
  3. execute Setup\LLMakeCustomVersions.bat (if you apply any customization to the main executable)
  4. Go to Make Setup File

Create a new version of your setup file, using a new redist

  1. Extract the archive file of the LogicLab redist (and/or other redists of other applications, like PageLab, SimuLab, ecc.) to your working directory root C:\MyLogicLabSetup overwriting all existing files. Please note: Only the LogicLab binaries will be updated, your customization won't be affected.
  2. If you need any further customizations then perform them
  3. execute Setup\LLMakeCustomVersions.bat (if you apply any customization to the main executable)
  4. Go to Make Setup File

Make Setup File

  1. Run the Inno Setup script C:\MyLogicLabSetup\Setup\MakeCustomLL.iss and compile it.
  2. Your setup file is created into C:\MyLogicLabSetup\Setup\Output folder and ready to be distributed


References

  • Technical info: refer to "LogicLab Technical reference" documentation.
  • Technical info: refer to C:\MyLogicLabSetup\Setup\CustomVersionReadMe.txt file
  • Strategic info: refer to "LogicLab features and components" documentation