Référence de configuration

Référence de configuration

De nombreux aspects du comportement d'une application peuvent être contrôlés par un fichier de configuration indépendant de la plateforme,config.xml, dont le format est basé sur la spécification Applications Web Embarquées (Widgets) du W3C.

Pour les projets créés avec l'interface en ligne de commande de Cordova (décrite dans le paragraphe "L'interface en Ligne de Commande"), ce fichier peut être trouvé dans le répertoire www à la racine du projet. L'utilisation de l'interface en ligne de commandes pour compiler les projets recrée des versions de ce fichier dans les différents sous-répertoires du répertoire platforms. Pour les projets créés sans passer par cette interface, le fichier spécifique à chaque plateforme sert de fichier source.

Si l'emplacement du fichier config.xml peut changer selon la plateforme, son contenu varie peu en général Certaines fonctionnalités spécifiques à une plateforme sont également indiquées dans ce même fichier de configuration. En voici le détail:

Eléments du fichier config.xml

Le projet Apache Cordova s'efforce de s'abstraire de la plate-forme native en utilisant des standards largement façonnés par la communauté web et adoptés par elle. Veuillez prendre quelques minutes pour vous familiariser avec la spécification du fichier config.xml, pour comprendre le type de méta-données de l'application que le projet Apache Cordova permet d'abstraire, tout en fournissant des points d'entrée simples.

Un exemple :

    <widget>
        <preference name="MySetting" value="true" />
        <feature name="MyPlugin" value="MyPluginClass" />
        <access origin="*" />
        <content src="index.html" />
    </widget>

Vous trouverez ci-dessous les éléments supportés sur les différentes plateformes supportées par Apache Cordova.

<feature>

Ces éléments correspondent aux API natives que l'application utilise. A son lancement, le framework Apache Cordova va relier les éléments <feature> au code natif pour permettre à votre application Cordova d'accéder aux interfaces natives de votre terminal, usuellement non-disponibles pour les applications web classiques.

<access>

Ces éléments définissent le fonctionnement de votre liste blanche. Veuillez consulter le Guide des Liste blanches de Domaines pour plus d'informations.

<content>

Cet élément définit la page de démarrage de votre application, relative au répertoire standard des composants du projet . Il est optionnel, sa valeur par défaut est index.html.