Difference between revisions of "Command Line Switches"
From Lianjapedia
Barrymavin (Talk | contribs) |
Yvonne.milne (Talk | contribs) |
||
Line 39: | Line 39: | ||
|- | |- | ||
|valign="top"|--runtimecaption||valign="top"|Caption text||Replaces the "Lianja App Center" caption text in the App Center Home workspace with the specified caption text. | |valign="top"|--runtimecaption||valign="top"|Caption text||Replaces the "Lianja App Center" caption text in the App Center Home workspace with the specified caption text. | ||
+ | |- | ||
+ | |valign="top"|--runtimedir||valign="top"|Runtime directory||Root directory where Runtime Apps, Library and Data are located, e.g. F:\Lianja\ or /opt/lianja/cloudserver/tenants/public/. This is the equivalent of setting the LIANJA_RUNTIMEDIR environment variable. | ||
|- | |- | ||
|valign="top"|--splashscreen||valign="top"|Path to a custom splashscreen or "None" to disable||Specify an App specific splashscreen at runtime. Note that if --app is specified no splashscreen is displayed unless specified. | |valign="top"|--splashscreen||valign="top"|Path to a custom splashscreen or "None" to disable||Specify an App specific splashscreen at runtime. Note that if --app is specified no splashscreen is displayed unless specified. |
Revision as of 04:36, 15 August 2013
When creating a desktop shortcut for running Lianja Apps there are several command line options that can be specified.
The following table provides details of the currently available command line options. These can be combined to customize the running of an App e.g.
lianja --app orderprocessing --maximized lianja myprogram.prg lianjaruntime --kiosk --fullscreen --runtimecaption "Our company Apps"
Lianja Command Line Options
Option | Arguments | Description |
---|---|---|
--app | yourappname | Run the specified App. |
--args | Arg,arg,arg | Specify an App specific comma separated list of args to be passed to a runtime script (see filename below). Enclose args in "..." and use single quotes for character args e.g. --args "'hello','world',2600,{04/04/1953}" |
filename | None | A filename to run. If no file extension is specified it is assumed to be an App and .lianja is postfixed to it. |
--fontsize | fontsize | Adjust the base fontsize of the App if you are using very high resolution displays and the default font size if too big or too small. |
--fullscreen | None | Run the App fullscreen. |
--geometry | x,y,width,height | Specify the geometry of the window. |
--icon | Window icon | Specify an App specific window icon at runtime. |
--kiosk | None | Run the App in kiosk mode. |
--maximized | None | Maximize the window. |
--noguests | None | Prevents readonly access to the Apps using the guest/guest login (disables guest login). |
--reset | None | Run Lianja App Builder without restoring previous App state. Use this if something messed up in the App Builder and it won't load. |
--runtime | None | Runs the Lianja App Center. |
--runtimecaption | Caption text | Replaces the "Lianja App Center" caption text in the App Center Home workspace with the specified caption text. |
--runtimedir | Runtime directory | Root directory where Runtime Apps, Library and Data are located, e.g. F:\Lianja\ or /opt/lianja/cloudserver/tenants/public/. This is the equivalent of setting the LIANJA_RUNTIMEDIR environment variable. |
--splashscreen | Path to a custom splashscreen or "None" to disable | Specify an App specific splashscreen at runtime. Note that if --app is specified no splashscreen is displayed unless specified. |
--title | Window title | Specify an App specific window title at runtime. |
--username | Username | Specify a username for automatic login. |
--password | Password | Specify a password for automatic login. |
To run a custom program specify a file extension of ".prg" or ".dbo". (.dbo files are pre-compiled .prg files). Remember to add READ EVENTS at the end of the program file otherwise it will just exit and no UI will be displayed.
Note: If you are running some custom program code that is going to take a long time to complete e.g. consolidating inventory, then you can provide feedback to the user via a system tray icon on the desktop e.g.
tray = createObject("SystemTrayIcon") tray.icon = "app:/myapp.png" tray.showMessage("Message", "Consolidating inventory...") // perform some long running operation to consolidate inventory tray.showMessage("Message", "Consolidation completed...")