Générateur d'applications

La génération des applications est effectuée depuis la fenêtre du Générateur d’applications. Pour afficher cette fenêtre, sélectionnez la commande Générer l’application dans le menu Développement de 4D.

La génération ne peut être effectuée qu’une fois la base compilée. Si vous sélectionnez cette commande sans avoir compilé la base au préalable, ou si le code compilé ne correspond pas au code interprété, une boîte de dialogue d’alerte apparaît, vous signalant que la base doit être préalablement (re)compilée.

La fenêtre du générateur d’applications comporte plusieurs pages, accessibles via des onglets : 

• La Page Structure compilée permet de générer une version compilée uniquement de la structure ou un composant.
• La Page Application permet de paramétrer et de générer la version monoposte de l’application.
• La Page Client/Serveur permet de paramétrer la version client/serveur de l’application.
• La Page Plugins et composants permet de désigner les plug-ins et les composants à intégrer à l’application.
• La Page Licences & Certificat permet de désigner les numéros de série à intégrer.

Il est possible de paramétrer simultanément différentes “cibles” (monopostes et client/serveur) pour l’application, chacune devant être explicitement sélectionnée via une case à cocher. 

Le bouton Construire génère les applications correspondant à toutes les cibles sélectionnées. Lorsque vous cliquez sur ce bouton, 4D affiche un thermomètre de progression indiquant les différentes phases en cours d’exécution. Les nouveaux paramètres, s’ils sont valides, sont sauvegardés dans le projet d’application (cf. paragraphe ). 

Le bouton Enregistrer permet d’enregistrer les paramètres définis dans le projet sans déclencher la génération.

Si vous cliquez sur le bouton Annuler ou si une erreur se produit durant le processus, les fichiers en cours de génération sont supprimés et une boîte de dialogue d’alerte vous informe de la cause de l’interruption.

La partie supérieure de la fenêtre de génération d’applications vous permet de définir le nom et l’emplacement des fichiers à générer. 

La zone Nom de l’application contient par défaut le nom du fichier de structure de la base. Ce nom sera utilisé pour les fichiers générés (base de données compilée, composant, application double-cliquable et application client-serveur), ainsi que les dossiers. 4D ajoutera automatiquement les suffixes nécessaires (.4dc, .exe, server...) en fonction du type d’application généré.
Lorsque vous conservez le nom par défaut, le nom de l’application reflète toute modification du nom du fichier de structure de la base. Si vous modifiez le nom de l’application, le nouveau nom est utilisé par défaut pour chaque nouvelle génération de la base courante. Le nom saisi ne doit donc PAS contenir d’extension. En outre, il ne doit pas comporter de caractères interdits par le système d’exploitation (tels que “.?!” sous Windows, “:” sous Mac OS, etc.).

La zone Dossier de destination permet de désigner l’emplacement auquel vous souhaitez placer les éléments générés. Par défaut, 4D utilise un dossier nommé “NomStructure_Build” placé à côté du dossier (ou package sous Mac OS) de la base est sélectionné.
Pour modifier le dossier de destination, cliquez sur le bouton de sélection [...] situé à droite de la zone d’affichage. Une boîte de dialogue de sélection de dossier apparaît, vous permettant de désigner le nouveau dossier de destination. Une fois cette boîte de dialogue validée, le chemin d’accès complet du dossier est affiché. Le nouvel emplacement sera utilisé par défaut pour chaque génération suivante de la base courante.

Au moment de la génération, 4D créera automatiquement un ou plusieurs dossiers (libellés “Compiled Database”, “Components”, “Final Application”, “Client Application” ou “Server Application” suivant le type de génération demandé) à l’emplacement défini. Ce fonctionnement permet d’éviter tout risque d’écrasement accidentel de fichiers du même nom et permet d’effectuer simultanément plusieurs types de générations.

Chaque paramètre de la fenêtre est stocké sous forme de clé XML dans un fichier de projet d’application nommé “BuildApp.XML” et placé dans le sous-dossier BuildApp du dossier Preferences de la base. 

Les paramètres par défaut sont utilisés lors de la première utilisation de la boîte de dialogue. Le contenu de ce fichier de projet est mis à jour si nécessaire lorsque vous cliquez sur le bouton Construire ou Enregistrer. 

Il est possible de définir plusieurs autres projets XML pour la même base de données et de les exploiter via la commande GENERER APPLICATION

A noter que les clés XML proposent des options supplémentaires par rapport à celles affichées dans la boîte de dialogue du générateur d’applications, notamment :

• la définition de l’adresse IP ou du numéro de port TCP du serveur,
• la définition d’un intervalle de numéros de versions compatibles entre l’application cliente et l’application serveur (par exemple, les applications clientes 1.1 à 1.3 peuvent se connecter à l’application serveur 1.3),
• la définition d’un chemin d’accès pour le fichier de données, permettant la génération d’applications immédiatement opérationnelles, sans qu’il soit nécessaire de désigner un fichier de données sur le poste de l’utilisateur,
• l'élévation des privilèges sous Windows permettant l'installation automatique des applications fusionnées dans les emplacements protégés du système.

La description de ces clés fait l’objet d’une documentation séparée, MissingRef.

Au moment de la première construction d’une application, 4D génère un fichier d’historique sous deux formats : XML et HTML. Les fichiers sont nommés “NomProjet.log.xml” et “NomProjet.log.html” (NomProjet représente le nom du projet d’application, c’est-à-dire BuildApp par défaut) et sont placés à côté du fichier de projet d’application, dans le sous-dossier BuildApp du dossier Preferences de la base. Une paire de fichiers d’historique est générée pour chaque projet d’application.

Le contenu de ces deux fichiers est identique, seul leur format diffère. A chaque génération d’application, les deux fichiers sont mis à jour avec les mêmes informations. Le fichier HTML permet de visualiser les erreurs et avertissements de façon graphique. 

A chaque génération, le fichier d’historique stocke les principaux événements :

• début et fin de la construction des cibles,
• nom et chemin d’accès complet des fichiers générés,
• date et heure de la génération,
• erreurs éventuelles.