Setup kit: Difference between revisions

From Axel Public Wiki
Jump to navigation Jump to search
No edit summary
 
(17 intermediate revisions by the same user not shown)
Line 9: Line 9:
The same applies for other products you may have in your setup package, like PageLab, SimuLab and SoftScope.
The same applies for other products you may have in your setup package, like PageLab, SimuLab and SoftScope.


<u>Please note</u>: Only LogicLab  stable releases are available on '''customer page'''; '''BETA releases''' are located only in '''Quixplorer page'''.
<u>Please note</u>: Only LogicLab  stable releases are available on '''customer page'''; '''BETA releases''' are located only in your '''File sharing''' area.


To create your your '''LogicLab custom setup executable file''' for distribution please follow this procedure:
To create your your '''LogicLab custom setup executable file''' for distribution please follow this procedure:
Line 15: Line 15:
== Pre-requirements ==
== Pre-requirements ==
* The login and password assigned by Axel for '''your customer page''' at [http://www.axelsw.it/trac/ www.axelsw.it/trac]
* The login and password assigned by Axel for '''your customer page''' at [http://www.axelsw.it/trac/ www.axelsw.it/trac]
* '''Inno Script Studio''' available [http://www.axelsw.it/pwiki/pub/ispack-5.5.5-unicode.exe here]
* '''Inno Setup compiler''' available on our website [http://www.axelsw.it/pwiki/pub/innosetup-qsp-6.0.3.exe here] or from the original location for the latest version [http://www.jrsoftware.org/download.php/ispack.exe here]
* Last version of your '''Setup-Kit''' available on your '''Quixplorer page''' <div style="display: inline; width: 220px; float: center;"> [[File:FolderQuix.png|link=]] </div>  reachable from your '''customer page'''
* Last version of your '''Setup-Kit''' available on your '''File sharing''' area reachable from your '''customer page'''


== Using custom icon==
== Customization for the executable==
In order to use your custom icon for LogicLab, your .ico file must contains the minimum following icon sizes:
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.


     * 256 x 256 pixels  – 32bit
===Application name===
     * 48 x 48 pixels  – 32bit
Edit ''LLMakeCustomVersions.bat'' and change ''set MAINTITLE=...'' and ''set APPTITLE=...''
     * 32 x 32 pixels  – 32bit
 
     * 16 x 16 pixels  – 32bit
Edit ''LogicLab.pct and welcome.pct'' on your LogicLab/template folder and change, on 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; these will be shown in the "About" dialog of LogicLab and in the executable properties. Please remember to edit the version number in the '''same 4 places'''.


== Create your own setup file for the first time==
== Create your own setup file for the first time==
# Extract the archive file of your '''Setup-Kit''' in your working directory es: ''L:\Test\MyLogicLabSetup\
# Extract the archive file of your '''Setup-Kit''' in your working directory es: ''C:\MyLogicLabSetup\''
# Apply the customizations you need
# Apply the customizations you need
# '''Make Setup File'''
# execute ''Setup\LLMakeCustomVersions.bat'' (if you apply any customization to the main executable)
# Go to '''Make Setup File'''


== Create a new version of your setup file, using a new redist ==
== Create a new version of your setup file, using a new redist ==
# Extract the archive file of the LogicLab redist (and/or other redists of other applications, like PageLab, SimuLab, ecc.) to your working directory root ''L:\Test\MyLogicLabSetup'' overwriting all existing files. Please note: Only the LogicLab binaries will be updated, your customization won't be affected.
# 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.
# If you need any further customizations then perform them.
# If you need any further customizations then perform them
# '''Make Setup File'''
# execute ''Setup\LLMakeCustomVersions.bat'' (if you apply any customization to the main executable)
# Go to '''Make Setup File'''


== Make Setup File ==
== Make Setup File ==
# Run the Inno Setup script  ''L:\Test\MyLogicLabSetup\Setup\LogicLab.iss'' and compile it.
# Run the Inno Setup script  ''C:\MyLogicLabSetup\Setup\MakeCustomLL.iss'' and compile it.
# Your setup file is created into ''L:\Test\MyLogicLabSetup\Setup\Output'' folder and ready to be distributed
# Your setup file is created into ''C:\MyLogicLabSetup\Setup\Output'' folder and ready to be distributed




== References ==
== References ==
*Technical info: refer to "LogicLab Technical reference" documentation.
*Technical info: refer to "LogicLab Technical reference" documentation.
*Technical info: refer to ''CustomVersionReadMe_ENG.txt'' on setup folder.
*Technical info: refer to ''C:\MyLogicLabSetup\Setup\CustomVersionReadMe.txt'' file
*Strategic info: refer to "LogicLab features and components" presentation available [http://www.axelsw.it/pwiki/pub/LL_features_and_components.pdf here]
*Strategic info: refer to "LogicLab features and components" documentation


[[Category:LogicLab]]
[[Category:LogicLab]]

Latest revision as of 10:54, 25 August 2023

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 your File sharing area.

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 File sharing area 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, on 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; these will be shown in the "About" dialog of LogicLab and in the executable properties. 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