Cordova配置文件常用属性配置分析（config.xml）

妖狐艹你老母 2022-05-27 13:40 244阅读 0赞

混合应用开发的模式，越来越被各大公司热推，凭借其快速迭代，跨平台的特性，已经变得炙手可热， 那个为了能更贴合于Native效果，有更好的用户体验，cordova的配置更是关键，今天就来分析一下cordova常用的配置属性。

首先，我们来看一个配置文件

<?xml version='1.0' encoding='utf-8'?>
    <widget id="com.ionicframework.textdemo529950" version="0.0.1" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
        <name>textDemo</name>
        <description>An awesome Ionic/Cordova app.</description>
        <author email="hi@ionicframework" href="http://ionicframework.com/">Ionic Framework Team</author>
        <content src="http://m.baibaocp.com/index2.php" />
        <allow-navigation href="http://*/*" />
        <allow-navigation href="https://*/*" />
        <access origin="*" />
        <allow-navigation href="http://ionic.local/*" />
        <allow-intent href="http://*/*" />
        <allow-intent href="https://*/*" />
        <allow-intent href="tel:*" />
        <allow-intent href="sms:*" />
        <allow-intent href="mailto:*" />
        <allow-intent href="geo:*" />
        <preference name="webviewbounce" value="false" />
        <preference name="UIWebViewBounce" value="false" />
        <preference name="DisallowOverscroll" value="true" />
        <preference name="android-minSdkVersion" value="16" />
        <preference name="BackupWebStorage" value="none" />
        <preference name="SplashMaintainAspectRatio" value="true" />
        <preference name="FadeSplashScreenDuration" value="300" />
        <preference name="SplashShowOnlyFirstTime" value="false" />
        <preference name="SplashScreen" value="screen" />
        <preference name="SplashScreenDelay" value="3000" />
        <platform name="android">
            <allow-intent href="market:*" />
            <icon density="ldpi" src="resources/android/icon/drawable-ldpi-icon.png" />
            <icon density="mdpi" src="resources/android/icon/drawable-mdpi-icon.png" />
            <icon density="hdpi" src="resources/android/icon/drawable-hdpi-icon.png" />
            <icon density="xhdpi" src="resources/android/icon/drawable-xhdpi-icon.png" />
            <icon density="xxhdpi" src="resources/android/icon/drawable-xxhdpi-icon.png" />
            <icon density="xxxhdpi" src="resources/android/icon/drawable-xxxhdpi-icon.png" />
            <splash density="land-ldpi" src="resources/android/splash/drawable-land-ldpi-screen.png" />
            <splash density="land-mdpi" src="resources/android/splash/drawable-land-mdpi-screen.png" />
            <splash density="land-hdpi" src="resources/android/splash/drawable-land-hdpi-screen.png" />
            <splash density="land-xhdpi" src="resources/android/splash/drawable-land-xhdpi-screen.png" />
            <splash density="land-xxhdpi" src="resources/android/splash/drawable-land-xxhdpi-screen.png" />
            <splash density="land-xxxhdpi" src="resources/android/splash/drawable-land-xxxhdpi-screen.png" />
            <splash density="port-ldpi" src="resources/android/splash/drawable-port-ldpi-screen.png" />
            <splash density="port-mdpi" src="resources/android/splash/drawable-port-mdpi-screen.png" />
            <splash density="port-hdpi" src="resources/android/splash/drawable-port-hdpi-screen.png" />
            <splash density="port-xhdpi" src="resources/android/splash/drawable-port-xhdpi-screen.png" />
            <splash density="port-xxhdpi" src="resources/android/splash/drawable-port-xxhdpi-screen.png" />
            <splash density="port-xxxhdpi" src="resources/android/splash/drawable-port-xxxhdpi-screen.png" />
        </platform>
        <platform name="ios">
            <allow-intent href="itms:*" />
            <allow-intent href="itms-apps:*" />
            <icon height="57" src="resources/ios/icon/icon.png" width="57" />
            <icon height="114" src="resources/ios/icon/icon@2x.png" width="114" />
            <icon height="40" src="resources/ios/icon/icon-40.png" width="40" />
            <icon height="80" src="resources/ios/icon/icon-40@2x.png" width="80" />
            <icon height="120" src="resources/ios/icon/icon-40@3x.png" width="120" />
            <icon height="50" src="resources/ios/icon/icon-50.png" width="50" />
            <icon height="100" src="resources/ios/icon/icon-50@2x.png" width="100" />
            <icon height="60" src="resources/ios/icon/icon-60.png" width="60" />
            <icon height="120" src="resources/ios/icon/icon-60@2x.png" width="120" />
            <icon height="180" src="resources/ios/icon/icon-60@3x.png" width="180" />
            <icon height="72" src="resources/ios/icon/icon-72.png" width="72" />
            <icon height="144" src="resources/ios/icon/icon-72@2x.png" width="144" />
            <icon height="76" src="resources/ios/icon/icon-76.png" width="76" />
            <icon height="152" src="resources/ios/icon/icon-76@2x.png" width="152" />
            <icon height="167" src="resources/ios/icon/icon-83.5@2x.png" width="167" />
            <icon height="29" src="resources/ios/icon/icon-small.png" width="29" />
            <icon height="58" src="resources/ios/icon/icon-small@2x.png" width="58" />
            <icon height="87" src="resources/ios/icon/icon-small@3x.png" width="87" />
            <icon height="1024" src="resources/ios/icon/icon-1024.png" width="1024" />
            <splash height="1136" src="resources/ios/splash/Default-568h@2x~iphone.png" width="640" />
            <splash height="1334" src="resources/ios/splash/Default-667h.png" width="750" />
            <splash height="2208" src="resources/ios/splash/Default-736h.png" width="1242" />
            <splash height="1242" src="resources/ios/splash/Default-Landscape-736h.png" width="2208" />
            <splash height="1536" src="resources/ios/splash/Default-Landscape@2x~ipad.png" width="2048" />
            <splash height="2048" src="resources/ios/splash/Default-Landscape@~ipadpro.png" width="2732" />
            <splash height="768" src="resources/ios/splash/Default-Landscape~ipad.png" width="1024" />
            <splash height="2048" src="resources/ios/splash/Default-Portrait@2x~ipad.png" width="1536" />
            <splash height="2732" src="resources/ios/splash/Default-Portrait@~ipadpro.png" width="2048" />
            <splash height="1024" src="resources/ios/splash/Default-Portrait~ipad.png" width="768" />
            <splash height="960" src="resources/ios/splash/Default@2x~iphone.png" width="640" />
            <splash height="480" src="resources/ios/splash/Default~iphone.png" width="320" />
            <splash height="2732" src="resources/ios/splash/Default@2x~universal~anyany.png" width="2732" />
        </platform>
        <engine name="android" spec="^6.3.0" />
        <plugin name="cordova-plugin-device" spec="^1.1.4" />
        <plugin name="cordova-plugin-console" spec="^1.1.0" />
        <plugin name="cordova-plugin-whitelist" spec="^1.3.1" />
        <plugin name="cordova-plugin-splashscreen" spec="^4.0.3" />
        <plugin name="cordova-plugin-statusbar" spec="^2.2.1" />
        <plugin name="ionic-plugin-keyboard" spec="^2.2.1" />
        <plugin name="jpush-phonegap-plugin" spec="git+https://github.com/jpush/jpush-phonegap-plugin.git">
            <variable name="APP_KEY" value="d2b9f15c3db58ca50edf79c5" />
        </plugin>
    </widget>

下面我从上到下依次来分析：

## 定义项目的package 和版本号 ##

在最外层Widget元素上，我们看到有id=”“, version=”“两个属性，当我们初始化cordova项目上这会有一个默认的配置，但之后我们需要根据需要自己进行配置。

1.  id: 配置好后会自动生成到android的package name 和ios 的bundle id， 也就是说我们不需要再从新根据平台从新指定。
2.  version： 是用来管理我们的版本号，在版本迭代的时候很重，配置好后，会自动动生成在项目里。

## 指定项目的名字，描述，作者信息 ##

除了项目名字，其他的不是特别的重要，项目名字决定了ios和android的工程名字：

<name>MyDemoProject</name>

描述和作者信息自己填写一下就OK了

## 启动路径，跳转访问权限配置 ##

1.  content src 指定了cordova需要默认启动哪个 文件，这个轻易不要篡改。
2.  allow-navigation 决定是了是否允许http, https的网址跳转。
3.  allow-intent 这个用于指定是否允许调用电话拨打功能，在早些版本时候，这个是不需要指定的，但是cordova6.0+以后发现这个电话功能不好用了，配置了这个，才解决问题。

## 禁止webview回弹效果 ##

cordova默认的项目，当滑动时候，在ios设备上会有个回弹效果，对于网站项目这个正常，但是手机app这个是不需要的，而且影响体验，所以我们需要禁止掉这个属性；

## 是否允许后台存储 ##

这个属性我们一定要配置none,否则的后ios会调用icloud存储，这个虽然没有大的影响，但是在发布到apple store的时候可能会因为这个原因，被拒绝掉。

## splash 启动配置 ##

在app启动的时候我们会看到各种启动图片，这个叫splash, 我们需要对此进行配置，前提是我要安装splash插件才能生效的，并且也可配置app的横竖屏，启动页面的持续时间等等。

## 针对平台的设置 ##

对于不同的平台会有不同的设置，比如splash和icon， 因为android 和ios上尺寸是不一样的。

## 插件配置 ##

我们必须要配置的插件通常就是上面几个，白名单用来允许访问https网络，主要是用在android的项目，但是对于最新的cordova应该不需要了。

plugin这个是最新的定义方式，之前我一直在用feature这个属性，但是后来发现被废弃掉了。

指定好这个plugin以后，每次cordova会检查项目是否有这个几个插件，如果没有的话，自动从新下载，有的话不下载，当本地和定义版本不一致的使用，更新重新下载。

## 总结 ##

以上就是cordova的配置文件常用解析，当然还有更多的属性值得我们去探索，后期大家自己研究一下吧！

--------------------

![20191229112121499.png][]

想要整理更多的碎片知识，扫码关注下面的公众号，让我们在哪里接着唠！

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3h1ZWh1ODM3NzY5NDc0_size_16_color_FFFFFF_t_70][]

[20191229112121499.png]: /images/20220527/d8296b0cb07046a0a196bd50920837c0.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3h1ZWh1ODM3NzY5NDc0_size_16_color_FFFFFF_t_70]: /images/20220527/218860fc82df4e3f9aa68787c8a9f269.png