Config.xml datoteke
Številne vidike vedenje app je mogoče nadzorovati z globalno nastavitveno datoteko, config.xml
. Ta platforma agnostik XML datoteke je urejen temelji na specifikaciji W3C's Pakirani Web Apps (Widgets) , in razširiti, če želite določiti jedro Cordova API funkcije, plugins in nastavitve za posamezne.
Za projekte, ustvarjene z Cordova CLI (opisano v vmesnik ukazne vrstice), lahko te datoteke najdete v najvišji ravni imenika:
app/config.xml
Upoštevajte, da pred 3.3.1-0.2.0 različico, datoteko obstajala na app/www/config.xml
, in da imajo tukaj še vedno podprt.
Čas using CLI zgraditi projekt, različice datoteke pasivno prekopirate v različnih platforms/
podimenikov, na primer:
app/platforms/ios/AppName/config.xml
app/platforms/blackberry10/www/config.xml
app/platforms/android/res/xml/config.xml
Ta oddelek podrobno globalno in cross-platform konfiguracijo možnosti. Videli v nadaljevanju, za posamezne možnosti:
Poleg različnih možnosti konfiguracije, navedenih spodaj, lahko konfigurirate tudi aplikacijskimi jedro niz podob za vsako ciljno platformo. Več informacij najdete ikone in brizg zaslon.
Jedro konfiguracijo elementov
Ta primer prikazuje privzete config.xml
nastanejo v CLI create
ukaz, opisane v vmesnik ukazne vrstice:
<widget id="com.example.hello" version="0.0.1">
<name>HelloWorld</name>
<description>
A sample Apache Cordova application that responds to the deviceready event.
</description>
<author email="dev@callback.apache.org" href="http://cordova.io">
Apache Cordova Team
</author>
<content src="index.html" />
<access origin="*" />
</widget>
Naslednje konfiguracije elementi se prikažejo v najvišje ravni config.xml
datoteke, in so podprte na vseh podprtih platformah Cordova:
Na
<widget>
elementaid
atribut določa identifikator app je obratno-domene, inversion
njeno polno različico število izraženo v manjših/večjih/obliž zapisu.Je
<name>
element določa app je uradno ime, kot je prikazano na zaslonu naprave doma in v app store vmesnikov.Na
<description>
in<author>
elementov določite metapodatkov in kontaktne podatke, ki se lahko pojavijo v app trgovina oglasi.Izbirnem
<content>
element opredeljuje app je začetno stran v najvišje ravni web directory sredstvih. Privzeta vrednost jeindex.html
, ki se običajno pojavi v projekt je najvišje ravniwww
imenik.<access>
elementi določajo nabor zunanje domene, app je dovoljeno, da komunicirajo. Privzeta vrednost, prikazano zgoraj omogoča dostop do katerega koli strežnika. Priročniku domene belo listo za podrobnosti.Na
<preference>
oznaka določa različne možnosti kot parovname
/value
atributi. Vsaka prednostname
je case-insensitive. Mnoge nastavitve so edinstveni za posebne platforme, kot je navedeno na vrhu te strani. V nadaljevanju podrobno nastavitve, ki veljajo za več platform.
Globalne nastavitve
Naslednje globalne nastavitve veljajo za vse platforme:
Fullscreen
vam omogoča, da skriti vrstici stanja na vrhu zaslona. Privzeta vrednost jefalse
. Primer:<preference name="Fullscreen" value="true" />
Orientation
vam omogoča, da zaklenete usmerjenost in preprečiti vrtijo v odziv na spremembe v usmerjenosti vmesnik. Možni vrednosti stadefault
,landscape
, aliportrait
. Primer:<preference name="Orientation" value="landscape" />
Opomba: na
default
vrednost pomeni oboje pokrajina ter podoba usmeritve so omogočene. Če želite uporabiti privzete nastavitve vsako platformo (ponavadi portret samo), pustite ta oznako zaconfig.xml
datoteke.
Multi-Platform nastavitve
Veljajo naslednje nastavitve več kot ena platforma, ampak ne vse od njih:
DisallowOverscroll
(program privzeto boolean,false
): nastavljena natrue
Če ne želite vmesnik za prikaz vse povratne informacije, ko uporabniki, se pomaknite čez začetek ali konec vsebin.<preference name="DisallowOverscroll" value="true"/>
Velja za Android in iOS. Na iOS, overscroll kretnje vzrok vsebine Odklonijo nazaj v prvotno lego. Na Android, ki jih proizvajajo bolj subtilen učinek žareče obod vrh ali dno vsebine.
BackgroundColor
: Nastavite barvo ozadja app. Podpira štiribajtno čarovnica vrednost, z prvi bajt, ki predstavlja kanal alfa, in standardni RGB vrednosti za naslednje tri bytes. Primer navaja modro:<preference name="BackgroundColor" value="0xff0000ff"/>
Velja za Android in BlackBerry. Preglasi CSS, ki so sicer na voljo na vseh platformah, na primer:
body{background-color:blue}
.HideKeyboardFormAccessoryBar
(program privzeto boolean,false
): nastavite natrue
skriti dodatne orodne vrstice, ki se prikaže nad tipkovnico, pomagajo uporabnikom pluti iz en obrazec vložek v drugo.<preference name="HideKeyboardFormAccessoryBar" value="true"/>
Velja za iOS in BlackBerry.
Funkcijo Element
Če uporabljate CLI razvijanje aplikacij, uporabljate v plugin
želite omogočiti napravo API. To does ne ublažiti najvišje ravni config.xml
Datoteka, tako je <feature>
element se ne uporablja za potek dela. Če delate neposredno v je SDK in uporabo plosčad-poseben config.xml
datoteke kot vir, uporabite na <feature>
tag omogočiti napravo ravni API in zunanjih plugins. Se pogosto pojavijo z vrednosti po meri v posamezne config.xml
datoteke. Na primer, tukaj je kako opredeliti naprave API za Android projektov:
<feature name="Device">
<param name="android-package" value="org.apache.cordova.device.Device" />
</feature>
Tukaj je, kako se prikaže element za iOS projektov:
<feature name="Device">
<param name="ios-package" value="CDVDevice" />
</feature>
Glej sklic API za podrobnosti o tem, kako določiti vsako funkcijo. Glej Plugin razvoj vodnik za več informacij o plugins.