Genero Mobile for iOS

Genero Mobile for iOS (GMI) is the Genero Mobile development client and runtime (Dynamic Virtual Machine, or DVM) that sits on the iOS device or emulator.

For information on how to put the Genero Mobile for iOS client onto your simulator or device, see Configure Genero Mobile for iOS.

When you run an app from Genero Studio in developer mode, you do not need to start Genero Mobile for iOS first.
  • If you are configured to display to an iOS emulator, the app displays in the Genero Mobile client on the emulator. The emulator must be started first.
  • If you are configured to display to an iOS device, the app displays to the device.

If you are using GMI, and the device goes into standby mode, the application does not run in the background and activities with the network are suspended.

If you tap on the GMI icon on the device screen, you are taken to the front page of the GMI app.
Figure: GMI front page

Screen shot of the front page, or home page, of the Genero Mobile for iOS client.

With the FGLSERVER information, you can easily run your app from the command line:

FGLSERVER=value_displayed_in_GMI fglrun program_name

Genero Mobile for iOS Settings

On the Settings >> Genero Mobile page, you set how the Genero Mobile client will operate.
Table 1. Genero Mobile for iOS Settings
Section Description
DEMO MODE You can specify whether to run the bundled app or your custom app (named main.42m) when Run Demo is selected. Your custom app must be launched with main.42m and must reside in the GMI's Documents directory. Only one main.42m can exist in the Documents directory at any given time.
Note: For applications on iOS, the app must be named main.42r when on the device. However, you can use any name you want when creating the app. The .42r will be renamed to main.42r by the packaging script.

When enabled, selecting Run Demo starts the main.42m of the bundled app.

When disabled, selecting Run Demo will look for main.42m in the Documents directory; if not found, the main.42m of the bundled app starts.

Tip: If your custom main.42m is found but does not launch successfully, you will want to enable DEMO MODE in order to successfully start the bundled app.
GUI LOGGING You can specify that the bundled app creates logs.

When enabled, the bundled app creates logs in the Documents/gmi_logs directory.

You can view the logs by entering the following URL:

http://phone_ip_address:port_number/logs

phone_ip_address and port_number display when you start GMI.

Logs are not created for apps run in developer mode; logging for apps in developer mode must be handled on the server (by Genero Studio or by using the --start-guilog option from the command line).

DEVELOPMENT PORT You can specify whether external Genero apps can connect to the GUI using HTTP on a local port, and specify the port number in the Port field.
When enabled, you can use HTTP debugger to view the AUI tree.
Tip: When you view the AUI tree using the HTTP debugger, you can view the blinking of the GUI as you navigate the tree; however the tree is not updated as you move through the app (live update). To update the tree, you must refresh your browser.
GUI FORWARDING When in developer mode, you can specify whether to enable GUI forwarding. GUI forwarding forwards the app to the Genero Desktop Client to aid in debugging.
Note: If you do not have the GDC installed on your development machine, contact Support to obtain a copy of the product.

Once an app is started on the mobile, the GDC displays the app that is run on the mobile device. Any requests from the GDC to the DVM are ignored to avoid behavior inconsistencies. You can view the AUI tree of the GDC application with a CTRL + Right Click on the GDC application (as you would any GDC application).

Tip: When you view the AUI tree using the GDC, the tree is updated as you move around the app, however there is no blinking of the GUI as you navigate the tree.

This option only applies to developer mode, it does not apply to apps bundled on the device.

When enabled, you will specify the ip address in the Host field and the port number in the Port field.
Note: The port number can be the same for both DEVELOPMENT PORT and GUI FORWARDING.
About Display version information about the installed Genero Mobile for iOS.
QA Automation This option will be removed before the GA release of GMI.

Run the Phone Demo

When you select Run Demo, the Phone Demo displays.

Figure: Phone Demo front page displayed on an iPhone

Screen shot of the front page of the demo as installed with Genero Mobile for iOS client.

See Genero mobile app demos for more information on the Phone Demo.

HTTP listening: Debug HTTP service

An HTTP debug service gives you access to internal debugging information.

The debug service is accessible at http://<device-ip>:6400 (by default). If the default has been changes, you can view the current HTTP URL on the Genero Mobile app front page.

Enter the URL into your browser on your development machine, and you are provided two links:

Logs
View the logs created by the app running on your mobile device. Logging must be enabled for the app.
AUI Tree
The AUI tree provides the AUI tree for the app.

The AUI tree does not automatically update in your browser as you move around the app. You must refresh your browser to see the AUI tree for the current window on your device or simulator.

Clicking on a node in the tree view highlights the corresponding item on the device or simulator.