Release History

AppBuilder v3.1

January 28, 2016

Release Notes

NEW

Major Features and Updates

This release of AppBuilder introduces the following major features and updates across the AppBuilder clients. For a complete list, see Release Notes for AppBuilder 3.1 in the official .

	Feature	In-Browser Client	Windows Client	Extension for Visual Studio	Command-Line Interface
Hybrid Development	Develop apps with Apache Cordova 4.0.0 (Verified)*
	Develop with Apache Cordova 5.0.0 (Experimental)**
	Use .abignore to determine the contents of your built application
	The Telerik Analytics, Telerik Mobile Testing and Telerik AppFeedback are available only as verified plugins
	For non-mandatory AppManager LiveSync updates, your users can choose to not be asked again to update
	Your users cannot cancel active downloads of mandatory AppManager LiveSync updates
	AppManager LiveSync-enabled apps now check for updates on app start and after resume from background
NativeScript Development	Develop apps with NativeScript 1.5.2
	Develop with plugins which require plugin variables
	Deprecated support for NativeScript 1.1.2, 1.2.3 and 1.4.3
	Removed support for NativeScript 0.10.0 and 1.0.1

* Hybrid Development: Develop apps with Apache Cordova 4.0.0
This version of AppBuilder introduces verified support for Apache Cordova 3.8.0 for iOS, Apache Cordova 3.8.0-2 for Windows Phone and Apache Cordova 4.0.2 for Android.
When you migrate to Apache Cordova 4.0.0, keep in mind that you might need to modify your code due to breaking changes in the APIs. For more information about how to migrate to a newer version of Apache Cordova, see Configure the Target Apache Cordova Version.

* Hybrid Development: Develop with Apache Cordova 5.0.0 (Experimental)
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.0.0 for Android and Apache Cordova 3.8.2 for Windows Phone.
In this version of AppBuilder, support for Apache Cordova 5.0.0 is experimental. Migrations between Apache Cordova versions have not been verified and you might experience multiple issues when working against Apache Cordova 5.0.0. For more information about how to migrate to a newer version of Apache Cordova, see Configure the Target Apache Cordova Version.
When working with Apache Cordova 5.0.0, keep in mind that you might need to modify your code due to breaking changes in the APIs.
Apache Cordova 5.0.0 will become fully supported in a future release of AppBuilder.

---

FIXED

Notable Resolved Issues

This release of AppBuilder introduces the following notable resolved issues.

Functional Area	Notable Resolved Issues
General	After you delete an app and create a new one with the same name, the in-browser client loads the deleted app instead of the new one. You might not be able to open the app resources. The in-browser client caches the currently open app. If you delete an app and create a new one with the same name during the same browser session, the in-browser client loads the cached app. You cannot cancel long running operations.
Apache Cordova Plugins	The AppBuilder clients show incorrect links to the documentation of the Apache Cordova core plugins. If your project contains the latest versions of both the Telerik Push Notifications plugin and the AdMob plugin from the Telerik Verified Plugins Marketplace, you cannot build for Android. You cannot build your app for Android, if your project contains both the latest version of the Push Plugin and the Local Notifications plugins. AppManager LiveSync-enabled apps which use the WKWebView for iOS, do not update properly.
Frameworks	When you build your NativeScript project for iOS, the application package does not contain the following required images: icon-60@3x.png, icon-40@3x.png, Default-667h.png, Default-736h.png, Default-Landscape-667h.png, Default-Landscape-736h.png and includes the following additional image: LaunchImage-700-568h@2x.png.
Mobile Devices and Platforms	When you build your NativeScript project for iOS, the application package does not contain the following required images: icon-60@3x.png, icon-40@3x.png, Default-667h.png, Default-736h.png, Default-Landscape-667h.png, Default-Landscape-736h.png and includes the following additional image: LaunchImage-700-568h@2x.png. After you LiveSync changes with the three-finger refresh gesture, you can no longer LiveSync changes to this app via cable connection. If your project contains the latest versions of both the Telerik Push Notifications plugin and the AdMob plugin from the Telerik Verified Plugins Marketplace, you cannot build for Android. You cannot build your app for Android, if your project contains both the latest version of the Push Plugin and the Local Notifications plugins. You cannot debug NativeScript apps on iOS devices. AppManager LiveSync-enabled apps which use the WKWebView for iOS, do not update properly.
In-Browser Client	Fixed redirect links to AppManager. You cannot use the device simulator with a mouse on Windows 10 touchscreen devices. You cannot download your apps built for AppManager from the Publish wizard. You cannot zoom the device simulator in Safari.
Universal Desktop Client	After you uninstall universal desktop client (Beta), an AppBuilder-related adb process remains running. This might affect any operations with Android devices or emulators.
Windows Client	You cannot debug NativeScript apps on iOS devices.
Extension for Visual Studio	Breakpoints are never hit for NativeScript 1.4.3 projects in the built-in debug tools of Microsoft Visual Studio. You cannot debug NativeScript apps on iOS devices. After you remove a TypeScript file from your project, you cannot add another TypeScript file with the same name.
Command-Line Interface	You cannot debug NativeScript apps on iOS devices. When you list available iOS emulator devices, the command-line interface does not show the available iOS version. You cannot LiveSync changes continuously to an application package via cable using the `--watch` option.
Companion Apps	Sometimes, if you exit your NativeScript app while you LiveSync changes to the NativeScript companion app for iOS, you might no longer be able to run the companion app.

---

CHANGED

Breaking Changes

Hybrid Development

When you update your app to target Apache Cordova 4.0.0, you might experience multiple issues due to breaking changes in the APIs. For more information about the major changes in Apache Cordova 4.0.0, see the iOS release notes, the Android release notes and the Windows Phone 8 release notes.
In addition, make sure to check the detailed release notes for the plugins that you have enabled in your app.

When you update your app to target Apache Cordova 5.0.0, you might experience multiple issues due to breaking changes in the APIs. For more information about the major changes in Apache Cordova 4.0.0, see the iOS release notes, the Android release notes and the Windows Phone 8 release notes.
In addition, make sure to check the detailed release notes for the plugins that you have enabled in your app.

To debug hybrid mobile apps on Android devices, you now need an active Internet connection.

NativeScript Development

When you update your app to target NativeScript 1.5.2, you might experience multiple issues due to breaking changes in the APIs. For more information about the major changes in NativeScript 1.5.2, see Breaking Changes in NativeScript 1.5.0 and NativeScript Release Notes.

After you update your app to target NativeScript 1.5.2, you can no longer use IntelliSense in the extension for Visual Studio because NativeScript 1.5.0 introduces a breaking change in the XML namespace. To resolve the issue, in your existing XML files, modify the namespace from xmlns="http://www.nativescript.org/tns.xsd" to xmlns="http://schemas.nativescript.org/tns.xsd".

Deprecated support for NativeScript 1.1.2, 1.2.3 and 1.4.3. You can no longer change the target NativeScript version to 1.1.2, 1.2.3 or 1.4.3. You will still be able to develop and build existing apps that target NativeScript 1.1.2, 1.2.3 or 1.4.3.
Support for NativeScript 1.1.2, 1.2.3 or 1.4.3 will be removed in a future release.

Removed support for NativeScript 0.10.0 and 1.0.1. You can no longer build your project against NativeScript 0.10.0 or 1.0.1. To resolve the issue, migrate to the latest supported NativeScript version.