AppBuilder 3.2 Release Notes

Product version: AppBuilder 3.2

Released: April 13, 2016

Major Features and Updates

This release of AppBuilder introduces the following major feature across the AppBuilder clients:

  Feature In-Browser Client Windows Client Extension for Visual Studio Command-Line Interface
Hybrid Development The templates and the samples now target Apache Cordova 4.0.0*
  Develop Android apps with Apache Cordova 5.1.0 (Experimental)**
  Deprecated support for Apache Cordova 3.5.0
  Removed support for Apache Cordova 2.7.0, 3.0.0, and 3.2.0
  Switch between Debug and Release build configurations in the device simulator
  Develop with files which are both configuration- and platform-specific
  Improved server-side updates of Apache Cordova***
NativeScript Development Develop apps with NativeScript 1.7.1
  Deprecated support for NativeScript 1.5.2
  Removed support for NativeScript 1.1.2, 1.2.3, and 1.4.3
  Develop with files which are both configuration- and platform-specific
  LiveSync changes to application packages over the air
  LiveSync changes to application packages over cable Not Applicable
  Hardware acceleration is enabled for Android apps, by default

* Hybrid Development: The templates and the samples now target Apache Cordova 4.0.0
Newly created projects now target Apache Cordova 3.8.0 for iOS, Apache Cordova 4.1.1 for Android and Apache Cordova 3.8.0-2 for Windows Phone.

** Hybrid Development: Develop Android apps with Apache Cordova 5.1.0 (Experimental)
When you migrate your project to target Apache Cordova 5.0.0 (Experimental), you will actually develop with Apache Cordova 5.1.0 for Android, Apache Cordova 4.0.1 for iOS, and Apache Cordova 3.8.2 for Windows Phone. If your app already targets Apache Cordova 5.0.0 (Experimental), you need to migrate your project to Apache Cordova 4.0.0 and back to Apache Cordova 5.0.0 again for the change to be reflected in cordova.android.js.

*** Hybrid Development: Improved server-side updates of Apache Cordova
Occasionally, the AppBuilder team introduces minor updates to the list of currently supported Apache Cordova versions. For example, AppBuilder 3.1.2 updated the currently supported Apache Cordova 4.0.0 version to let you develop using Apache Cordova 4.1.1 for Android. Previously, you needed to perform manual steps to upgrade your project to use the update. Now, when a similar minor update is introduced for the target Apache Cordova version that your app is using, on your next build, AppBuilder will include the updated framework files in your application package. You will not need to perform any additional steps to apply the update to your app.

Top of Page

Announcements

  • This release of AppBuilder introduces the new Platform companion app. In a future release, the side menu in the Cordova developer app and the NativeScript developer app will be removed and you will need to use the Platform companion app to test and manage your apps in the framework-specific companion apps.
  • This release of AppBuilder lays the groundwork for the following major features, which will become available in a future release:
    • Configure your project to work against several custom environments. For example: a staging environment and a production environment.
    • Develop your Ionic-based projects with AppBuilder.
  • Recently, Google has announced that all hybrid applications must update to Apache Cordova 4.1.1 or later before May 9, 2016. Beginning May 9, 2016, Google Play will block publishing of any new apps or updates that use pre-4.1.1 versions of Apache Cordova. If you are planning to publish a new app or update an existing app after that timeframe, make sure to migrate your app to Apache Cordova 4.0.0.

Top of Page

Breaking Changes

Hybrid Development

Warning Deprecated support for Apache Cordova 3.5.0. You can no longer change the target Apache Cordova version to 3.5.0. You will still be able to develop and build existing apps that target Apache Cordova 3.5.0.
Support for Apache Cordova 3.5.0 will be removed in a future release.

Warning Removed support for Apache Cordova 2.7.0, 3.0.0, and 3.2.0. You can no longer build your project against Apache Cordova 2.7.0, 3.0.0, and 3.2.0. To resolve the issue, migrate to a newer supported Apache Cordova version.

Warning The companion apps for hybrid development now target Apache Cordova 4.0.0. After you update the companion app, you will begin to see warnings if your app does not target Apache Cordova 4.0.0. You can ignore the warnings and continue testing your app but it might no longer behave as expected.

Warning The iOS companion app for hybrid development now extracts application files to new locations. To be able to properly LiveSync changes over cable, you need to update the companion app and reload your app inside it.

Warning The Android companion app now requires Android 4.0 or later. You will no longer be able to test your apps on earlier Android devices in the companion app.

Warning AppBuilder now includes the server-side framework files for your target Apache Cordova version in your application package instead of the ones locally stored in your project. If your local framework files and the server-side ones differ in any way, you might experience issues when debugging your app on device with the built-in Microsoft Visual Studio debug tools.

Warning AppBuilder no longer provides support for working with Android 2.x devices. You can deploy your Android apps only on Android 4.0 or later devices.

NativeScript Development

Warning After you update your app to target NativeScript 1.7.1, you might no longer be able to run it on iOS devices because application.start now accepts a parameter for the main module instead of declaring it explicitly. For more information, see Application Lifecycle in the NativeScript Documentation.

Warning After you update your app to target NativeScript 1.7.1, you can no longer debug on Android devices using the Microsoft Visual Studio debug tools.

Warning When you update your app to target NativeScript 1.7.1, you might experience multiple issues due to breaking changes in the APIs. For more information about the major changes in NativeScript 1.7.1, see Cross-Platform Modules Changelog, NativeScript CLI Changelog, iOS Runtime Changelog and Android Runtime Changelog.

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

Warning Removed support for NativeScript 1.1.2, 1.2.3 and 1.4.3. You can no longer build your project against NativeScript 1.1.2, 1.2.3 and 1.4.3. To resolve the issue, migrate to the latest supported NativeScript version.

Warning The iOS companion app for NativeScript development now extracts application files to new locations. To be able to properly LiveSync changes over cable, you need to update the companion app and reload your app inside it.

Warning AppBuilder no longer provides support for working with iOS 7.x devices. You can deploy your iOS apps only on iOS 8.0 or later devices.

Top of Page

Features and Updates in the In-Browser Client

This release of AppBuilder introduces the following features and improvements in the in-browser client.

  • Personalize the code formatting rules for JavaScript code with a .jsbeautifyrc file.
  • Improved behavior when working with outdated integrated Apache Cordova plugins.
  • The Manage Packages wizard shows the supported target framework versions for Telerik Verified Plugins Marketplace plugins.
  • Replace your code and assets with the contents of a remote repository.
  • Run the UI designer tool from RunKendo UI Designer.
  • Multiple improvements when you develop with TypeScript.
  • Multiple improvements in the code editor.
    • You can drag and drop the open file tabs to reorder them.
    • You can click ROW: or COL: at the bottom to toggle the Go To Line dialog.
    • You can split the code editor vertically by right-clicking the tab of a currently open file and selecting Split Vertically. Any additional files will be opened in the currently active editor pane. If you close all open files in a pane, the pane will close as well.
      You can move files to the pane on the left of the current pane by right-clicking the tab of the file and selecting Move to Left Pane.

Top of Page

Features and Updates in the Extension for Visual Studio

This release of AppBuilder introduces the following features and improvements in the extension for Visual Studio.

Top of Page

Features and Updates in the Command-Line Interface and the Package for Sublime Text

This release of AppBuilder introduces the following improvements in the command-line interface and package for Sublime Text.

  • The command-line interface prints information about installed or available plugins and their variables when you run the following commands:

    appbuilder plugin
    appbuilder plugin --available
    appbuilder plugin add --available
    

Top of Page

Features and Updates in the Companion Apps

This release of AppBuilder introduces the Platform companion app. It provides finer control over the Cordova developer app and the NativeScript developer app.

  • You can log into your account and review your current apps in progress.
  • You can load any of your apps in its respective framework-specific developer app from the menu of available apps.
  • You can load any app in its respective framework-specific developer app by scanning a valid QR code.
  • You can view the logs for each of the apps you have run in }a respective framework-specific developer app.
  • You can test your apps in a release or a debug build configuration.
  • You can configure various settings for the framework-specific developer apps.
  • You can check the framework versions of the currently installed framework-specific developer app.
  • You can check the plugins and modules that you can test in the currently installed framework-specific developer app.

You still need to have the Cordova developer app or the NativeScript developer app installed on your device to test an app for the Apache Cordova or NativeScript frameworks, respectively.

This release of AppBuilder introduces the following features and improvements in the Cordova developer apps.

This release of AppBuilder introduces the following features and improvements in the NativeScript developer apps.

  • Test apps developed with NativeScript 1.7.1 in the NativeScript developer app for iOS.
  • Test apps developed with Telerik UI for NativeScript Pro in the NativeScript developer apps.
  • Test apps developed with Analytics in the NativeScript developer apps.
  • The companion apps for NativeScript development no longer provide the Cuteness app as a sample loaded application.
  • The companion apps for NativeScript development now respect build configurations.

Top of Page

Other Features and Updates

  • You can now use the Custom URL Scheme verified plugin on Windows Phone.

Top of Page

Notable Resolved Issues

This release of AppBuilder introduces the following notable resolved issues.

Functional Area Notable Resolved Issues
Frameworks
  • If your project targets Apache Cordova 5.0.0 (Experimental), on iOS devices, the display name and the app icon might not appear as expected.
Mobile Devices and Platforms
  • When you debug on a connected Android device, you cannot modify the styles for your app. All changes to CSS in the debugger are reset on Enter.
  • When you debug on a connected iOS device, the debug tools do not show CSS selectors properly. CSS selectors appears as [object Object].
  • When you pin your Windows Phone app to the start screen, the app icon might not appear properly. A blank square might be shown.
  • If your project targets Apache Cordova 5.0.0 (Experimental), on iOS devices, the display name and the app icon might not appear as expected.
  • When you debug on iOS devices, you cannot use the WebKit Inspector right-click context menus.
In-Browser Client
  • When you open a file in the code editor in Safari, a script error might be logged in the output.
Windows Client
  • When you debug on a connected Android device, you cannot modify the styles for your app. All changes to CSS in the debugger are reset on Enter.
  • When you debug on a connected iOS device, the debug tools do not show CSS selectors properly. CSS selectors appears as [object Object].
  • When you debug on iOS devices, you cannot use the WebKit Inspector right-click context menus.
  • Source mapping does not work in the device simulator.
  • Apps with an enabled integrated Progress Analytics plugin throw errors in the device simulator.
  • The classic Windows desktop client might not save properly NativeScript plugin dependencies added from the Manage Packages wizard. This might cause build errors.
  • You cannot test the Progress Analytics, Telerik Mobile Testing, and Progress AppFeedback plugins in the device simulator.
  • Sometimes, installing a NativeScript dependency from the Manage Packages wizard might override previously added dependencies.
Extension for Visual Studio
  • When you debug on a connected Android device, you cannot modify the styles for your app. All changes to CSS in the debugger are reset on Enter.
  • When you debug on a connected iOS device, the debug tools do not show CSS selectors properly. CSS selectors appears as [object Object].
  • When you debug on iOS devices, you cannot use the WebKit Inspector right-click context menus.
  • Source mapping does not work in the device simulator.
  • Apps with an enabled integrated Progress Analytics plugin throw errors in the device simulator.
  • When the same plugin is enabled multiple times with different versions in your project (for example, for different build configurations), the Project Properties might not load. The following error message might appear: An item with the same key has already been added.
  • You cannot test the Progress Analytics, Telerik Mobile Testing, and Progress AppFeedback plugins in the device simulator.
  • Sometimes, installing a NativeScript dependency from the Manage Packages wizard might override previously added dependencies.
Command-Line Interface
  • When you debug on a connected Android device, you cannot modify the styles for your app. All changes to CSS in the debugger are reset on Enter.
  • When you debug on a connected iOS device, the debug tools do not show CSS selectors properly. CSS selectors appears as [object Object].
  • When you debug on iOS devices, you cannot use the WebKit Inspector right-click context menus.
  • Source mapping does not work in the device simulator on Windows systems.
  • Apps with an enabled integrated Progress Analytics plugin throw errors in the device simulator.
  • You cannot test the Progress Analytics, Telerik Mobile Testing, and Progress AppFeedback plugins in the device simulator.
  • When you load an app in the NativeScript developer app for Android over cable, your app files are copied twice on the Android device.
Companion Apps
  • In the companion app for Android, you cannot test custom functionality for the Back button.
  • When you load an app in the NativeScript developer app for Android over cable, your app files are copied twice on the Android device.

Top of Page

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.