Ressources d'application Cordova
Vous nécessitez certaines ressources dans votre application Cordova. Dans la plupart des cas, elles sont générées automatiquement lorsque vous créez votre application Cordova à l'aide des outils de développement Cordova de votre choix. Si vous utilisez le modèle IBM MobileFirst Platform Foundation, des écrans d'accueil et des icônes sont également fournis.
Vous pouvez utiliser un modèle de projet mis à disposition par IBM® avec les projets Cordova compatibles avec les fonctions de MobileFirst. Si vous utilisez ce modèle MobileFirst, les ressources ci-après sont disponibles comme point de départ. Sinon, toutes les ressources sont fournies sauf les écrans d'accueil et les icônes.
Vous ajoutez le modèle en spécifiant l'option --template et le modèle MobileFirst lorsque vous créez initialement votre projet Cordova. Pour plus d'informations sur l'utilisation de ce modèle, voir Création d'une application Cordova avec le modèle MobileFirst.
Si vous changez le chemin d'accès et le nom de fichier par défaut d'une ressource, vous devez également les modifier dans le fichier de configuration Cordova (config.xml). De plus, dans certains cas, vous pouvez changer les chemins d'accès et les noms par défaut avec la commande mfpdev app config. Si vous pouvez changer les chemins d'accès et les noms avec la commande mfpdev app config, une note l'indique dans la section relative à la ressource concernée.
Fichier de configuration Cordova (config.xml)
Le fichier de configuration Cordova est un fichier XML requis qui contient des métadonnées d'application et qui est stocké dans le répertoire racine de l'application. Il est généré automatiquement lorsque vous créez une application Cordova. Vous pouvez le modifier pour ajouter des propriétés personnalisées avec la commande mfpdev app config. Pour plus d'informations sur ce fichier, voir Le fichier de configuration Cordova.
Fichier principal (index.html)
Ce fichier principal est un fichier HTML5 qui contient le squelette de l'application. Il charge toutes les ressources Web (scripts et feuilles de style) nécessaires à la définition des composants généraux de l'application et à l'ancrage des événements de document requis. Il se trouve dans le répertoire <nom_de_votre_projet>/www.
Vous pouvez changer le nom de ce fichier avec la commande mfpdev app config.
Image miniature
L'image miniature est une identification graphique de l'application dans MobileFirst Operations Console. Il doit s'agir d'une image carrée, dont la taille est 90 par 90 pixels, de préférence.
Une image miniature par défaut est fournie lorsque vous utilisez le modèle. Vous pouvez la remplacer en utilisant le même nom de fichier avec une image de remplacement. Le fichier thumbnail.png se trouve dans le répertoire <nom_de_votre_projet>/www/img.
Vous pouvez changer le nom ou le chemin d'accès de ce fichier avec la commande mfpdev app config.
Image d'accueil
L'image d'accueil est affichée lorsque l'application est en cours d'initialisation.
- iOS : <nom_de_votre_projet>/res/screen/ios/
- Android : <nom_de_votre_projet>/res/screen/android/
- Windows : <nom_de_votre_projet>/res/screen/windows/
Lorsque vous utilisez le modèle MobileFirst pour construire votre application pour la plateforme Android, le plugin cordova-plugin-splashscreen est installé. Lorsque ce plug-in est intégré, les images d'accueil que Cordova utilise sont affichées à la place des images qui sont utilisées par MobileFirst. Les images dans le dossier au format screen.png sont les images d'accueil standard Cordova. Vous pouvez spécifier les images d'accueil qui s'affichent en modifiant les paramètres dans le fichier config.xml Cordova.
Si vous n'utilisez pas le modèle MobileFirst, les images d'accueil par défaut qui sont affichées sont les images utilisées par le plug-in MobileFirst. Les noms des fichiers des images d'accueil source MobileFirst par défaut sont au format splash-string.9.png.
Pour plus d'informations sur l'utilisation de vos propres images d'accueil, voir Ajout d'écrans d'accueil et d'icônes personnalisés à des applications Cordova.
Icônes d'application
- iOS : <nom_de_votre_projet>/res/icon/ios/
- Android : <nom_de_votre_projet>/res/icon/android/
- Windows : <nom_de_votre_projet>/res/icon/windows/
Feuilles de style
Le code de l'application peut inclure des fichiers CSS qui définissent la vue d'application.
- iOS : <nom_de_votre_projet>/platforms/ios/www/css/
- Android : <nom_de_votre_projet>/platforms/android/assets/www/css/
- Windows : <nom_de_votre_projet>/platforms/windows/www/css/
Scripts
Le code de votre application peut inclure des fichiers JavaScript qui implémentent diverses fonctions de votre application, comme des composants d'interface utilisateur interactifs, une logique applicative et l'intégration de requête de back end.
- iOS : <nom_de_votre_projet>/platforms/ios/www/js/
- Android : <nom_de_votre_projet>/platforms/android/assets/www/js/
- Windows : <nom_de_votre_projet>/platforms/windows/assets/www/js/