应用程序的很多行为可以在config.xml文件中进行设置。
如果你是通过CLI创建的应用程序,你可以在应用程序根目录下找到这个文件。
注意:
3.3及以前版本中,该文件位于www目录下。
使用CLI编译应用程序时,该根目录下的config.xml文件中对应的配置内容会被复制到各自对应的平台目录下的config.xml文件中,比如项目的名称等。
Android平台对应的文件路径为:app/platforms/android/res/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="dev@cordova.apache.org" 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只针对特定平台有效;而有些则是针对多种平台有效的。
一些设置对所有平台有效:
1)Fullscreen设置程序是否全屏。全屏时状态栏将不可见,默认为false。
<preferencename="Fullscreen" value="true" />
2)Orientation设置可以让你锁定应用程序屏幕方向以阻止屏幕自动翻转。可选的值有:default,landscape,portrait。
<preferencename="Orientation" value="landscape" />
注意:default表示landscape和portrait均可用。如果你想针对不同的平台进行不同的设置,请将此配置节从根目录下的config.xml中移除。
多平台首选项只的是该配置针对不止一个平台有效,但是并非对所有平台有效。
1)DisallowOverscroll设置当用户将内容拖拽到超过屏幕起始或结束位置时,是否产生反馈效果,默认为false。针对IOS和Android平台有效。(理解不是特别准确,应该是类似于Android中下拉更新的那种效果吧)
<preferencename="DisallowOverscroll" value="true"/>
2)BackgroundColor设置应用程序背景色。四部分组成,第一部分是透明度,后三个依次为红绿蓝。针对Android和Blackberry有效。如果要跨平台可以使用css样式:body{background-color:blue}
<preferencename="BackgroundColor" value="0xff0000ff"/>
如果你通过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了。
请参考官方文档获取更多关于配置文件的信息。
原文:http://blog.csdn.net/zythy/article/details/21821481