GST-specific environment variables

The GMIUSERDIR environment variable specifies a directory from which all files will be copied into the gmi directory (a child of the distribution directory) when packaging a GMI application from within Genero Studio.

This variable is specific to Genero Studio, and only comes into play when creating a GMI application package. When you create a GMI application package, the gmibuildtool is being used under the covers.

The gmi directory is a child of the distribution directory. When building an .ipa package, the gmibuildtool searches for a gmi directory in the distribution directory. If it finds a gmi directory, then it will use the Info.plist and icon files found in this directory to build the package.

Add this environment variable to your configuration or specify it for a package node. Its primary use is to specify a custom Info.plist file to be used during the GMI build process. Modifying the Info.plist file may be necessary if a property is not visible from GST. It is a fallback process and should only be used in last resort.

For a detailed explanation of the required directory structure for a GMI application, the role of the gmi directory, and the purpose of the Info.plist file, refer to the Building iOS apps with Genero topic in the Genero Business Development Language User Guide.

The GMIEXTDIR environment variable indicate the location of the iOS extensions to be taken into account when building Genero Mobile for iOS (GMI) packages from within Genero Studio.

The extensions must be compiled before they are put into the GMIEXTDIR directory.

make -f "$GMIDIR/lib/Makefile-gmi" USER_LIBNAME=frontcalls.a staticlib

This command creates the file frontcalls.a, which is the file to be placed in GMIEXTDIR.

This command provides a mechanism for implementing the --extension-libs option of the gmibuildtool. For more information about this option or about compiling the required static libraries, see the section Building a GMI app with C extensions or custom front calls in the Building iOS apps with Genero topic of the Genero Business Development Language User Guide.

The GSTSCHEMANAMES environment variable defines the schema files (4db, 4dbx, sch) to be loaded by default into the Meta-schema Manager when Genero Studio is launched. Available meta-schemas are displayed in the DB Schemas tab, and available to Genero Studio components such as Form Designer.

Select the default environment set (Global Database Schemas) or create a new one that includes the GSTSCHEMANAMES environment variable. Set the GSTSCHEMANAMES environment variable to specify the file names of the schemas to make available. Use the Value List environment variable type to list multiple schemas, separated by semicolons. Do not include the file extension.

Use FGLDBPATH to define the directories in which to find the schema files listed in the GSTSCHEMANAMES variable.

The GSTSETUPDIR environment variable specifies the directory that defines a specific setup for Genero Studio.

When in a remote Studio configuration, this setup directory is located on the server side and is synchronized with the client to have same settings on both sides.

To quickly identify the setup directory for your current GST configuration, select Tools > Specific setup > Locate setup directory. The directory defined by GSTSETUPDIR is highlighted in the File Browser (the Files view).

If you want to create your own Genero Studio setup, modify this variable to point to your own setup directory.

For your convenience, each iteration of the BAM templates have a default environment set created using the naming convention "Template dbapp*", where * represents the template version number. If you want to alter the BAM setup, you can make a copy of the GSTSETUPDIR directory defined by the "Template dbapp*" environment set and alter the copy.

The GSTUSERSAMPLESDIR environment variable defines the installation directory for the Genero Studio demo samples.

GSTUSERSAMPLESDIR is typically used when setting other environment variables.

By default, the GSTUSERSAMPLESDIR is not used in Genero Enterprise v3.0.

The GSTWCDIR environment variable defines the directory in which the web component XML files (.wcsettings) and optional image files are stored. By default this environment variable is set in the Web Components environment set.