Edit Configuration Files

Filter by IDE
Select the 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 configuration files for your app. In AppBuilder, you can modify AndroidManifest.xml and Info.plist, when you develop for NativeScript.

Do not edit or remove 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 and iOS background mode in the corresponding configuration files. You can modify these settings in the app properties and when you issue a build, AppBuilder fills 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.

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
    Android Manifest Configure system settings for your Android app. For more information about the settings that you can configure, see Android Manifest.
    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.

    The selected file opens in the code editor.

  3. Edit the configuration file.
  4. (Optional) Repeat Steps 1-3 for every configuration file that you want to edit.
  5. Press Ctrl+Shift+S to 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
    Android Manifest Configure system settings for your Android app. For more information about the settings that you can configure, see Android Manifest.
    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.

    The selected file opens in the code editor.

  3. Edit the configuration file.
  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
    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.
    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.

    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.
  4. Press Ctrl+Shift+S to save all changes.

CLI

  1. Run the following command.

    appbuilder edit-configuration <Configuration File>
    

    Where <Configuration File> is ios-info for Info.plist or android-manifest for AndroidManifest.xml.

    Option Location Description
    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.
    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.

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

  2. Edit the configuration file.
  3. Save all changes.
  4. 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.

You cannot test your configuration changes in the Cordova developer app.

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.