Join the social network of Tech Nerds, increase skill rank, get work, manage projects...
  • config.xml file in PhoneGap

    • 0
    • 3
    • 3
    • 1
    • 0
    • 0
    • 0
    • 0
    • 616
    Comment on it


    Today we will discuss in details about the config.xml file in PhoneGap

    The config.xml file allows developers to specify metadata about their application. To load the config.xml file correctly it should be at the top level of the application i.e. same as index.html file.

    Essential Properties

    1. widget: It helps to identify that you are following the W3C specification. It must be the root of the XML document.The widget element has following attributes:

      id: The unique identifier of the application. To support all platforms it must be reverse-domain name style

      version: Full Version number expressed in major/minor/patch notation

      version code: To specify alternative versions. (versin code for Android & CFBudleVersion for iOS.

    2. name: The name of the application as it appears on the device's home screen and within app-store.

    3. description: A description for your application.

    Platform Build Selection

    If we only want to build the Application for certain platforms we can specify the platforms with the gap:platform tag.

    gap:platform: You can have zero or more of these elements in config.xml. By default all platforms will be built.

    name: platform to build (android,iOs,blackberry etc)


    You can have zero or more of preference elements in config.xml. The attributes for the element are name and value. gap:config-file has following attributes:

    platform: iOS/android
    overwrite: true(overwrite the default array)/ false(merge with default array)

    Icons and Splash Screens

    To define the platform specific icons instead of default icons icon element is used. You can have zero or more of these elements in config.xml. By default PhoneGap logo is used. It has following attributes:

    src: location of image file
    width: in pixels
    height: in pixels

    The default icon must be named icon.png and must reside in the root of the application folder

    splash screens : To define the platform specific splash screens instead of default gap:splash is used.This element can have src, gap:platform,width and height attribute

    Custom URL Schemes

    gap:url-scheme Your app can have many url-scheme elements present.


    The feature element can be used to specify which features your application is using.

    Sample Config.xml file

    <widget id="" version="0.0.1"><name>diamdirect</name><description>
            A sample Apache Cordova application that responds to the deviceready event.
        </description><author email="" href="">
            Apache Cordova Team
        </author><content src="index.html"/><access origin="*"/></widget>

 0 Comment(s)

Sign In

Sign up using

Forgot Password
Fill out the form below and instructions to reset your password will be emailed to you:
Reset Password
Fill out the form below and reset your password: