Progress will discontinue Telerik Platform on May 10th, 2018. Learn more

General Properties

Filter by IDE
Select the Progress AppBuilder client you are currently using for development.

IDE

AppBuilder lets you modify the Apache Cordova version, the application identifier, the version and the supported interface orientation of the device. You can configure these non-OS-specific options in the General tab in the Properties dialog or with the appbuilder prop command.

In-Browser

Option Description Additional Comments
Cordova version The Cordova version is the version of the hybrid application wrapper for the app. When you change the target Apache Cordova version, keep in mind that you might need to upgrade or downgrade any integrated or custom plugins and you might need to modify your code because of modified or deprecated APIs. AppBuilder might also need to reload your app.
AppBuilder supports the following versions of Apache Cordova.
  • 6.4.0 (iOS 4.3.1) (Android 6.1.0) (Windows Phone 3.8.2)*
  • 5.2.0 (iOS 4.2.0) (Android 5.2.1) (Windows Phone 3.8.2) - Experimental**
  • 5.0.0 (iOS 4.0.1) (Android 5.1.0) (Windows Phone 3.8.2)***
  • 4.0.0 (iOS 3.8.0) (Android 4.1.1) (Windows Phone 3.8.0)****
  • Experimental framework versions have not been thoroughly verified and you might experience multiple issues when working against them.
Application identifier The application identifier uniquely identifies an app on both iOS, Windows Phone and Android devices and in their respective application stores.
The application identifier must consist of one or more alphanumeric strings, separated by a dot. The strings must be valid uniform type identifiers (UTIs), containing letters, numbers, hyphens, underscores or periods.
AppBuilder will prompt you if your application identifier is not applicable to one or more mobile platforms.
  • Not to be confused with App ID—the unique identifier used to connect Telerik Platform services to the app.
  • For Android, you can manually set this property in the AndroidManifest.xml and config.xml files. If the value is identical across both configuration files, AppBuilder will build the application package with the identifier from the configuration files. If the value does not match in both configuration files or it is not modified, AppBuilder will build the application package with the identifier configured in the properties for your app.
Version The version property sets the current version of the application visible to the user. You need to change it for every new release of the app that you want to distribute publicly. The version must consist of two or three numbers, separated with a dot (.).
  • For iOS application packages, this sets the CFBundleShortVersionString key in Info.plist.
  • For Windows Phone 8.1 application packages, always increase this property before re-deploying the package on device. Otherwise, your changes will not be updated on the device.
Author The name of the application author.
  • This property is applicable only to Windows Phone.
  • If not set, AppBuilder sets your user name as the author name.
Display Name The display name is the user-friendly title that appears on the device below the app icon. This setting applies to all device platforms.
To set different display names for each platform, you need to modify the required configuration files.
  • If you want to publish a Windows Phone 8.1 app in the Windows Phone Store, this must be the App name for your app as listed in the Windows Phone Store.
  • If not set, AppBuilder sets the app name as the display name.
  • If you have set the iOS display name in AppBuilder 1.11.x or earlier, AppBuilder sets this value for the display name.
Description The description of the app. This property is applicable only to Windows Phone.
Supported interface orientation The supported interface orientation (portrait and landscape) toggles the availability of these modes on the devices running your app. For example: if only portrait is enabled, your app will never go into landscape view on the device.
You cannot review changes in the supported interface orientation in the Cordova developer app.
By default, both portrait and landscape orientation are enabled.

* When you change the target Apache Cordova version of your app to Apache Cordova 6.4.0, you will actually develop against Apache Cordova 4.3.1 for iOS, Apache Cordova 6.1.0 for Android and Apache Cordova 3.8.2 for Windows Phone.

** When you change the target Apache Cordova version of your app to Apache Cordova 5.2.0, you will actually develop against Apache Cordova 4.2.0 for iOS, Apache Cordova 5.2.1 for Android and Apache Cordova 3.8.2 for Windows Phone.
In this version of AppBuilder, support for Apache Cordova 5.2.0 is experimental. Migrations between Apache Cordova versions have not been verified and you might experience multiple issues when working against Apache Cordova 5.2.0.
When working with Apache Cordova 5.2.0, keep in mind that you might need to modify your code due to breaking changes in the APIs.
Apache Cordova 5.2.0 will become fully supported in a future release of AppBuilder.

*** When you change the target Apache Cordova version of your app to Apache Cordova 5.0.0, you will actually develop against Apache Cordova 4.0.1 for iOS, Apache Cordova 5.1.0 for Android and Apache Cordova 3.8.2 for Windows Phone.

**** When you change the target Apache Cordova version of your app to Apache Cordova 4.0.0, you will actually develop against Apache Cordova 3.8.0 for iOS, Apache Cordova 4.1.1 for Android and Apache Cordova 3.8.0 for Windows Phone.

Universal

Option Description Additional Comments
Cordova version The Cordova version is the version of the hybrid application wrapper for the app. When you change the target Apache Cordova version, keep in mind that you might need to upgrade or downgrade any integrated or custom plugins and you might need to modify your code because of modified or deprecated APIs. AppBuilder might also need to reload your app.
AppBuilder supports the following versions of Apache Cordova.
  • 6.4.0 (iOS 4.3.1) (Android 6.1.0) (Windows Phone 3.8.2)*
  • 5.2.0 (iOS 4.2.0) (Android 5.2.1) (Windows Phone 3.8.2) - Experimental**
  • 5.0.0 (iOS 4.0.1) (Android 5.1.0) (Windows Phone 3.8.2)***
  • 4.0.0 (iOS 3.8.0) (Android 4.1.1) (Windows Phone 3.8.0)****
  • Experimental framework versions have not been thoroughly verified and you might experience multiple issues when working against them.
Application identifier The application identifier uniquely identifies an app on both iOS, Windows Phone and Android devices and in their respective application stores.
The application identifier must consist of one or more alphanumeric strings, separated by a dot. The strings must be valid uniform type identifiers (UTIs), containing letters, numbers, hyphens, underscores or periods.
AppBuilder will prompt you if your application identifier is not applicable to one or more mobile platforms.
  • Not to be confused with App ID—the unique identifier used to connect Telerik Platform services to the app.
  • For Android, you can manually set this property in the AndroidManifest.xml and config.xml files. If the value is identical across both configuration files, AppBuilder will build the application package with the identifier from the configuration files. If the value does not match in both configuration files or it is not modified, AppBuilder will build the application package with the identifier configured in the properties for your app.
Version The version property sets the current version of the application visible to the user. You need to change it for every new release of the app that you want to distribute publicly. The version must consist of two or three numbers, separated with a dot (.).
  • For iOS application packages, this sets the CFBundleShortVersionString key in Info.plist.
  • For Windows Phone 8.1 application packages, always increase this property before re-deploying the package on device. Otherwise, your changes will not be updated on the device.
Author The name of the application author.
  • This property is applicable only to Windows Phone.
  • If not set, AppBuilder sets your user name as the author name.
Display Name The display name is the user-friendly title that appears on the device below the app icon. This setting applies to all device platforms.
To set different display names for each platform, you need to modify the required configuration files.
  • If you want to publish a Windows Phone 8.1 app in the Windows Phone Store, this must be the App name for your app as listed in the Windows Phone Store.
  • If not set, AppBuilder sets the app name as the display name.
  • If you have set the iOS display name in AppBuilder 1.11.x or earlier, AppBuilder sets this value for the display name.
Description The description of the app. This property is applicable only to Windows Phone.
Supported interface orientation The supported interface orientation (portrait and landscape) toggles the availability of these modes on the devices running your app. For example: if only portrait is enabled, your app will never go into landscape view on the device.
You cannot review changes in the supported interface orientation in the Cordova developer app.
By default, both portrait and landscape orientation are enabled.

* When you change the target Apache Cordova version of your app to Apache Cordova 6.4.0, you will actually develop against Apache Cordova 4.3.1 for iOS, Apache Cordova 6.1.0 for Android and Apache Cordova 3.8.2 for Windows Phone.

** When you change the target Apache Cordova version of your app to Apache Cordova 5.2.0, you will actually develop against Apache Cordova 4.2.0 for iOS, Apache Cordova 5.2.1 for Android and Apache Cordova 3.8.2 for Windows Phone.
In this version of AppBuilder, support for Apache Cordova 5.2.0 is experimental. Migrations between Apache Cordova versions have not been verified and you might experience multiple issues when working against Apache Cordova 5.2.0.
When working with Apache Cordova 5.2.0, keep in mind that you might need to modify your code due to breaking changes in the APIs.
Apache Cordova 5.2.0 will become fully supported in a future release of AppBuilder.

*** When you change the target Apache Cordova version of your app to Apache Cordova 5.0.0, you will actually develop against Apache Cordova 4.0.1 for iOS, Apache Cordova 5.1.0 for Android and Apache Cordova 3.8.2 for Windows Phone.

**** When you change the target Apache Cordova version of your app to Apache Cordova 4.0.0, you will actually develop against Apache Cordova 3.8.0 for iOS, Apache Cordova 4.1.1 for Android and Apache Cordova 3.8.0 for Windows Phone.

Windows

Option Description Additional Comments
Cordova version The Cordova version is the version of the hybrid application wrapper for the app. When you change the target Apache Cordova version, keep in mind that you might need to upgrade or downgrade any integrated or custom plugins and you might need to modify your code because of modified or deprecated APIs. AppBuilder might also need to reload your app.
AppBuilder supports the following versions of Apache Cordova.
  • 6.4.0 (iOS 4.3.1) (Android 6.1.0) (Windows Phone 3.8.2)*
  • 5.2.0 (iOS 4.2.0) (Android 5.2.1) (Windows Phone 3.8.2) - Experimental**
  • 5.0.0 (iOS 4.0.1) (Android 5.1.0) (Windows Phone 3.8.2)***
  • 4.0.0 (iOS 3.8.0) (Android 4.1.1) (Windows Phone 3.8.0)****
  • Experimental framework versions have not been thoroughly verified and you might experience multiple issues when working against them.
Application identifier The application identifier uniquely identifies an app on both iOS, Windows Phone and Android devices and in their respective application stores.
The application identifier must consist of one or more alphanumeric strings, separated by a dot. The strings must be valid uniform type identifiers (UTIs), containing letters, numbers, hyphens, underscores or periods.
AppBuilder will prompt you if your application identifier is not applicable to one or more mobile platforms.
  • Not to be confused with App ID—the unique identifier used to connect Telerik Platform services to the app.
  • For Android, you can manually set this property in the AndroidManifest.xml and config.xml files. If the value is identical across both configuration files, AppBuilder will build the application package with the identifier from the configuration files. If the value does not match in both configuration files or it is not modified, AppBuilder will build the application package with the identifier configured in the properties for your app.
Version The version property sets the current version of the application visible to the user. You need to change it for every new release of the app that you want to distribute publicly. The version must consist of two or three numbers, separated with a dot (.).
  • For iOS application packages, this sets the CFBundleShortVersionString key in Info.plist.
  • For Windows Phone 8.1 application packages, always increase this property before re-deploying the package on device. Otherwise, your changes will not be updated on the device.
Author The name of the application author.
  • This property is applicable only to Windows Phone.
  • If not set, AppBuilder sets your user name as the author name.
Display Name The display name is the user-friendly title that appears on the device below the app icon. This setting applies to all device platforms.
To set different display names for each platform, you need to modify the required configuration files.
  • If you want to publish a Windows Phone 8.1 app in the Windows Phone Store, this must be the App name for your app as listed in the Windows Phone Store.
  • If not set, AppBuilder sets the app name as the display name.
  • If you have set the iOS display name in AppBuilder 1.11.x or earlier, AppBuilder sets this value for the display name.
Description The description of the app. This property is applicable only to Windows Phone.
Supported interface orientation The supported interface orientation (portrait and landscape) toggles the availability of these modes on the devices running your app. For example: if only portrait is enabled, your app will never go into landscape view on the device.
You cannot review changes in the supported interface orientation in the Cordova developer app.
By default, both portrait and landscape orientation are enabled.

* When you change the target Apache Cordova version of your app to Apache Cordova 6.4.0, you will actually develop against Apache Cordova 4.3.1 for iOS, Apache Cordova 6.1.0 for Android and Apache Cordova 3.8.2 for Windows Phone.

** When you change the target Apache Cordova version of your app to Apache Cordova 5.2.0, you will actually develop against Apache Cordova 4.2.0 for iOS, Apache Cordova 5.2.1 for Android and Apache Cordova 3.8.2 for Windows Phone.
In this version of AppBuilder, support for Apache Cordova 5.2.0 is experimental. Migrations between Apache Cordova versions have not been verified and you might experience multiple issues when working against Apache Cordova 5.2.0.
When working with Apache Cordova 5.2.0, keep in mind that you might need to modify your code due to breaking changes in the APIs.
Apache Cordova 5.2.0 will become fully supported in a future release of AppBuilder.

*** When you change the target Apache Cordova version of your app to Apache Cordova 5.0.0, you will actually develop against Apache Cordova 4.0.1 for iOS, Apache Cordova 5.1.0 for Android and Apache Cordova 3.8.2 for Windows Phone.

**** When you change the target Apache Cordova version of your app to Apache Cordova 4.0.0, you will actually develop against Apache Cordova 3.8.0 for iOS, Apache Cordova 4.1.1 for Android and Apache Cordova 3.8.0 for Windows Phone.

Visual Studio

Option Description Additional Comments
Cordova version The Cordova version is the version of the hybrid application wrapper for the app. When you change the target Apache Cordova version, keep in mind that you might need to upgrade or downgrade any integrated or custom plugins and you might need to modify your code because of modified or deprecated APIs. AppBuilder might also need to reload your app.
AppBuilder supports the following versions of Apache Cordova.
  • 6.4.0 (iOS 4.3.1) (Android 6.1.0) (Windows Phone 3.8.2)*
  • 5.2.0 (iOS 4.2.0) (Android 5.2.1) (Windows Phone 3.8.2) - Experimental**
  • 5.0.0 (iOS 4.0.1) (Android 5.1.0) (Windows Phone 3.8.2)***
  • 4.0.0 (iOS 3.8.0) (Android 4.1.1) (Windows Phone 3.8.0)****
  • Experimental framework versions have not been thoroughly verified and you might experience multiple issues when working against them.
Application identifier The application identifier uniquely identifies an app on both iOS, Windows Phone and Android devices and in their respective application stores.
The application identifier must consist of one or more alphanumeric strings, separated by a dot. The strings must be valid uniform type identifiers (UTIs), containing letters, numbers, hyphens, underscores or periods.
AppBuilder will prompt you if your application identifier is not applicable to one or more mobile platforms.
  • Not to be confused with App ID—the unique identifier used to connect Telerik Platform services to the app.
  • For Android, you can manually set this property in the AndroidManifest.xml and config.xml files. If the value is identical across both configuration files, AppBuilder will build the application package with the identifier from the configuration files. If the value does not match in both configuration files or it is not modified, AppBuilder will build the application package with the identifier configured in the properties for your app.
Version The version property sets the current version of the application visible to the user. You need to change it for every new release of the app that you want to distribute publicly. The version must consist of two or three numbers, separated with a dot (.).
  • For iOS application packages, this sets the CFBundleShortVersionString key in Info.plist.
  • For Windows Phone 8.1 application packages, always increase this property before re-deploying the package on device. Otherwise, your changes will not be updated on the device.
Author The name of the application author.
  • This property is applicable only to Windows Phone.
  • If not set, AppBuilder sets your user name as the author name.
Display Name The display name is the user-friendly title that appears on the device below the app icon. This setting applies to all device platforms.
To set different display names for each platform, you need to modify the required configuration files.
  • If you want to publish a Windows Phone 8.1 app in the Windows Phone Store, this must be the App name for your app as listed in the Windows Phone Store.
  • If not set, AppBuilder sets the app name as the display name.
  • If you have set the iOS display name in AppBuilder 1.11.x or earlier, AppBuilder sets this value for the display name.
Description The description of the app. This property is applicable only to Windows Phone.
Supported interface orientation The supported interface orientation (portrait and landscape) toggles the availability of these modes on the devices running your app. For example: if only portrait is enabled, your app will never go into landscape view on the device.
You cannot review changes in the supported interface orientation in the Cordova developer app.
By default, both portrait and landscape orientation are enabled.

* When you change the target Apache Cordova version of your app to Apache Cordova 6.4.0, you will actually develop against Apache Cordova 4.3.1 for iOS, Apache Cordova 6.1.0 for Android and Apache Cordova 3.8.2 for Windows Phone.

** When you change the target Apache Cordova version of your app to Apache Cordova 5.2.0, you will actually develop against Apache Cordova 4.2.0 for iOS, Apache Cordova 5.2.1 for Android and Apache Cordova 3.8.2 for Windows Phone.
In this version of AppBuilder, support for Apache Cordova 5.2.0 is experimental. Migrations between Apache Cordova versions have not been verified and you might experience multiple issues when working against Apache Cordova 5.2.0.
When working with Apache Cordova 5.2.0, keep in mind that you might need to modify your code due to breaking changes in the APIs.
Apache Cordova 5.2.0 will become fully supported in a future release of AppBuilder.

*** When you change the target Apache Cordova version of your app to Apache Cordova 5.0.0, you will actually develop against Apache Cordova 4.0.1 for iOS, Apache Cordova 5.1.0 for Android and Apache Cordova 3.8.2 for Windows Phone.

**** When you change the target Apache Cordova version of your app to Apache Cordova 4.0.0, you will actually develop against Apache Cordova 3.8.0 for iOS, Apache Cordova 4.1.1 for Android and Apache Cordova 3.8.0 for Windows Phone.

CLI

Option Description Additional Comments
FrameworkVersion This is the version of the hybrid application wrapper for the app. When you change the target Apache Cordova version, keep in mind that you might need to upgrade or downgrade any integrated or custom plugins and you might need to modify your code because of modified or deprecated APIs. AppBuilder might also need to reload your app. None*
AppName This is the name that identifies the current app with the build services. None
AppGuid The unique identifier for your app. Do not modify this property.
AppIdentifier The application identifier uniquely identifies an app on both iOS, Windows Phone and Android devices and in their respective application stores.
The application identifier must consist of one or more alphanumeric strings, separated by a dot. The strings must be valid uniform type identifiers (UTIs), containing letters, numbers, hyphens, underscores or periods.
  • Not to be confused with App ID—the unique identifier used to connect Telerik Platform services to the app.
  • For Android, you can manually set this property in the AndroidManifest.xml and config.xml files. If the value is identical across both configuration files, AppBuilder will build the application package with the identifier from the configuration files. If the value does not match in both configuration files or it is not modified, AppBuilder will build the application package with the identifier configured in the properties for your app.
DisplayName The display name is the user-friendly title that appears on the device below the app icon. This setting applies to all device platforms.
To set different display names for each platform, you need to modify the required configuration files.
  • If you want to publish a Windows Phone 8.1 app in the Windows Phone Store, this must be the App name for your app as listed in the Windows Phone Store.
  • If not set, AppBuilder sets the app name as the display name.
Description The description of the app. This property is applicable only to Windows Phone.
Author The name of the application author.
  • This property is applicable only to Windows Phone.
  • If not set, AppBuilder sets your user name as the author name.
BundleVersion This property sets the current version of the application visible to the user. You need to change it for every new release of the app that you want to distribute publicly. The version must consist of two or three numbers, separated with a dot (.).
  • For iOS application packages, this sets the CFBundleShortVersionString key in Info.plist.
  • For Windows Phone 8.1 application packages, always increase this property before re-deploying the package on device. Otherwise, your changes will not be updated on the device.
DeviceOrientations This toggles the availability of portrait or landscape mode on the devices running your app. For example, if only portrait is enabled, your app will never go into landscape view on the device.
You cannot review changes in the supported interface orientation in the Cordova developer app.
By default, both portrait and landscape orientation are enabled.

  • When you change the target Apache Cordova version of your app to Apache Cordova 6.4.0, you will actually develop against Apache Cordova 4.3.1 for iOS, Apache Cordova 6.1.0 for Android and Apache Cordova 3.8.2 for Windows Phone.
  • When you change the target Apache Cordova version of your app to Apache Cordova 5.2.0, you will actually develop against Apache Cordova 4.2.0 for iOS, Apache Cordova 5.2.1 for Android and Apache Cordova 3.8.2 for Windows Phone.
    In this version of AppBuilder, support for Apache Cordova 5.2.0 is experimental. Migrations between Apache Cordova versions have not been verified and you might experience multiple issues when working against Apache Cordova 5.2.0.
    When working with Apache Cordova 5.2.0, keep in mind that you might need to modify your code due to breaking changes in the APIs.
    Apache Cordova 5.2.0 will become fully supported in a future release of AppBuilder.
  • When you change the target Apache Cordova version of your app to Apache Cordova 5.0.0, you will actually develop against Apache Cordova 4.0.1 for iOS, Apache Cordova 5.1.0 for Android and Apache Cordova 3.8.2 for Windows Phone.
  • When you change the target Apache Cordova version of your app to Apache Cordova 4.0.0, you will actually develop against Apache Cordova 3.8.0 for iOS, Apache Cordova 4.1.1 for Android and Apache Cordova 3.8.0 for Windows Phone.

See Also

Start a free trial Request a demo
Contact us: +1-888-365-2779
sales@telerik.com
Copyright © 2016-2017, Progress Software Corporation and/or its subsidiaries or affiliates. All rights reserved.