android本地xml配置,ionic的config.xml文件配置

config.xml的作用

Config.xml用于控制一些app的行为，这个平台无关的xml文件是基于W3C的Packaged Web Apps(Widgets)描述标准，扩充特定的核心Cordova API功能，插件和特定平台设置

当通过Cordova命令行创建一个工程以后，在其根目录会有一个config.xml文件,当使用platform add命令添加指定的移动平台以后，会在platforms目录各自平台的子目录有一个config.xml的拷贝

app/platforms/ios/AppName/config.xml

app/platforms/blackberry10/www/config.xml

app/platforms/android/res/xml/config.xml

config.xml核心配置元素

HelloWorld A sample Apache Cordova application that responds to the deviceready event. Apache Cordova Team

中的id用来标记app的标识符，同时我们也可以在这里设置versionCode，CFBundleVersion和packageVersion这类版本信息

用于指定app的正式名称，在手机主页和app-store里面显示的名字。

和用于配置程序的说明文字，作者。这些信息会出现在app-store的信息里面。

用于设置app的启示页，该页默认为index.html，在工程根目录。

此配置用来设置app可以访问哪些外部域下server的资源，具体参考Whitelist

用于设置各个可选设置，每一个preference不区分大小写，有一些preference只针对特殊平台有效。下面是一些针对多平台有效的常见preference。

共通参数

该参数用于设置app是否隐藏状态栏，在ios下是不隐藏状态栏的，但是会影响获取状态栏高度的准确值，默认为false。

支持多平台的参数设置

设置是否禁止滑动超出范围，此时会在超出部分显示黑色背景。在ios下如果设置为true，会引起拖拽页面的时候会触发放大显示功能。

#仅支持IOS&Android

主背景色。

#仅支持BlackBerry&Android

隐藏键盘显示时上面附带的status bar。

#仅支持BlackBerry

锁定显示朝向landscape or portrait。

为特定平台添加plugin。在使用cordova plugin add指令的时候会自动添加。

为指定平台单独设置属性。

设置hook，具体参见Hook

iOS的config.xml设置

EnableViewportScale (boolean, defaults to false) 如果设置成true，用于在viewport的meta标签是否生效。

MediaPlaybackAllowsAirPlay (boolean, defaults to true): 是否阻止使用airplay功能。

MediaPlaybackRequiresUserAction (boolean, defaults to false) 是否阻止自动播放媒体文件。

AllowInlineMediaPlayback (boolean, defaults to false) 是否允许重放，需要在浏览器提供的标签内添加webkit-playsinline。

BackupWebStorage (string, either none, local, or the default cloud) 选择程序备份的地点。

#none不进行备份 #local 备份到本地iTurn #cloud 备份到via iCloud

TopActivityIndicator (string, defaults to gray) 用于设置顶部状态栏风格，可选参数whiteLarge, white, and gray。

KeyboardDisplayRequiresUserAction (boolean, defaults to true) 是否禁止当输入框使用focus()获得焦点的时候显示键盘。

#绝大多数情况下我们应该设置成false，除非你不想让用户输入任何信息

SuppressesIncrementalRendering (boolean, defaults to false) 是否支持数据全部渲染完成后再显示到界面上。

GapBetweenPages (float, defaults to 0) 界面间隙(ios UIWebView的配置参数)。

PageLength (float, defaults to 0) 每个界面的size(ios UIWebView的配置参数)。

PaginationBreakingMode (string, defaults to page) ios UIWebView相关的参数。

可选值 page and column

PaginationMode (string, defaults to unpaginated) 用于设置分页相关的，是ios UIWebView相关的设置。

# 可选值 unpaginated, leftToRight, topToBottom, bottomToTop, and rightToLeft.

UIWebViewDecelerationSpeed (string, defaults to normal) 用于设置滚动条滑动速度。

#可选值 normal, fast

ErrorUrl (string, not set by default) 设置错误信息页。

OverrideUserAgent (string, not set by default) 用于重新设置UserAgent信息。

AppendUserAgent (string, not set by default) 在UserAgent末尾添加新内容。

#当OverrideUserAgent被设置时无效

target-device (string, defaults to universal) 设置支持设备类型，手机，平板，无限制。

#可选值 handset, tablet, universal

deployment-target (string, not set by default) 设置支持的最低版本。

1

CordovaWebViewEngine (string, defaults to ‘CDVUIWebViewEngine’) 设置cordova引擎，一般没人会设置这个。

SuppressesLongPressGesture (boolean, defaults to false) 是否绕过3Dtouch长按弹出一个放大窗口显示内容的功能。

Suppresses3DTouchGesture (boolean, defaults to false) 是否绕过3Dtouch功能。

如果Suppresses3DTouchGesture为true，SuppressesLongPressGesture最好也要设置为true

CDVSystemSchemesOverride (string, defaults to maps,tel,telprompt) 设置允许被传送给系统的协。

Android的config.xml设置

KeepRunning (boolean, defaults to true): 决定是否允许app在pause后依然运行，设置成false在app接受pause的时候就不会被杀死了，只是暂停执行代码

LoadUrlTimeoutValue (number in milliseconds, default to 20000, 20 seconds): 用来设置加载一个页面的timeout时间。默认20秒。

SplashScreen (string, defaults to splash): 用于设定splash screen的启动图片的名字，这个名字在res/drawable目录。 在各自子目录里面设置同样名字的资源。

SplashScreenDelay (number in milliseconds, defaults to 3000): splash screen的显示时长。

InAppBrowserStorageEnabled (boolean, defaults to true): 控制是否允许在InAppBrowser打开的web页面允许访问相同的localStorage和webSQL资源。

LoadingDialog (string, defaults to null): 用于设置在第一次加载页面的时候显示一个窗口，该窗口显示指定的title和message。

LoadingPageDialog (string, defaults to null): 和LoadingDialog一样，但是在第一次加载每一个页面的时候都会显示。

ErrorUrl (URL, defaults to null): 如果发生问题的话显示一个以Application Error为title的页面。

ShowTitle (boolean, defaults to false): 在屏幕顶端显示title。

LogLevel (string, defaults to ERROR): 设置log的等级，取值范围[ERROR, WARN, INFO, DEBUG, and VERBOSE]。

SetFullscreen (boolean, defaults to false): 此属性已经不赞成使用，会在将来删除

AndroidLaunchMode (string, defaults to singleTop): 设置Activity的launchMode，和AndroidManifest.xml相同，具体参考android开发指南。可选值[standard, singleTop, singleTask, singleInstance]。

DefaultVolumeStream (string, defaults to default, added in cordova-android 3.7.0): 设备的音量按钮相关设置，可以被设置成call或者media。

OverrideUserAgent (string, not set by default) 用于重新设置UserAgent信息。该设置会引起服务器issue，所以要谨慎使用。

AppendUserAgent (string, not set by default) 在UserAgent末尾添加新内容。

#当OverrideUserAgent被设置时无效

可以参考本人的guthub项目，欢迎star