Lycia Visual Studio Code Extension (LVSCE)

Features

Extension supports

1. 4gl syntax highlighting
2. Build mode operations for single 4gl application
   • Build 4gl application
   • Deploy 4gl application
   • Clean 4gl application
   • Rebuild: Clean + Build 4gl application
   • Build + Deploy 4gl application
   • All at once: Clean + Build + Deploy 4gl application
3. Build mode operations for 4gl project
   • Build 4gl project
   • Deploy 4gl project
   • Clean 4gl project
   • Rebuild: Clean + Build 4gl project
   • Build + Deploy 4gl project
   • All at once: Clean + Build + Deploy 4gl project
4. Debugging/Running 4gl applications
   • Standard Visual Studio Code debug/run application using launch.json configuration file
   • Zero-configuration application launch: debug/run session is started using command palette/shortcut/context menu. No launch.json configuration is required.

Requirements

Lycia installation

Configuration parameters

• Lycia installation folder [lycia.lyciaDir] Path to Lycia installation folder. If set, the extension uses it to determine path to Lycia executable (e.g. qbuild, qxdebugadapter). If not - extension assumes that required Lycia folders are added to system PATH.
• Debug adapter executable [lycia.debugAdapter] If not set - extension assumes qxdebugadapter
• Default fgltarget to use in clean/build/deploy operations (Absolute path or relative to workspace folder) [lycia.defaultApplication] If set - extension generates application lifecycle tasks (Available via Terminal->Run Task...->fgl)
• Default fglproject to use in clean/build/deploy operations (Absolute path or relative to workspace folder) [lycia.defaultProject] If set - extension generates project lifecycle tasks (Available via Terminal->Run Task...->fgl)
• Echo commands generated by extension (e.g. debug adapter start command, debug adapter config, etc) [lycia.verbose]
• Generate lifecycle tasks for active file [lycia.useActiveFile] If set to true (default) - extension would generate lifecycle tasks for the project or application, provided that *.fgltarget/.fglproject file is open in active editor
• Build using Ninja system [lycia.useNinja] Tells to extension to compose qbuild command line for Ninja mode
• Additional arguments to pass to qbuild executable [lycia.qbuildArgs] Array of additional arguments to be passed to qbuild
• Default web server name to substitute into debug configuration [lycia.defaultWebserver]
• Default server instance to substitute into debug configuration [lycia.defaultServerInstance]
• Default server-side arguments to substitute into debug configuration [defaultLaunchArgs].
• Default environment variables to substitute into debug configuration [defaultLaunchEnvironment]
• Default client-side parameters to substitute into debug configuration [defaultLaunchClientParams]
• Default value for stopOnEntry to substitute into debug configuration [defaultDebugStopOnEntry]
• Clean/build/deploy application prior to launching it [buildAndDeployBeforeLaunch] (Applies to zero-configuration launch only).

Shortcuts for build mode tasks

Application shortcuts

• Alt + C - Clean
• Alt + B - Build
• Alt + D - Deploy
• Alt + R - Rebuild
• Alt + A - Do All (Rebuild + Deploy)

Project shortcuts

• Alt + P Alt + C - Clean
• Alt + P Alt + B - Build
• Alt + P Alt + D - Deploy
• Alt + P Alt + R - Rebuild
• Alt + P Alt + A - Do All (Rebuild + Deploy)

Run/Debug shortcuts

• Ctrl + R - Run application as Web application
• Ctrl + D - Debug application as Web application
• Ctrl + Shift + R - Run application as Desktop application
• Ctrl + Shift + D - Debug application as Desktop application

Following logic applies to build mode tasks invoked by shortcuts

• For application shortcuts
  • If lycia.useActiveFile = true and document in active editor is .fgltarget, then task is invoked for the corresponding FGL application
  • Else if default application is defined in extension configuration, then task is invoked for the corresponding FGL application
• For project shortcuts
  • If lycia.useActiveFile = true and document in active editor is .fglproject, then task is invoked for the corresponding FGL project
  • Else if default project is defined in extension configuration, then task is invoked for the corresponding FGL project
• For run/debug shortcuts
  • If lycia.useActiveFile = true and document in active editor is .fgltarget, then extension attempts to start run/debug session for the corresponding FGL application
  • Else if default application is defined in extension configuration, then extension attempts to start run/debug session for the corresponding FGL application

Not implemented

• Select and build multiple 4gl applications

Licenses

License for Lycia Visual Code Extension

Form Builder component of Lycia Visual Code Extension requires Lycia installation to work. Lycia EULA