Edit Configuration Files

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

IDE

To configure app settings that are not available in the Properties dialog, you can edit the contents of the configuration files for your app. In AppBuilder, you can modify AndroidManifest.xml, Info.plist, WMAppManifest.xml and config.xml.

Avoid editing or removing placeholders in the following format: $string$. During the build process AppBuilder replaces such placeholders with their correct values for the corresponding setting. If you modify the placeholders, AppBuilder might not be able to build your app or your app might not run properly on device.

You do not need to manually configure device orientation, device families, display name, Android permissions, iOS status bar style, iOS background mode and Windows Phone capabilities in the corresponding configuration files. You can modify these settings in the app properties and when you issue a build, AppBuilder will fill in the values for the settings in the configuration files. For more information, see Configure your app.

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.
  • Verify that the changes you want to make are supported by the target Apache Cordova version.

Procedure

In-Browser

  1. In the Project Navigator, right-click the second node from the top and select Edit Configuration.
  2. Select the configuration file that you want to edit.
    Option Description
    Windows Phone Manifest Configure system settings for your Windows Phone app. For more information about the settings that you can configure, see App manifest file for Windows Phone.
    Windows Phone Config.xml Configure Apache Cordova settings that are specific to Windows Phone apps. For more information about the Windows Phone settings that you can configure in config.xml, see The config.xml File.
    Android Manifest Configure system settings for your Android app. For more information about the settings that you can configure, see Android Manifest.
    Android Config.xml Configure Apache Cordova settings that are specific to Android apps. For more information about the Android settings that you can configure in config.xml, see App Settings for Android in the Apache Cordova Documentation.
    iOS Info.plist Configure system settings for your iOS app. For more information about the settings that you can configure, see Information Property List Key Reference.
    iOS Config.xml Configure Apache Cordova settings that are specific to iOS apps. For more information about the iOS settings that you can configure in config.xml, see App Settings for iOS in the Apache Cordova Documentation.
    The selected file opens in the code editor.
  3. Edit the configuration file.
    If you want to modify config.xml, make sure that your changes are supported by the target Apache Cordova version.
  4. (Optional) Repeat Steps 1-3 for every configuration file that you want to edit.
  5. Press Ctrl+Shift+S to save all changes.

Universal

  1. In the Project Navigator, right-click the second node from the top and select Edit Configuration.
  2. Select the configuration file that you want to edit.
    Option Description
    Windows Phone Manifest Configure system settings for your Windows Phone app. For more information about the settings that you can configure, see App manifest file for Windows Phone.
    Windows Phone Config.xml Configure Apache Cordova settings that are specific to Windows Phone apps. For more information about the Windows Phone settings that you can configure in config.xml, see The config.xml File.
    Android Manifest Configure system settings for your Android app. For more information about the settings that you can configure, see Android Manifest.
    Android Config.xml Configure Apache Cordova settings that are specific to Android apps. For more information about the Android settings that you can configure in config.xml, see App Settings for Android in the Apache Cordova Documentation.
    iOS Info.plist Configure system settings for your iOS app. For more information about the settings that you can configure, see Information Property List Key Reference.
    iOS Config.xml Configure Apache Cordova settings that are specific to iOS apps. For more information about the iOS settings that you can configure in config.xml, see App Settings for iOS in the Apache Cordova Documentation.
    The selected file opens in the code editor.
  3. Edit the configuration file.
    If you want to modify config.xml, make sure that your changes are supported by the target Apache Cordova version.
  4. (Optional) Repeat Steps 1-3 for every configuration file that you want to edit.
  5. Save all changes.

Windows

  1. In the Project Navigator, right-click the second node from the top and select Edit Configuration.
  2. Select the configuration file that you want to edit.
    Option Description
    Windows Phone Manifest Configure system settings for your Windows Phone app. For more information about the settings that you can configure, see App manifest file for Windows Phone.
    Windows Phone Config.xml Configure Apache Cordova settings that are specific to Windows Phone apps. For more information about the Windows Phone settings that you can configure in config.xml, see The config.xml File.
    Android Manifest Configure system settings for your Android app. For more information about the settings that you can configure, see Android Manifest.
    Android Config.xml Configure Apache Cordova settings that are specific to Android apps. For more information about the Android settings that you can configure in config.xml, see App Settings for Android in the Apache Cordova Documentation.
    iOS Info.plist Configure system settings for your iOS app. For more information about the settings that you can configure, see Information Property List Key Reference.
    iOS Config.xml Configure Apache Cordova settings that are specific to iOS apps. For more information about the iOS settings that you can configure in config.xml, see App Settings for iOS in the Apache Cordova Documentation.
    The selected file opens in the code editor.
  3. Edit the configuration file.
    If you want to modify config.xml, make sure that your changes are supported by the target Apache Cordova version.
  4. (Optional) Repeat Steps 1-3 for every configuration file that you want to edit.
  5. Press Ctrl+Shift+S to save all changes.

Visual Studio

  1. In the Solution Explorer, right-click the project node and select Edit Configuration.
  2. Select the configuration file that you want to edit.
    Option Location Description
    Windows Phone Manifest App_Resources/WP8 Configure system settings for your Windows Phone app. For more information about the settings that you can configure, see App manifest file for Windows Phone.
    Windows Phone Config.xml App_Resources/WP8 Configure Apache Cordova settings that are specific to Windows Phone apps. For more information about the Windows Phone settings that you can configure in config.xml, see The config.xml File.
    Android Manifest App_Resources/Android Configure system settings for your Android app. For more information about the settings that you can configure, see Android Manifest.
    Android Config.xml App_Resources/Android/xml Configure Apache Cordova settings that are specific to Android apps. For more information about the Android settings that you can configure in config.xml, see App Settings for Android in the Apache Cordova Documentation.
    iOS Info.plist App_Resources/iOS Configure system settings for your iOS app. For more information about the settings that you can configure, see Information Property List Key Reference.
    iOS Config.xml App_Resources/iOS Configure Apache Cordova settings that are specific to iOS apps. For more information about the iOS settings that you can configure in config.xml, see App Settings for iOS in the Apache Cordova Documentation.
    If needed, the extension for Visual Studio creates and adds the selected file to your app. The selected file opens in the code editor.
  3. Edit the configuration file.
    If you want to modify config.xml, make sure that your changes are supported by the target Apache Cordova version.
  4. Press Ctrl+Shift+S to save all changes.

CLI

  1. In the command prompt, navigate to the directory that contains your app.
  2. Run the following command.

    appbuilder edit-configuration <Configuration File>
    
    <Configuration File> Location Description
    wp8-manifest App\_Resources/WP8/WMAppManifest.xml Configure system settings for your Windows Phone app. For more information about the settings that you can configure, see App manifest file for Windows Phone.
    wp8-config App\_Resources/WP8/config.xml Configure Apache Cordova settings that are specific to Windows Phone apps. For more information about the Windows Phone settings that you can configure in `config.xml`, see The config.xml File.
    android-manifest App\_Resources/Android/AndroidManifest.xml Configure system settings for your Android app. For more information about the settings that you can configure, see Android Manifest.
    android-config App\_Resources/Android/xml/config.xml Configure Apache Cordova settings that are specific to Android apps. For more information about the Android settings that you can configure in `config.xml`, see App Settings for Android in the Apache Cordova Documentation.
    ios-info App\_Resources/iOS/Info.plist Configure system settings for your iOS app. For more information about the settings that you can configure, see Information Property List Key Reference.
    ios-config App\_Resources/iOS/config.xml Configure Apache Cordova settings that are specific to iOS apps. For more information about the iOS settings that you can configure in `config.xml`, see App Settings for iOS in the Apache Cordova Documentation.

    The selected file opens in the default text editor for your system.

  3. Edit the configuration file.
  4. Save all changes.
  5. Return to the command prompt.

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.