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

Configure the Web Views

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

IDE

Based on your target Apache Cordova version, you can develop your app to run in the default web view of the operating system or in a pluggable web view. Pluggable web views for iOS and Android are available via Apache Cordova plugins for apps that target Apache Cordova 3.7.0 or later.

Android Web Views

For apps that target Apache Cordova 3.8.0 or earlier, you can develop only for the default web view (WebView).

For apps that target Apache Cordova 4.0.0 or later, you can choose between the default web view and Crosswalk.

The default web view of Android is WebView. It is available across all Apache Cordova framework versions and Android versions. It provides stability and compatibility with Apache Cordova plugins at the expense of limited performance.

Crosswalk is a pluggable web view enabled by an Apache Cordova plugin. It is available for Apache Cordova 4.0.0 and later and Android 4.0 and later. It provides consistent behavior across Android versions and devices and improved performance and HTML5 support at the expense of limited stability and compatibility with other Apache Cordova plugins, increased application package size, and increased memory footprint. For more information about Crosswalk, see the See Also section.

iOS Web Views

For apps that target Apache Cordova 3.7.0 or later, you can choose between the default web view and WKWebView. When you enable WKWebView, AppBuilder automatically enables the respective Apache Cordova plugin to your application based on your Apache Cordova version.

The default web view of iOS 7.x and earlier is UIWebView. It is available across all Apache Cordova framework versions and iOS versions. It provides stability and compatibility with Apache Cordova plugins at the expense of limited performance.

WKWebView is a native web view of iOS 8.0 and later. It is available for Apache Cordova 3.7.0 and later via a custom plugin. It provides significantly improved performance at the expense of limited stability and compatibility with other Apache Cordova plugins.

IMPORTANT: Support for the WKWebView in Apache Cordova is still in its early stages. While this web view provides superior performance, it poses multiple development challenges such as incompatibility with the core Apache Cordova File and Camera APIs. For more information about the WKWebView web view, see the See Also section.

Windows Web Views

Your Windows Phone apps can run only in the default web view for Windows Phone.

Prerequisites

  • Verify that your preferred AppBuilder client is running and you are logged in.
  • Verify that you have opened the code for your app in AppBuilder.
  • If you want to use the Crosswalk web view for Android, verify that you meet the following requirements.
    • Your app targets Apache Cordova 4.0.0 or later.
    • Your Android devices run on Android 4.0 or later.
  • If you want to use the WKWebView web view for iOS, verify that you meet the following requirements.
    • Your app targets Apache Cordova 3.7.0 or later.
    • Your iOS devices run on iOS 8 or later.

Procedure

In-Browser

Configure the Web Views for Android

  1. In the Project Navigator, double-click Properties.
  2. Navigate to the Android tab.
  3. From the Web View drop-down menu, select the web view in which you want your app to run on device.

    Selecting Crosswalk automatically enables the respective Apache Cordova plugin from the Telerik Verified Plugins Marketplace in your app. Once enabled, you can configure the plugin from the Manage Packages wizard.

  4. Wait for the operation to complete.
  5. Close the properties dialog.

Configure the Web Views for iOS

  1. In the Project Navigator, double-click Properties.
  2. Navigate to the iOS tab.
  3. From the Web View drop-down menu, select the web view in which you want your app to run on device.

    Based on your target Apache Cordova version, selecting WKWebView automatically enables the WKWebView plugin or the Cordova WKWebView Engine plugin from the Telerik Verified Plugins Marketplace in your app. Once enabled, you can configure the plugin from the Manage Packages wizard.

  4. Wait for the operation to complete.
  5. Close the properties dialog.

Universal

Configure the Web Views for Android

  1. In the Project Navigator, double-click Properties.
  2. Navigate to the Android tab.
  3. From the Web View drop-down menu, select the web view in which you want your app to run on device.

    Selecting Crosswalk automatically enables the respective Apache Cordova plugin from the Telerik Verified Plugins Marketplace in your app. Once enabled, you can configure the plugin from the Manage Packages wizard.

  4. Wait for the operation to complete.
  5. Close the properties dialog.

Configure the Web Views for iOS

  1. In the Project Navigator, double-click Properties.
  2. Navigate to the iOS tab.
  3. From the Web View drop-down menu, select the web view in which you want your app to run on device.

    Based on your target Apache Cordova version, selecting WKWebView automatically enables the WKWebView plugin or the Cordova WKWebView Engine plugin from the Telerik Verified Plugins Marketplace in your app. Once enabled, you can configure the plugin from the Manage Packages wizard.

  4. Wait for the operation to complete.
  5. Close the properties dialog.

Windows

Configure the Web Views for Android

  1. In the Project Navigator, double-click Properties.
  2. Navigate to the Android tab.
  3. From the Web view drop-down menu, select the web view in which you want your app to run on device.

    Selecting Crosswalk automatically enables the respective Apache Cordova plugin from the Telerik Verified Plugins Marketplace in your app. Once enabled, you can configure the plugin from the Manage Packages wizard.

  4. Save your changes.
  5. Close the dialog.

Configure the Web Views for iOS

  1. In the Project Navigator, double-click Properties.
  2. Navigate to the iOS tab.
  3. From the Web view drop-down menu, select the web view in which you want your app to run on device.

    Based on your target Apache Cordova version, selecting WKWebView automatically enables the WKWebView plugin or the Cordova WKWebView Engine plugin from the Telerik Verified Plugins Marketplace in your app. Once enabled, you can configure the plugin from the Manage Packages wizard.

  4. Save your changes.
  5. Close the dialog.

Visual Studio

Configure the Web Views for Android

  1. In the Project Navigator, double-click Properties.
  2. Navigate to the Android tab.
  3. From the Web view drop-down menu, select the web view in which you want your app to run on device.

    Selecting Crosswalk automatically enables the respective Apache Cordova plugin from the Telerik Verified Plugins Marketplace in your app. Once enabled, you can configure the plugin from the Manage Packages wizard.

  4. Save your changes.
  5. Close the dialog.

Configure the Web Views for iOS

  1. In the Project Navigator, double-click Properties.
  2. Navigate to the iOS tab.
  3. From the Web view drop-down menu, select the web view in which you want your app to run on device.

    Based on your target Apache Cordova version, selecting WKWebView automatically enables the WKWebView plugin or the Cordova WKWebView Engine plugin from the Telerik Verified Plugins Marketplace in your app. Once enabled, you can configure the plugin from the Manage Packages wizard.

  4. Save your changes.
  5. Close the dialog.

CLI

Configure the Web Views for Android

  1. In the command prompt, navigate to the directory that contains your app.
  2. To print the available web views for your app, run the following command.

    appbuilder webview list
    

    This operation also lists the available framework versions.

  3. To change the target framework version for your app, run the following command.

    appbuilder webview set android <Name>
    

    <Name> is the name of the web view as listed in Step 2.

    Selecting Crosswalk automatically enables the respective Apache Cordova plugin from the Telerik Verified Plugins Marketplace in your app. Once enabled, you can configure the plugin with the appbuilder plugin commands.

Configure the Web Views for iOS

  1. In the command prompt, navigate to the directory that contains your app.
  2. To print the current web view and the available web views for your app, run the following command.

    appbuilder webview list
    
  3. To change the target framework version for your app, run the following command.

    appbuilder webview set ios <Name>
    

    <Name> is the name of the web view as listed in Step 2.

    Based on your target Apache Cordova version, selecting WKWebView automatically enables the WKWebView plugin or the Cordova WKWebView Engine plugin from the Telerik Verified Plugins Marketplace in your app. Once enabled, you can configure the plugin with the appbuilder plugin commands.

Next Steps

Run your app on device. If you have already deployed your app on device, you need to re-deploy it for the configuration changes to take effect.

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.