Program / Library .fgltarget File

.fgltarget File

Tags List

Example .fgltarget File

Keys and Values in .fgltarget Files

 

.fgltarget File

The .fgltarget file is created when you create, add, or import programs and libraries. This file stores the information about the files in that program or library, their locations, order for linking, environment variables, and the build configuration details.

Tags List

FGL Build Target

fglBuildTarget

Libraries

library

Sources

sources

file

Media Files

file

Environment Variables

envVariables

variable

Build Configurations

buildConfiguration

exclusions

additions

sources

file

 

Return to top

Example .fgltarget File

<?xml version="1.0" encoding="UTF-8"?>

<fglBuildTarget xmlns="http://namespaces.querix.com/lyciaide/target" name="program" type="fgl-program">

 

<libraries>

<library linkpos="0" name="library" dynamic="false" location=""/>

<library linkpos="1" name="library2" dynamic="false" location=""/>

<library linkpos="2" name="library1" dynamic="false" location=""/>

 

<sources type="fgl">

<file location="111.4gl"/>

<file location="1111.4s"/>

</sources>

 

<sources type="form">

<file location="111.fm2"/>

</sources>

 

<sources type="message">

<file location="111.msg"/>

</sources>

 

<mediaFiles>

<file client="true" location="11111.qxtheme" type="gui-theme-file"/>

<file client="true" location="111" type="other"/>

</mediaFiles>

 

<envVariables append="true">

<variable name="TEST" value="test_variable"/>

</envVariables>

 

<buildConfiguration name="nondef">

<exclusions>

<sources type="fgl">

<file location="main.4gl"/>

</sources>

</exclusions>

</buildConfiguration>

 

<buildConfiguration name="nondef2">

<additions>

<sources type="fgl">

<file location="extras.4gl"/>

</sources>

</additions>

</buildConfiguration>

 

</fglBuildTarget>

Keys and Values in .fgltarget Files

FGL Build Target

<fglBuildTarget xmlns="http://namespaces.querix.com/lyciaide/target" name="program" type="fgl-program">
fglBuildTarget
Key Description Value Value Description
name A name of the build target. <custom_name> By default, LVSCE fills this parameter’s value automatically when the .fgltarget file is created. If you rename program or library in FGL Project Explorer, the .fgltarget file will be renamed as well.
type A type the build target has. fgl-program LVSCE indicates a build target type both in .fglproject and .fgltarget files.
c-program
fgl-library
static-c-library
dynamic-c-library
web-service

 

Return to .fgltarget tags list

Libraries

<libraries>

<library linkpos="0" name="library" dynamic="false" location=""/>

<library linkpos="1" name="library2" dynamic="false" location=""/>

<library linkpos="2" name="library1" dynamic="false" location=""/>

library
Key Description Value Value Description
linkpos Is used for library linking order. It defines library position in qlink command line for program linking. <positive_integer> The order should start with 0.
name The name the library file has. <custom_name> Library file name.
dynamic This parameter is set for FGL libraries to indicate whether the library should be static or dynamic. true With this option set, the library will be dynamic.
false With this option set, the library will be static.
location The location of the library within the project root directory. <path> The path, relative to the src folder, where the library is located.
<empty> The src folder.

 

Return to .fgltarget tags list

Sources

<sources type="fgl">

<file location="111.4gl"/>

<file location="1111.4s"/>

</sources>

 

<sources type="form">

<file location="111.fm2"/>

</sources>

 

<sources type="message">

<file location="111.msg"/>

</sources>

sources
Key Description Value Value Description
type This parameter defines, which compilation tool LVSCE should use. fgl Is used for 4GL files: .4gl, .4s.
form Is used for .fm2, .sm2, .tb2, .ad2, .tm2, .per files.
message Is used for .msg files, which get converted into help files at compilation.
c Is used for .c files.
cheader Is used for .h files.
esqlc Is used for .ec files.
file
Key Description Value Value Description
location The file location, relative to the src folder. <path>/<file_name> If the src folder has sub-folder(s) and the file is inside one of them, this value will contain the path to the file relatively to the src folder and the file name.
<file_name> The file name, if the file is in src folder.

Note: You can also specify sub-folder(s) for a source file at the file naming step in file creation:

Step 1. Click the Create 4GL Source File option in FGL Project Explorer, as described in the File Creation section of the LVSCE documentation’s Create page.

Step 2. In the file naming field, type in the path and then the file name (with or without the file extension).

Example of input:

<path>/<file_name>

If you specify an existing folder in the path, FGL Project Explorer will add a newly created file to it. If there was no such folder prior to file creation, FGL Project Explorer will create that folder.

 

Return to .fgltarget tags list

Media Files

<mediaFiles>

<file client="true" location="11111.qxtheme" type="gui-theme-file"/>

<file client="true" location="111" type="other"/>

file
Key Description Value Value Description
client This parameter defines, whether the file gets added to the .tr2 file. true If true, the file gets added to .tr2 file.
false If false, the file gets omitted.
location The file location, relative to the src folder. <file_name> The file name, if the file is located in src folder.
<path>/<file_name> If the src folder has sub-folder(s) and the file is inside one of them, this value will display the path to the file relatively to the src folder and the file name.
type The type of the theme file. gui-theme-file This value is assigned if a media file is a .qxtheme file
other This value is assigned if a file is .css file, image file, text file, etc.

Note: You can also specify sub-folder(s) for a source file at the file naming step in file creation:

Step 1. Click the Create 4GL Source File option in FGL Project Explorer, as described in the File Creation section of the LVSCE documentation’s Create page.

Step 2. In the file naming field, type in the path and then the file name (with or without the file extension).

Example of input:

<path>/<file_name>

If you specify an existing folder in the path, FGL Project Explorer will add a newly created file to it. If there was no such folder prior to file creation, FGL Project Explorer will create that folder.

 

Return to .fgltarget tags list

Environment Variables (DEPRECATED)

Attention: This setting has been deprecated. Do not use it while working in LVSCE.

<envVariables append="true">

<variable name="LYCIA_PER_CONVERT_CALENDAR" value="1"/>

</envVariables>

envVariables
Key Description Value Value Description
append This parameter controls adding the environment variables for a program build. true Appends a new variable.
false Rewrites the existing variables.
variable
Key Description Value Value Description
name Compilation variable name for certain program. <variable_value> The value(s) of a certain variable.

Note: Specify the pairs of values (for example, values for LYCIA_PER_CONVERT_CHECKBOX) in the following format:

"'Yes', 'No'; 'Retry', 'Cancel'"

 

Return to .fgltarget tags list

Build Configuration

<buildConfiguration name="nondef">

<exclusions>

<sources type="fgl">

<file location="main.4gl"/>

</sources>

</exclusions>

</buildConfiguration>

 

<buildConfiguration name="nondef2">

<additions>

<sources type="fgl">

<file location="extras.4gl"/>

</sources>

</additions>

</buildConfiguration>

buildConfiguration
Key Description Value Value Description
name Name of non-default build configuration. <custom_name> This is the name that you assign at adding (creating) build configuration.

 

exclusions

This section has a list of the files that have been excluded from build configuration.

additions

This section has the list of files that have been added to an existing build configuration.

sources

The description of the files that are excluded.

Key Description Value Value Description
type The type of the excluded file. fgl FGL file
form Form file
message Message file
c C file
cheader C header file
esqlc ESQL/C program

 

file
Key Description Value Value Description
location The file location, relative to the src folder. <file_name> The file name, if the file is located in src folder.
<path>/<file_name> If the src folder has sub-folder(s) and the file is inside one of them, this value will display the path to the file relatively to the src folder and the file name.

 

Note: You can also specify sub-folder(s) for a source file at the file naming step in file creation:

Step 1. Click the Create 4GL Source File option in FGL Project Explorer, as described in the File Creation section of the LVSCE documentation’s Create page.

Step 2. In the file naming field, type in the path and then the file name (with or without the file extension).

Example of input:

<path>/<file_name>

If you specify an existing folder in the path, FGL Project Explorer will add a newly created file to it. If there was no such folder prior to file creation, FGL Project Explorer will create that folder.

 

Return to .fgltarget tags list

Return to top

 

Contact Us

Privacy Policy

Copyright © 2024 Querix, (UK) Ltd.