Build an App for a Specific Platform

Before you build an app for Android, iOS, or Windows platforms, you must have done the following:

Given your app an App Name, App Icon, App ID and Version number in App Settings. For more information on the requirements for App ID and Version settings, see App Settings .
Deployed your app through all the deployment stages to the Production stage.

If you plan to distribute your apps through the app stores - Google Play, the App Store, or Microsoft Store - there are requirements that you need to set up and configure before you build the app. For example, for iOS builds, you need to have the provisioning file because it contains the App-ID you need to enter in App Settings.

When you build an app for Android or iOS platforms, the result is a compiled file that contains all the information required for your app to be distributed. In the case of Windows, the result is a zip file.

If you do not want to build apps and distribute the files, you can simply use VertiGIS Studio Go to open and run your app. To do so, you need to download the correct version of VertiGIS Studio Go from the appropriate store to each device and have the appropriate ArcGIS licenses for each user.

Before you can build an app for each of the stores, you will need the following:

Android: A KeyStore File, a KeyStore File Password, a Private Key Password and a KeyStore Alias.
iOS: A Provisioning File, a P12 File, and a P12 Password. The provisioning file also contains the App-ID you must use when you enter information in App Settings .
Windows: A PFX File and a PFX File Password.

Build an Android App

To build an app for Android:

In Mobile Designer, click Deploy to open the Deploy panel.
Click the Build App button.

If your app is not in the Production stage, the Build App button will not be available.
When the Build App dialog opens, click the Choose a platform drop-down list.
Select Android in the drop-down list, and then click OK.

New options appear in the Build App dialog.

The App Name, App ID and Version number that you entered in App Settings for the Android version of the app appear above the options.
To load the KeyStore File, click the Select File button, navigate to the file location, select the file, and then click OK.
In the KeyStore File Password box, type or paste in the password to access the KeyStore File.
In the Private File Password box, type or paste in the password used to encrypt the private key.
If you have more than one set of keys in the KeyStore, type in the name of the set of keys to use for this app.
Click OK.

A dialog opens to show you the status of the Build, which can take a few minutes, depending on the size of the app and its data.

When the build is complete, the dialog updates to show that the build was successful and provide buttons to download the app or show the link to the app so that it can be copied.
Do any of the following:
- Click Download to save the file containing the app to your computer.
- Click Show Link to display the URL to the location where the app build is located.
  
  The link appears in the dialog from where you can copy and paste it to share with others, or click the link to open a dialog where you can save the file to your computer.
  
  You can rename the file before you save it to your computer
Once the file is downloaded, extract the contents to the location you want.

Once you have the Android app, you can distribute the app in multiple ways. For more information, see Distribute an App.

Build an iOS App

If you are building an iOS app for distribution via the App Store, you need a provisioning file and a certificate before you can use Mobile Designer to build your app. The provisioning file from Apple will have an App ID within it. You must add that ID under App Settings before you build the app.
It is possible to have subsets, that is, have a provisioning file and certificate for any app from a particular company: com.vertigis.*.
You must ensure that the App ID you enter, matches the App ID in the provisioning file.

To build an app for iOS:

In Mobile Designer, click Deploy to open the Deploy panel.
Click the Build App button.

If your app is not in the Production stage, the Build App button will not be available.
When the Build App dialog opens, click the Choose a platform drop-down list.
Select iOS in the drop-down list, and then click OK.

New options appear in the Build App dialog.

The App Name, App ID and Version number that you entered in App Settings for the iOS version of the app appear above the options.
To load the Provisioning File, click the Select File button, navigate to the file location, select the file, and then click OK.
To load the P12 File that matches the Provisioning file, click the Select File button, navigate to the file location, select the file, and then click OK.
In the P12 Password box, type or paste in the password.
Click OK.

A dialog opens to show you the status of the Build, which can take a few minutes, depending on the size of the app and its data.

When the build is complete, the dialog updates to show that the build was successful and provide buttons to download the app or show the link to the app so that it can be copied.
Do any of the following:
- Click Download to save the file containing the app to your computer.
- Click Show Link to display the URL to the location where the app is located.
  
  The link appears in the dialog from where you can copy and paste it to share with others, or click the link to open a dialog where you can save the file to your computer.
  
  You can rename the file before you save it to your computer
Once you have the iOS app, you can distribute the app in multiple ways. For more information, see Distribute an App.

Build and Install a Windows App

To build an app for Windows:

In Mobile Designer, click Deploy to open the Deploy panel.
Click the Build App button.

If your app is not in the Production stage, the Build App button will not be available.
When the Build App dialog opens, click the Choose a platform drop-down list.
Select Windows in the drop-down list, and then click OK.

New options appear in the Build App dialog.

The App Name, App ID and Version number that you entered in App Settings for the Windows version of the app appear above the options.
To load the PFX File, click the Select File button, navigate to the file location, select the file, and then click Open.
In the PFX File Password box, type or paste in the password that opens the PFX File.
Click OK.

A dialog opens to show you the status of the Build, which can take a few minutes, depending on the size of the app and it's data.

When the build is complete, the dialog updates to show that the build was successful and provide buttons to download the app or show the link to the app so that it can be copied.
Do one of the following:
- Click Download to save a zip file containing the app to your computer.
- Click Show Link to display the URL to the location where the app build is located.
  
  The link appears in the dialog from where you can copy and paste it to share with others, or click the link open a dialog where you can save the zip file to you computer. When the link is sent to others, they can save and extract the same zip file on their computer.
  
  You can rename the file before you save it to your computer
Once the zip file is downloaded, extract the contents to the location you want.

To install your app:

Navigate to the folder where you extracted the zipped app.
To begin the installation, double-click the VertiGISStudio.Mobile.Viewer.appxbundle file.
When the Install [Name-of-App]? dialog opens, click Install.

The Request to access your precise location opens.
Click Yes.

The app opens. You may be asked to sign in if the app is secured.