Cordova配置文件简介

Config.xml文件

应用程序的很多行为可以在config.xml文件中进行设置。

如果你是通过CLI创建的应用程序，你可以在应用程序根目录下找到这个文件。

注意：

3.3及以前版本中，该文件位于www目录下。

使用CLI编译应用程序时，该根目录下的config.xml文件中对应的配置内容会被复制到各自对应的平台目录下的config.xml文件中，比如项目的名称等。

Android平台对应的文件路径为：app/platforms/android/res/xml/config.xml

 

Config.xml中的核心元素

以下配置信息出现在项目根目录下的config.xml文件中。这些配置元素会在编译时复制到各个平台对应的config.xml文件中。

<widgetid="com.oserp.hwec" version="0.0.1"xmlns="http://www.w3.org/ns/widgets"xmlns:cdv="http://cordova.apache.org/ns/1.0">

    <name>hwecommerce</name>

    <description>

        A sample Apache Cordova applicationthat responds to the deviceready event.

    </description>

    <authoremail="[e-mail]" href="http://cordova.io">

        App Name

    </author>

    <content src="index.html"/>

    <access origin="*" />

</widget>

1）Widget元素中的Id指定了应用程序的反向域识别码（原名为reverse-domain identifier）。Version命名规则为主版本号.次版本号.修订版本号。

2）Name元素指定了应用程序的正式名称。该名称会出现在设备主页上或者应用程序商店的程序清单中。

3）Description和author元素提供了应用程序描述信息和作者信息。这些信息可能会出现在应用程序商店的程序清单中。

4）Content元素是可选的。该元素指定了应用程序的启动页面，默认为index.html。

5）Access元素定义了应用程序可以与之通讯的外部域。默认*代表可以访问任务外部服务器。

以下设置只允许应用程序访问google主站点：

<accessorigin="http://google.com" />

以下设置值允许应用程序访问google map：

<accessorigin="http://maps.google.com" />

以下设置允许应用程序访问google的所以子站点：

<accessorigin="http://*.google.com" />

6）preference标签用键值对（name/value）的方式进行设置。其中的name不区分大小写。有一些Preference只针对特定平台有效；而有些则是针对多种平台有效的。

全局首选项（Global Preference）

一些设置对所有平台有效：

1）Fullscreen设置程序是否全屏。全屏时状态栏将不可见，默认为false。

<preferencename="Fullscreen" value="true" />

2）Orientation设置可以让你锁定应用程序屏幕方向以阻止屏幕自动翻转。可选的值有：default，landscape，portrait。

<preferencename="Orientation" value="landscape" />

注意：default表示landscape和portrait均可用。如果你想针对不同的平台进行不同的设置，请将此配置节从根目录下的config.xml中移除。

多平台首选项（Multi-Platform Preference）

多平台首选项只的是该配置针对不止一个平台有效，但是并非对所有平台有效。

1）DisallowOverscroll设置当用户将内容拖拽到超过屏幕起始或结束位置时，是否产生反馈效果，默认为false。针对IOS和Android平台有效。（理解不是特别准确，应该是类似于Android中下拉更新的那种效果吧）

<preferencename="DisallowOverscroll" value="true"/>

2）BackgroundColor设置应用程序背景色。四部分组成，第一部分是透明度，后三个依次为红绿蓝。针对Android和Blackberry有效。如果要跨平台可以使用css样式：body{background-color：blue}

<preferencename="BackgroundColor" value="0xff0000ff"/>

Feature元素

如果你通过CLI添加了插件（Plugin），则你可以在平台目录下的config.xml中找到如下类似的配置节：

<widgetid="com.oserp.hwec" version="0.0.1"xmlns="http://www.w3.org/ns/widgets"xmlns:cdv="http://cordova.apache.org/ns/1.0">

   <preference name="loglevel" value="DEBUG" />

   <feature name="App">

       <param name="android-package"value="org.apache.cordova.App" />

   </feature>

   <feature name="Device">

       <param name="android-package"value="org.apache.cordova.device.Device" />

   </feature>

   <feature name="NetworkStatus">

       <param name="android-package"value="org.apache.cordova.networkinformation.NetworkManager" />

   </feature>

结构很明了。如果是IOS平台的，则name就是ios-package了。

请参考官方文档获取更多关于配置文件的信息。