You need to give a specific name or icon, ID or version number to the apps that are on each platform. Giving unique names to each app can help identify them for users so that they know the version or platform or app they want to download. The settings for each platform are the same, although the requirements can differ.
You need to configure the version numbers in Mobile Designer, before you send an app through Development-Testing-Staging-Production.
Updating the version must be done manually for each new version.
If you forget to increment the version number, when you try to install the app on a device, the device displays an error indicating there is already an app with that ID and Version number on the device.
If you are distributing an app via the app store, and do not increment the number, the store will reject the app because the version number is not higher than the version it currently has.
To set specific information for apps by platform:
1.In VertiGIS Studio Mobile Designer, from the Services tab in the Components panel, select App.
2.In the Privacy Policy Url box, paste in the URL where the privacy policy that applies to your app is located. The URL is then added to the footer of your app.
3.Click any of the following:
•Android Settings
•iOS Settings
•Windows Settings
4.In the App Name box, type in the name of your app as you want it to appear on this specific platform.
5.To replace the icon with the one you want to use for this app, click Select File, browse to the location of your replacement icon, and then click Open.
For version 5.0 of the VertiGIS Studio Mobile Designer, it is not possible to change the icon for iOS apps. All iOS custom apps will have the Mobile icon when you create an app.
All app icons should be 1240 x 1240 .png files with a transparent background.
6.In the ID field type in the unique identifier for each platform using one of the following formats:
•Android: Use the convention com.example.myapp for example, com.vertigis.studiogo. Only use lowercase letters, numbers and periods.
•iOS: Use the convention com.example.myapp for example, com.vertigis.studiogo. Only use lowercase letters, numbers and periods.
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.
•Windows: You can use the same convention as Android and iOS, although Windows permits the use of capitals, numbers, periods and hyphens. The ID can only be between 3 and 21 (inclusive) characters long, for example, VertiGIS.StudioGo.
For more details about formatting your App ID, see App Platform Settings.
Once you have chosen an ID, it is not easy to change it. For more information about each platform ID format, see the following:
Android: Set the application ID
iOS: CFBundleIdentifier
Windows: Identity (Windows 10)
7.In the Version box, type in the version number that you want to assign this app on each platform. See App Platform Settings.
8.Click File > Save.
App Platform Settings
You need to configure the version numbers for any app before you send it through Development-Testing-Staging-Production. When you make changes, you should update the version number manually. When you finish developing an app and are ready to create a custom build to deploy in your organization, there are settings that you can specify for your target platforms.
If you plan to deploy your app using Google Play, the App Store or Microsoft Store, you need to first obtain provisioning files from the app stores before you can fill in some of the settings.
For detailed requirements about each platform's ID format, see the following:
•Android: Set the application ID
•iOS: CFBundleIdentifier
•Windows: Identity (Windows 11)
In the Platforms section, select and change any of the following:
Android Settings
•App Name: Type in the name of the app as it will appear on Android devices.
•App Icon: Click Select File to select the icon file to use for this Android app.
All app icons should be 1240 x 1240 .png files with a transparent background.
•ID: The unique ID to use for this app. This ID is not easy to change once you have set it. The ID is used as a unique identifier by Google Play. If you change the ID, it is seen by the store as a completely different app. Android follows the convention com.example.myapp, which is also referred to as the Java Package Name convention. The convention uses the reverse-Domain Name System (DNS) of the company followed by the app name, for example, com.latitudegeo.vertigisstudiogo. For Android, the ID must use only lowercase letters, numbers and periods.
•Version: The version number to display for this app on the Android device.
App versions follow the convention of Major.Minor.Build.Revision in reference to releases. So Major release or Minor release, the build number and revision number. Major always starts at 1, never zero.
For example:
•Major: When the release contains major new features, or a redesign of the app, increment the Major number.
•Minor: When the release contains minor changes like a new menu item or a few small features, increment the Minor number.
•Build-Revision: When the release contains minor tweaks like renaming menu items or bug fixes, increment the Build or Revision number.
If you forget to increment the version number, when you try to install the app on a device, the device displays an error indicating there is already an app with that ID and Version number on the device.
If you are distributing an app via the app store, and do not increment the number, the store will reject the app because the version number is not higher than the version it currently has.
iOS Settings
•App Name: Type in the name of the app as it will appear on iOS devices.
•App Icon: For version 5.0 of the VertiGIS Studio Mobile Designer, it is not possible to change the icon for iOS apps. All iOS custom apps will have the Mobile icon when you create an app.
•ID: The unique ID to use for this app. This ID is not easy to change once you have set it. The ID is used as a unique identifier by the App store. If you change the ID, it is seen by the store as a completely different app. Apple follows the convention com.example.myapp, which is also referred to as the Java Package Name convention. The convention uses the reverse-Domain Name System (DNS) of the company followed by the app name, for example, com.latitudegeo.vertigisstudiogo. For Apple, the ID must use only lowercase letters, numbers and periods.
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.
•Version: The version number to display for this app on the iOS device.
App versions follow the convention of Major.Minor.Build.Revision in reference to releases. So Major release or Minor release, the build number and revision number. Major always starts at 1, never zero.
For example:
•Major: When the release contains major new features, or a redesign of the app, increment the Major number.
•Minor: When the release contains minor changes like a new menu item or a few small features, increment the Minor number.
•Build-Revision: When the release contains minor tweaks like renaming menu items or bug fixes, increment the Build or Revision number.
If you forget to increment the version number, when you try to install the app on a device, the device displays an error indicating there is already an app with that ID and Version number on the device.
If you are distributing an app via the app store, and do not increment the number, the store will reject the app because the version number is not higher than the version it currently has.
Windows Settings
•App Name: Type in the name of the app as it will appear on Windows devices.
•App Icon: Click Select File to select the icon file to use for this Windows app.
All app icons should be 1240 x 1240 .png files with a transparent background.
•ID: The unique ID to use for this app. Windows does not enforce the reverse DNS convention, but you can follow that convention for the Microsoft Store as well. Windows allows you to use uppercase and lowercase characters, numbers, periods and hyphens but the ID must be between 3 and 21 (inclusive) characters long. For example, Latitude.VertigisStudioGo.
•Version: The version number to display for this app on the Windows device.
App versions follow the convention of Major.Minor.Build.Revision in reference to releases. So Major release or Minor release, the build number and revision number. Major always starts at 1, never zero.
For example:
•Major: When the release contains major new features, or a redesign of the app, increment the Major number.
•Minor: When the release contains minor changes like a new menu item or a few small features, increment the Minor number.
•Build-Revision: When the release contains minor tweaks like renaming menu items or bug fixes, increment the Build or Revision number.
If you forget to increment the version number, when you try to install the app on a device, the device displays an error indicating there is already an app with that ID and Version number on the device.
If you are distributing an app via the app store, and do not increment the number, the store will reject the app because the version number is not higher than the version it currently has.
•Privacy Policy Url: Paste in the URL where the privacy policy that applies to your app is located. The URL will be added to the footer of your app.
•Runtime License Key: Enter your runtime license key to grant access to users of this app. For more information, see ArcGIS Runtime License Options.
