lyciastudio.ini is a Lycia configuration file that includes a number of basic LyciaStudio configurations.
It is a text file containing command-line options that are added to the command line used when LycisStudio is started.
lyciastudio.ini is created when you install Lycia and can be modified depending on the developer's needs.
If you change lyciastudio.ini, you must move it to your configuration folder specified by LYCIA_CONFIG_PATH.
Otherwise, it will be rewritten when you update Lycia.
lyciastudio.ini is located in this folder:
-startup
plugins/org.eclipse.equinox.launcher_1.3.201.v20161025-1711.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.win32.win32.x86_64_1.1.401.v20161122-1740
-vmargs
-Dosgi.framework.extensions=org.eclipse.equinox.weaving.hook,org.eclipse.wst.jsdt.nashorn.extension
-vm
C:\Program Files\Java\jre1.8.0_161\bin\server\jvm.dll
-vmargs
-Dcom.querix.fgl.forms.designer.renderer=cef
-DEMBEDDED_JETTY_XML_CONFIG=C:\Program Files\Querix\Lycia\LyciaStudio\etc\jetty.xml
-Xms512m
-Xmx2048m
-Dfile.encoding=UTF-8
Below you can find the command line arguments included in lyciastudio.ini:
-startup <location> |
specifies the location of .jar files used to start LyciaStudio |
--launcher.library <location> |
specifies the location of the shared library for the LyciaStudio executable's companion. If not specified, looks in the plug-ins directory for the appropriate org.eclipse.equinox.launcher.[platform] fragment with the highest version |
--launcher.XXMaxPermSize <value> |
specifies the maximum permanent generation size of a Java virtual machine |
-vmargs |
customizes the operation of the Java virtual machine used to run LyciaStudio |
-vm <path to java vm> |
locates the Java virtual machine used to run LyciaStudio. The path specified must be the full file system path to an appropriate object - Java jre/bin directory, Java Executable, Java shared library (jvm.dll or libjvm.so), or a Java VM Execution Environment description file. If not specified, the search algorithm will be used to locate a suitable Java virtual machine. |
-DEMBEDDED_JETTY_XML_CONFIG |
specifies the default location of jetty.xml - a Lycia configuration file used for configuring Jetty web server embedded in LyciaStudio |
Here you can learn more about these (and other) arguments that can be added to lyciastudio.ini.
You can open and modify lyciastudio.ini with your favorite text editor:
Step 1. Close LyciaStudio (if running).
Step 2. Go to C:\Program Files\Querix\Lycia\LyciaStudio\.
Step 3. Open lyciastudio.ini with the text editor you prefer.
Step 4. Introduce the necessary changes and save them.
Step 5. Start LyciaStudio.
When modifying lyciastudio.ini, you must keep in mind these rules:
|
You must try and test your changes with a command line before changing lyciastudio.ini itself. |
|
Make a backup a copy of the original contents so that you can reverse your changes if anything goes wrong. |
|
All options and their arguments must be written in their own lines (1 option = 1 line). |
|
All
lines after |
|
Any use of -vmargs on the command line replaces all -vmargs settings in lyciastudio.ini unless --launcher.appendVmargs is specified either in lyciastudio.ini or on the command line. |
By using the -vmargs tag, you can set not only general properties (shared by all Eclipse-based IDE) but the properties specific to LyciaStudio.
For example,
1 |
by adding these properties, you will be able to obtain Lycia Form Designer logs: -vmargs -Dcom.querix.fgl.forms.designer.renderer=cef -Dcom.querix.fgl.forms.designer.render.arg.log-file=c:/temp/ceftmp.log -Dcom.querix.fgl.forms.designer.render.arg.log-severity=verbose -Dcom.querix.fgl.forms.designer.jslog=C:/temp/fd_scripts.js |
2 |
after adding this property, you can specify debugging options for Lycia Form Designer: -vmargs -Dcom.querix.fgl.forms.designer.renderer=cef |