As of Convertigo 7.2 Studio now supports local builds. This feature is very useful, for building mobile apps when access to cloud resources are difficult in a security restricted environment, for example. Also, local build gives more flexibility for building options.
Local build works by controlling the Cordova CLI (command line interface) directly from Convertigo Studio. This means that to use local build you must have installed on your workstation a full Cordova building system. Once this is done, you will be able to launch builds directly from Convertigo Studio. Also, as local build relies on Cordova, there are some restrictions about what you can build from what workstation. Please refer to the following table for Mobile Platforms/OS compatibility:
Windows Phone 7
Windows Phone 8
Mac OS X
Local build needs a working Cordova environment setup. Local build in version Convertigo 7.2 is tested with Cordova 3.6.3. Other Cordova versions are not supported.
Your workstation should be able to run Cordova CLI. To do this follow these steps :
$ sudo npm install -g firstname.lastname@example.org (For Linux; MacOS X workstations) or C:\>npm install -g email@example.com (For Windows workstations)The installation log may produce errors for any uninstalled platform SDKs. Following installation, you should be able to run Cordova on the command line.
NOTE: The -g flag above tells npm to install Cordova globally. You may need to add the npm directory to your PATH in order to invoke globally installed npm modules. On Windows, npm can usually be found at C:\Users\username\AppData\Roaming\npm and on Unix at /usr/local/share/npm.
Also, please refer to the Cordova installation guide for the platforms you want to build to install all the needed components for the target platforms.
You can also have a look to the general Cordova installation documentation : Cordova Platform Guide
As Convertigo Studio uses the Cordova's CLI, you may have to configure various PATHs for the tools Cordova will use. To do this, use Studio's Preferences:
Type In this field any PATH to tools required by Cordova separated by ";" (for Windows) or by ":" (for Linux or Mac OS)
Local build menu is available by right clicking on a target platform under the MobileApplication folder in the Convertigo projects view. The 'Cordova' sub menu will give the following options:
A local build can not start if the property "Convertigo server endpoint" is not configured in the "Mobile_application" object. You should configure there the Convertigo Server's URL your mobile app will call to run. If you build for development and debug, configure here your own studio's URL (Be sure that your mobile can access your local machine using WIFI for example). This URL will have this pattern:
If you build for production or pre-release, configure here the Convertigo server's production or pre-release url
Local build process will start by asking you to create a Cordova environment for the current project. This environment will be created in the _private directory of your project. Click "Ok" to create the environment.
If the Cordova environment cannot be created, an error message will be displayed. Most probably this message will appear if Cordova is not yet installed on your system or if the Cordova command cannot be found in the PATH.
When a build is triggered, it will run as an Eclipse job, so you can run it in background. All the build progress will be displayed in the "engine log" view at INFO level. When the build is complete, a dialog box will display the build result (.APK, .XAP).
For iOS builds on MacOS X, the dialog box will display the path of the Xcode project, so you can have the opportunity to launch Xcode and "Archive" the project to generate the .IPA file with a selected provisioning profile and certificate.
During the build process, some resources such as Cordova libraries and plugins may be downloaded, be sure to have Internet access. Also, as Cordova uses NodeJS NPM engine, be sure to configure proxy access if needed by issuing the flowing commands in a command shell :
Local build will automatically manage your Cordova plugins. Required plugins will be read from the target platform's config.xml stored in :
Only new plugins, not already installed for this Cordova environment, will be downloaded from the Internet. The config.xml file plugin reference is identical to Phonegap build specifications. For example :