- Présentation
- Comment le faire ?
- Créer une configuration
- Travailler sur une configuration de projet
- Générer une configuration de projet
- Ajouter un élément dans une configuration de projet
- Exclure un élément d'une configuration de projet
- Dupliquer une configuration de projet
- Supprimer une configuration de projet
- Caractéristiques d'une configuration de projet
- Caractéristiques présentes dans l'onglet "Général"
- Astuces
Les configurations de projet permettent de définir les différents types de générations supportées par le projet : exécutable 32 bits, exécutable 64 bits, Webservice, composant, etc. Les éléments du projet peuvent être : - communs à plusieurs configurations (par exemple, une fenêtre utilisée dans un exécutable 32 et 64 bits).
- spécifiques à une configuration (par exemple une classe utilisée uniquement par un composant).
A tout moment, vous pouvez travailler sur une configuration spécifique : les éléments n'appartenant pas à cette configuration apparaissent grisés dans le volet "Explorateur de projet". Cette page d'aide présente les sujets suivants : Créer une configuration Par défaut, une seule configuration est créée dans un projet. Cette configuration a pour nom le nom du projet et contient tous les éléments du projet. Pour créer une nouvelle configuration : - Sous le volet "Projet", dans le groupe "Configuration de projet", déroulez "Nouvelle configuration" et sélectionnez l'option "Nouvelle configuration (via assistant)".
Remarques : - Il est possible de sélectionner directement la plateforme de la configuration de projet à créer en déroulant l'option "Nouvelle configuration".
- Il est également possible d'utiliser l'option "Nouvelle Configuration" du menu contextuel du volet "Explorateur de projet".
- L'assistant de création d'une configuration de projet se lance. Indiquez :
- le nom de la configuration.
Attention : Si le projet contient plusieurs configurations de projet, ce nom correspondra également au nom du répertoire dans lequel les fichiers de la configuration de projet seront générés. - sa description.
- le type de génération : Exécutable, Java, Bibliothèque, Composant, Webservice, Assemblage DotNet, Exécutable DotNet, ...
Remarque : Cette caractéristique n'est pas demandée si la plateforme a été sélectionnée dès la création.
- Selon le type de génération choisi pour la configuration de projet, il est possible d'indiquer des options supplémentaires :
- Options de compatibilité multi-produit : L'élément sera généré uniquement pour un type de projet spécifique ou pour une utilisation dans tous les produits (WINDEV, WEBDEV et WINDEV Mobile). Il est possible d'activer ou non les erreurs de compilation pour la compatibilité 64 bits ou Linux.
- Système d'exploitation et plateforme.
- Indiquez si nécessaire les éléments du projet à intégrer à la configuration de projet en cours de création (fenêtres, états, requêtes, ...). Si votre projet utilise des composants, il est également possible de sélectionner les composants faisant partie de la configuration.
- Validez la création de la configuration. Cette configuration de projet est automatiquement sélectionnée. Cette configuration pourra être modifiée :
- soit depuis la fenêtre de gestion des configurations de projet : sous le volet "Projet", dans le groupe "Configuration de projet", cliquez sur "Gérer les configurations". Il suffit de sélectionner la configuration voulue et de cliquer sur le bouton "Description".
- soit par l'option "Description" du menu contextuel de la configuration de projet dans le volet "Explorateur de projet".
Répertoire des configurations de projet : Lors de la création d'une configuration de projet, les fichiers de cette configuration de projet sont générés par défaut dans un sous-répertoire du répertoire EXE du projet. Il est ainsi plus simple de retrouver les fichiers générés par une configuration. Si le projet était déjà un projet multi-configurations, lors de la création d'une configuration de projet, un plan de l'assistant propose de générer les fichiers de la configuration : - dans le répertoire EXE du projet (fonctionnement conservé par compatibilité).
- dans un sous-répertoire par configuration (créé dans le répertoire EXE du projet). Dans ce cas, un répertoire est créé pour chacune des configurations existantes dans le projet. Le nom de ce répertoire correspond au nom de la configuration de projet.
Remarques : - Dans l'onglet "Options" de la fenêtre de description du projet, l'option "Générer toutes les configurations dans le répertoire "Exe" (déconseillé si plusieurs configurations)" permet de retrouver le fonctionnement des versions précédentes.
- En mode GO, les fichiers utilisés sont les fichiers présents dans le répertoire de la configuration (fichiers INI, fichiers de données, ...).
- A la première création d'une configuration de projet, le contenu du répertoire EXE est copié dans son intégralité dans les sous-répertoires de la configuration de projet. Il peut être nécessaire de supprimer les fichiers non concernés par la configuration en cours (par exemple, fichier EXE non nécessaire dans le répertoire de la configuration d'un composant).
- Il est également possible de créer une configuration de projet à partir d'une configuration existante. Il suffit de réaliser une duplication de configuration.
Travailler sur une configuration de projet La sélection de la configuration de travail se fait : - par le volet "Explorateur de projet" : il suffit de double-cliquer sur la configuration voulue ou de sélectionner l'option "Activer cette configuration" du menu contextuel.
- par la fenêtre de gestion des configurations de projet : sous le volet "Projet", dans le groupe "Configuration de projet", cliquez sur "Gérer les configurations". Il suffit de cocher la configuration courante et de valider la fenêtre.
Le projet dans son ensemble correspond à la configuration nommée avec le nom du projet. Lorsque vous travaillez sur une configuration spécifique : - Dans le volet "Explorateur de projet", l'icône précédant le nom d'un élément non utilisé dans la configuration en cours est grisée.
- Il est possible de définir une première fenêtre ou une première page pour chaque configuration de projet.
- Il est possible de définir les options du groupware utilisateur pour chaque configuration de projet.
- Lors de la génération des éléments d'une configuration, seuls les éléments définis dans la configuration sont pris en compte.
- Dans les boutons d'accès rapide, l'icône de génération s'adapte automatiquement au type de la configuration manipulée (création d'un exécutable, création d'une archive JAVA, ...).
Générer une configuration de projet Pour générer le résultat d'une configuration de projet : - Affichez la fenêtre de gestion des configurations de projet : sous le volet "Projet", dans le groupe "Configuration de projet", cliquez sur "Gérer les configurations".
- Sélectionnez la configuration de projet à générer.
- Cliquez sur le bouton "Générer".
Ajouter un élément dans une configuration de projet Pour ajouter un élément dans une configuration : - Dans le volet "Explorateur de projet", sélectionnez l'élément à ajouter (fenêtre, état, ...).
- Dans le menu contextuel de l'élément (clic droit), sélectionnez l'option "Configurations".
Dans le menu qui apparaît :
- les configurations cochées correspondent aux configurations associées à l'élément.
- les configurations décochées correspondent aux configurations non associées à l'élément.
- l'option "Toutes" permet d'associer l'élément à toutes les configurations.
- l'option "Aucune" permet de ne plus associer l'élément à une configuration.
- l'option "Multiples" permet de choisir les configurations auxquelles l'élément doit être associé.
- Sélectionnez la configuration décochée dans laquelle l'élément doit être ajouté.
Remarque : Lors de l'enregistrement d'un nouvel élément, la fenêtre suivante s'affiche : Cette fenêtre permet de spécifier la configuration dans laquelle l'élément en cours doit être ajouté. Pour que cette fenêtre s'affiche automatiquement à chaque enregistrement d'un nouvel élément, cochez l'option "Demander l'emplacement des nouveaux éléments dans le projet" dans l'onglet "Options" de la description du projet. Exclure un élément d'une configuration de projet Pour exclure un élément d'une configuration : - Dans le volet "Explorateur de projet", sélectionnez l'élément à exclure (fenêtre, état, ...).
- Dans le menu contextuel de l'élément (clic droit), sélectionnez l'option "Configurations". Dans le menu qui apparaît :
- les configurations cochées correspondent aux configurations associées à l'élément.
- les configurations décochées correspondent aux configurations non associées l'élément.
- Sélectionnez la configuration cochée pour laquelle l'élément doit être exclu.
Remarque : Les éléments exclus d'une configuration de projet ne sont pas compilés pour cette configuration de projet. Le code de l'élément est grisé. Dans le code non compilé : - il n'y a aucune assistance à la saisie du code.
- il n'y a pas de références croisées : pas de Shift+F2, les utilisations des éléments ne sont pas vues, les éléments peuvent apparaître dans les listes des éléments orphelins et du code mort.
- il n'y a pas d'analyse du code : pas de renommage intelligent.
- il n'y a pas d'erreur de compilation : si on modifie le prototype d'une procédure, l'erreur ne sera affichée que lors du passage dans une configuration qui autorise la compilation du code.
Dupliquer une configuration de projet La duplication d'une configuration de projet peut être effectuée : - depuis le volet "Explorateur de projet".
- depuis la fenêtre de gestion des configurations.
Pour dupliquer une configuration de projet depuis le volet "Explorateur de projet" : - Sélectionnez la configuration de projet à dupliquer dans le volet "Explorateur de projet".
- Affichez le menu contextuel de la description et sélectionnez l'option "Dupliquer".
- La nouvelle configuration de projet apparaît dans le volet "Explorateur de projet".
- Modifiez si nécessaire la nouvelle configuration de projet :
- Dans le volet "Explorateur de projet, sélectionnez l'option "Description" du menu contextuel.
- Dans l'onglet "Général", modifiez pour la configuration dupliquée : le nom, le type de génération et le répertoire de génération de la configuration.
Pour dupliquer une configuration depuis la fenêtre de gestion des configurations de projet : - Affichez la fenêtre de gestion des configurations de projet : sous le volet "Projet", dans le groupe "Configuration de projet", cliquez sur "Gérer les configurations".
- Sélectionnez la configuration de projet à dupliquer.
- Cliquez sur le bouton "Dupliquer".
- Modifiez si nécessaire la nouvelle configuration de projet :
- Cliquez sur le bouton "Description".
- Dans l'onglet "Général", modifiez pour la configuration dupliquée : le nom, le type de génération et le répertoire de génération de la configuration.
Remarques : - La configuration dupliquée contient les mêmes éléments que la configuration de base. Il est ainsi possible de créer facilement une configuration iOS dans un projet Android.
- Le nom de l'élément généré doit être modifié si nécessaire dans l'assistant de génération correspondant.
Supprimer une configuration de projet Pour supprimer une configuration : - Sélectionnez la configuration voulue dans le volet "Explorateur de projet".
- Sélectionnez l'option "Supprimer" du menu du volet "Explorateur de projet".
Remarques : - Les éléments de la configuration seront conservés dans le projet (fenêtres, états, ...).
- Les éléments générés (exécutable, service, composant, ...) ne seront pas supprimés du disque.
Caractéristiques présentes dans l'onglet "Général" Les options disponibles dans l'onglet "Général" sont les suivantes : - les informations générales : le nom et la description de la configuration.
- les informations de génération :
- le type de génération.
- le répertoire de génération de la configuration de projet si le projet contient plusieurs configurations.
- les actions à effectuer avant génération et après génération de la configuration de projet.
- les actions à effectuer avant la génération Gradle.
- les premières fenêtres ou premières pages.
- la première fenêtre du projet : Permet de sélectionner la première fenêtre qui sera affichée lors du lancement du projet (ou de l'exécutable associé).
Le bouton [...] permet d'afficher l'aperçu de toutes les fenêtres du projet pour une sélection plus rapide. Pour plus de détails, consultez Première fenêtre du projet. - la première fenêtre pour téléphones : Permet de sélectionner la première fenêtre qui sera affichée lors du lancement de l'application sur un téléphone.
Le bouton [...] permet d'afficher l'aperçu de toutes les fenêtres du projet pour une sélection plus rapide. Pour plus de détails, consultez Première fenêtre du projet. - la première fenêtre pour tablettes : Permet de sélectionner la première fenêtre qui sera affichée lors du lancement de l'application sur une tablette.
Le bouton [...] permet d'afficher l'aperçu de toutes les fenêtres du projet pour une sélection plus rapide. Pour plus de détails, consultez Première fenêtre du projet. - la page d'accueil : Permet de sélectionner la page d'accueil du site.
Le bouton [...] permet d'afficher l'aperçu de toutes les pages du projet pour une sélection plus rapide. Pour plus de détails, consultez La page d'accueil. - la première page dynamique : Permet de sélectionner la première page dynamique du projet.
Le bouton [...] permet d'afficher l'aperçu de toutes les pages dynamiques du projet pour une sélection plus rapide. Pour plus de détails, consultez Première page dynamique du projet. - la page d'erreur : Permet de sélectionner la page utilisée pour afficher les erreurs du site.
Le bouton [...] permet d'afficher l'aperçu de toutes les pages statiques du projet pour une sélection plus rapide. Pour plus de détails, consultez Une page spécifique pour afficher les erreurs.
- les caractéristiques de l'exécutable.
- L'option "Exécutable cryptable
(Chargement de la bibliothèque par les API standards)" permet de rendre les exécutables générés compatibles avec les outils de cryptage et de compression d'exécutables (UPX, Enveloppe HASP, ...).
- L'option "Désactiver la prévention d'exécution des données (option /NXCOMPAT:NO)
(Permet l'utilisation de modules tierces qui ne gèrent pas les dernières normes de sécurité)" permet de gérer l'option de compilation "NX" (No eXécute).
- Les exécutables et DLL 32 bits pour Windows sont désormais compilés par défaut avec l'option "NX" (No eXécute). Cette option est vivement recommandée pour accroître la sécurité. Elle est obligatoire par exemple pour faire certifier une application par Microsoft. En effet, une application compilée sans cette option peut permettre à son auteur d'exécuter un code qu'il a placé à un emplacement spécifique de la mémoire. Cette technique, déjà utilisée par des applications malveillantes, est désormais interdite.
- L'option "Désactiver la prévention d'exécution des données (option /NXCOMPAT:NO)" permet de compiler sans l'option "NX". Cela peut être nécessaire dans le cas où l'exécutable utilise une DLL tierce (ActiveX, pilote ODBC d'accès à une base, ...), qui elle n'a pas le flag NX et qui exécute du code en mémoire via ce qui peut être une faille de sécurité. Si l'application principale est compilée avec l'option NX, elle sera stoppée par Windows en faute de protection générale (GPF).
- Remarques :
- Il est recommandé de solliciter l'éditeur de la DLL afin d'avoir une version actualisée de la DLL avec le flag NX.
- Nous vous conseillons de prévoir à moyen terme une alternative à l'utilisation de la DLL. En effet, avec la sécurité sans cesse accrue des systèmes, il est assez probable qu'un jour les exécutables sans l'option NX ne puissent plus être exécutés.
- Les options "Exécutable avec fenêtres" et "Exécutable console" permettent de spécifier si l'exécutable correspondant à la configuration de projet en cours doit afficher des fenêtres ou non. Dans ce dernier cas, il pourra par exemple être un exécutable de type Batch exécuté en mode ligne de commande.
- les options spécifiques Android :
- Appliquer le thème Material design aux champs natifs et aux fenêtres Info/Erreur/Dialogue : Si cette option est cochée, le thème Material Design est appliqué par défaut à tous les champs natifs. Si cette option n'est pas cochée, le thème holographique est utilisé par défaut.
- Positionnement des libellés compatible 22 : A partir de la version 23, l'affichage de l'éditeur de fenêtres devient encore plus WYSIWYG : l'indication de "marge" (padding) indiquée dans les polices est désormais prise en compte. L'option "Positionnement des libellés compatible 22" permet de retrouver l'affichage de la version 22 (par exemple pour les projets créés dans une version précédente).
- Application d'administration de l'appareil (peut devenir "device owner" pour le mode kiosque) : Cette option permet de gérer le mode kiosque complet. Pour plus de détails, consultez Application en mode kiosque.
- Hauteur action bar : Cette option permet de paramétrer la hauteur du champ Action Bar dans les différentes fenêtres. Jusqu'à la version 25, la hauteur des champs Action Bar est de 48 px par défaut. A partir des nouveaux projets 26, la hauteur du champ Action Bar passe à 56 px par défaut. Cette option permet de modifier la hauteur du champ Action Bar dans les projets existants.
Remarque : En cas de modification de la hauteur, la nouvelle hauteur s'applique à toutes les fenêtres de l'application.
Pour les actions avant et après génération, les opérations à effectuer sont les suivantes : - Saisissez le script de commande à exécuter. Vous pouvez y saisir :
- le chemin d'un exécutable : saisissez le chemin directement dans le champ ou utilisez le bouton "Parcourir...".
- des macros : cliquez sur le bouton "Macro" et double-cliquez sur la macro que vous souhaitez ajouter à votre ligne de commande. Par exemple, la macro "Nom du projet en cours" {$NomProjet} sera remplacée par le nom de votre projet en cours d'édition. Une macro spécifique permet d'exécuter une option d'un PersoMenu.
- Sélectionnez ensuite les options d'exécution de la ligne de commande :
- Afficher la console : une console (invite de commande) sera affichée.
- Laisser la console ouverte : si une console est affichée, elle restera ouverte à la fin de l'exécution du programme lancé.
- Exécution non bloquante : l'exécution de la ligne de commande ne bloquera pas l'accès à WINDEV, WEBDEV ou WINDEV Mobile.
- Sélectionnez le répertoire d'exécution du programme.
- Validez
Astuces - Pour connaître par programmation la configuration de projet utilisée, il suffit d'utiliser la fonction ProjetInfo avec la constante piConfiguration.
- Pour activer une configuration de projet depuis le volet "Explorateur de projet", il suffit de double-cliquer sur le nom de la configuration voulue. L'option "Description" du menu contextuel permet d'afficher la fenêtre de description de la configuration sélectionnée.
- Pour ouvrir directement le répertoire de génération d'une configuration :
- Utilisez l'option "Ouvrir le répertoire de génération" du menu contextuel de la configuration de projet.
- Sous le volet "Accueil", dans le groupe "Général", déroulez et sélectionnez "Explorer le répertoire de génération".
Documentation également disponible pour…
|
|
|