Within the PhoneGap Build Service it is possible to specify distribution certificates which will be used to sign your applications. The requirements and type of distribution certificate differ depending on your chosen platform. Please see the sections below for further information.
To register a new Signing Key:
- Open your browser and return to the PhoneGap dashboard.
- Select the user icon in the top right corner and choose the ‘Edit account‘ option.
- Select the ‘Signing Keys‘ tab.
The certificate used to sign Android applications is known as a Keystore which can be generated free of charge using your own computer. For further information on this process, please see this documentation.
The Build Process does not require you to use a Keystore. However, if you do not select one at build time, the application which is produced will have debug mode enabled allowing users to inspect the application via the Chrome Developer Tools. This is useful when testing the application, but should not be distributed in a production environment, and cannot be submitted to the Google Play Store.
In order to produce a ‘release’ version of the application, the Keystore should be uploaded as a Signing Key. The same Signing Key can be used to sign multiple Android applications across multiple distribution methods (MDM, Play Store etc).
If you are distributing the app via the Google Play Store, it is important that a backup of the Keystore is made. If the Keystore is lost, it will not be possible to upload updates to the same listing within the Play Store.
Once you have generated/obtained the Keystore you wish to use, it can be registered as a Signing Key:
- Select the ‘add a key’ button in the Android section.
- Enter a title (i.e. a name used to identify the key).
- Upload the Keystore and specify the alias (which was set when creating the Keystore).
- Select ‘submit key’.
PhoneGap locks each of the keys to prevent them from being used without the pair of passwords associated with the Keystore file. When building an application via the Infinity App Studio, you will be prompted for the two password to unlock the Signing Key.
If you only wish to build for a Browser, you will be prompted to choose the name of the GitHub account you wish to use. Upon selecting an option, the second drop down list will be populated with a list of repositories associated with that account.
As an additional option, you can select whether the files should be pushed to ‘GitHub Pages‘. This produces a temporary website with the files, which can be used for quickly testing changes before pushing the files onto your live site. For further information, please see this documentation.
Once you have chosen your desired settings, press the ‘Build‘ button.
Note that Browser applications are not able to use some features provided by CommonTime Infinity as they cannot access input from a camera, microphone etc. For a full list of compatible features, please see this page.
If you wish to build the application for an Android or iOS device, you will be prompted to choose the name of the PhoneGap account you wish to use. Upon selecting an option, the second drop down list will be populated with a list of PhoneGap apps associated with that account.
You can then select which Signing Keys should be used to sign the applications. Where required, password fields will be provided to allow you to unlock the chosen keys.
Once you have entered your desired settings, press the ‘Build‘ button.
Note that if you choose to build for both desktop and devices, you will not be prompted to choose your GitHub details as these can be derived from which PhoneGap app you choose to use.