config.xml文件参数分析

在本地项目中添加cordova:http://www.jianshu.com/p/6a16c260851e
创建一个cordova项目:http://www.jianshu.com/p/8773ab98a833
官方文档:http://cordova.apache.org/docs/en/latest/config_ref/index.html

简述:config.xml文件配置项目工程的行文。当CLI创建cordova项目之后就会在根目录中存在一个,当执行cordova plugin add完毕后会在相对应的平台后面自动生成一个,通常情况下是复制根目录下的文件进去的。

参数含义:

  • 根元素widget:
    • id/version为必选项,说明神马的略。
    • iOS平台特有参数ios-CFBundleIdentifier、ios-CFBundleVersion应用版本号,会覆盖version项。
  • AppStore含义参数:
    • name/shortName:名称,出现在AppStore的APP名称上
    • description:描述,出现在AppStore的APP描述上
    • 通常情况下这三个参数都是不会出现在config.xml文件中的,因为大多都会在appst中自定义
  • author:开发者名称及联系方式,如:
<author email="dev@cordova.apache.org" href="http://cordova.io"></author>
  • content:定义了启动APP时使用的HTML文件,默认情况下是index.html。在www的文件目录下。
  • access:外部访问白名单
    • ios9以后,苹果要求所有的应用默认使用ATS
    <access origin='*' allows-arbitrary-loads-for-media='true' allows-arbitrary-loads-in-web-content='true' allows-local-networking='true' />
    <!---以上写法4.5.0版本以后过期---->
    <access origin='https://cordova.apache.org' minimum-tls-version='TLSv1.2' requires-forward-secrecy='true' requires-certificate-transparency='false' />
    
  • allow-navigation:定义webview被访问白名单
  • allow-intent:定义允许APP访问的系统URL
    区分平台配置:
  <platform name="android">
       <allow-intent href="market:*" />
   </platform>
   <platform name="ios">
     <allow-intent href="http://*/*" />
     <allow-intent href="https://*/*" />
     <allow-intent href="tel:*" />
     <allow-intent href="sms:*" />
   </platform>
  • preference

    • AllowInlineMediaPlayback:默认为false。
      如果设置为Yes,则可以让html5在页面内播放视频而不是调用原生视频播放器。同时要在<video>标签内添加playsinline属性,在iOS10之前使用webkit-playsinline属性。
    • AppendUserAgent:如果设置这个属性,那么webview在加载数据的时候,会将这个参数的值拼接在原有的UA后面,如果使用了OverrideUserAgent则这个参数忽略。
    • BackgroundColor:背景颜色,通用属性。支持十六进制颜色
    • BackupWebStorage:备份属性,默认为cloud,其他参数为:none,local.
    • CordovaWebViewEngine:默认为CDVUIWebViewEngine,也就是说默认情况下cordova使用UIWebView来加载页面。当然也可以使用其他自定义插件,但是需要遵循CDVWebViewEngineProtocol这个协议。如果需要提高性能使用WKWebView,可以添加cordova-plugin-wkwebview-engine插件。并在config.xml中做如下配置:
    <feature name="CDVWKWebViewEngine">
    <param name="ios-package" value="CDVWKWebViewEngine" />
    </feature>
    <preference name="CordovaWebViewEngine" value="CDVWKWebViewEngine" />
    
    • CordovaDefaultWebViewEngine:与CordovaWebViewEngine一致,但是如果两个都配置,则与CordovaWebViewEngine为iOS9及以上使用,CordovaDefaultWebViewEngine为iOS8及以下使用。
    • DisallowOverscroll:是否可滚动,默认为false,可以滚动。
    • EnableViewportScale:默认情况下可缩放,如果需要填满视图,不可缩放,可使用如下代码:
    <meta name='viewport' content='width=device-width, initial-scale=1, user-scalable=no' />
    
    • ErrorUrl:如果加载视图发生错误,并配置了这个参数,则使用这个值来展示页面。
    • 与WebView的属性相对应
      • GapBetweenPages
      • KeyboardDisplayRequiresUserAction
      • MediaPlaybackAllowsAirPlay
      • MediaPlaybackRequiresUserAction
      • PageLength
      • PaginationBreakingMode
      • PaginationMode
  • feature 为特定平台添加plugin,或者指定在webview初始化的时候是否初始化plugin

    • 在使用cordova plugin add指令的时候会自动添加。
    <feature name="Device">
     <param name="ios-package" value="CDVDevice" />
     <param name="onload" value="true" />
    </feature>
    
  • platform:为指定平台单独设置属性。

    <platformname="android"><preferencename="Fullscreen"value="true" /></platform>
    
  • <font color=#dd1234>待学习使用</font>

    • edit-config
    • engine:准备过程中需要恢复的平台信息
    • plugin:添加平台时如果使用了 --save参数,就会记录下来
    • variable:
    • hook
    • resource-file
    <plugin name="cordova-plugin-device" spec="^1.1.0">
      <variable name="MY_VARIABLE" value="my_variable_value" /></plugin>
    

    Sample config.xml

    <?xml version='1.0' encoding='utf-8'?>
    <widget id="io.cordova.hellocordova" version="0.0.1" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
    <name>HelloCordova</name>
    <description>
        A sample Apache Cordova application that responds to the deviceready event.
    </description>
    <author email="dev@cordova.apache.org" href="http://cordova.io">
        Apache Cordova Team
    </author>
    <content src="index.html" />
    <plugin name="cordova-plugin-whitelist" spec="1" />
    <access origin="*" />
    <allow-intent href="http://*/*" />
    <allow-intent href="https://*/*" />
    <allow-intent href="tel:*" />
    <allow-intent href="sms:*" />
    <allow-intent href="mailto:*" />
    <allow-intent href="geo:*" />
    <platform name="android">
        <allow-intent href="market:*" />
    </platform>
    <platform name="ios">
        <allow-intent href="itms:*" />
        <allow-intent href="itms-apps:*" />
    </platform>
    </widget>
    
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,847评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,208评论 1 292
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,587评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,942评论 0 205
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,332评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,587评论 1 218
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,853评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,568评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,273评论 1 242
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,542评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,033评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,373评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,031评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,073评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,830评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,628评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,537评论 2 269

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,100评论 18 139
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 170,568评论 25 707
  • Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 46,358评论 6 343
  • Plugin.xml plugin.xml文件定义了你的插件所需的结构和设置。它有几个元素来提供有关你的插件的详细...
    葛高召阅读 1,121评论 0 1
  • 晓风袭冷入湖湘 雨意藏云思蕴酿 节气正指立冬季 厚添衣赏御初寒
    南飞雨燕阅读 218评论 6 33