Install Genero Mobile for iOS (multiple versions)

To build and package Genero Mobile for iOS (GMI) applications, you must first install GMI. This topic explains how to install multiple GMI versions/packages in parallel into different GMIDIR directories.

Before you begin:

The installation and licensing of Genero products requires you to read and accept the End User License Agreement, which can be found on the Four Js website at


The GMI and Genero BDL X.YZ versions are interdependent in terms of pcode compatibility: To build a GMI 5.00 embedded app, the source code needs to be compiled with Genero BDL 5.00. The Genero BDL runtime version used by GMI embedded apps can be found with the gmibuildtool -V command.

  • Download the Genero Mobile for iOS (GMI) distribution archive from the Four Js Web site. GMI can only be installed on a macOS┬« computer.
  • Install Genero Business Development Language. See Installing Genero BDL for more details.
If you need to test several versions of GMI against a single installation of Genero BDL, you will extract each GMI distribution archive to a separate directory. You can then quickly change the version of GMI used by resetting the GMIDIR and PATH environment variables.

When re-installing a new GMI archive, remove all "build" directories created by the gmibuildtool.

  1. Install Xcode®.
    The Xcode version must support the iOS versions of your mobile devices. As a general rule, update the Xcode and iOS to the latest versions.
  2. Create a directory for the GMI distribution archive.
    $ mkdir /opt/fourjs/gmi-4.00
  3. Define the GMIDIR environment variable with the GMI installation directory.
    $ export GMIDIR=/opt/fourjs/gmi-4.00
  4. Extract the GMI distribution archive (fjs-gmi-*.zip) into GMIDIR.
    The GMI distribution archive contains the GMI buildtool and the needed iOS libraries and helper scripts.
    $ unzip -q -o -d $GMIDIR fgl-gmi-*.zip
  5. Update PATH to include $GMIDIR/bin.
    $ export PATH=$GMIDIR/bin:$PATH
  6. If you have installed Cordova plugins, you need to re-install the plugins with the --install-plugin option of gmibuildtool. For more details, see Installing Cordova plugins.