Aller au contenu principal
Version: 20 R8 BETA

Compile project

Compile project {( {projectFile}{;}{options} )} : Object

ParamètresTypeDescription
projectFile4D.FileFichier .4DProject à compiler
optionsObjectObjet qui spécifie les options de compilation
RésultatObjectObjet contenant des informations sur le statut de compilation
Historique
ReleaseModifications
20 R8Prise en charge du type "formObjectExpression"

Description

Compile project vous permet de compiler le projet hôte courant ou le projet spécifié dans le paramètre projectFile. Pour plus d'informations sur la compilation, consultez la page Compilation.

Par défaut, la commande utilise les options du compilateur définies dans les Paramètres de structure. Vous pouvez les remplacer en passant un paramètre options. Les syntaxes suivantes sont prises en charge :

  • Compile project() : compile le projet ouvert à l'aide des options définies dans les paramètres de structure
  • Compile project(options) : compile le projet ouvert. Les options définies remplacent les paramètres de structure
  • Compile project(projectFile) : compile le projet 4D projectFile en utilisant les options définies dans les paramètres de structure
  • Compile project(projectFile; options) : compile le projet 4D projectFile et les options définies remplacent les paramètres de structure

**Note :**Les bases de données binaires ne peuvent pas être compilées avec cette commande.

Contrairement à la fenêtre du Compilateur, cette commande nécessite que vous désigniez explicitement le ou les composants à compiler. Lors de la compilation d'un projet avec Compile project, vous devez déclarer ses composants à l'aide de la propriété components du paramètre options. A noter que les composants doivent déjà être compilés (les composants binaires sont pris en charge).

Le code compilé résultant sera stocké dans le dossier DerivedData ou Libraries du projet, en fonction de la propriété targets du paramètre options. Si vous souhaitez créer des fichiers .4dz, vous devez toujours compresser manuellement le projet compilé ou utiliser la fonctionnalité build application.

Si vous passez une collection vide dans targets, Compile project exécutera une vérification syntaxique sans compiler.

Les erreurs de compilation, le cas échéant, sont retournées sous forme d'objets dans la collection errors.

Note : Vous ne pouvez pas appeler cette commande quand une autre compilation est en cours d'exécution (par exemple, une compilation lancée depuis la fenêtre de compilation).

Paramètre options

Le paramètre options est un objet. Voici les options de compilation disponibles :

PropriétéTypeDescription
componentsCollectionCollection d'objets 4D.File vers des composants dépendants (doit être déjà compilé)
defaultTypeForButtonsIntegerValeur possible : Is real ou Is longint
defaultTypeForNumericsIntegerValeur possible : Is real ou Is longint
generateSymbolsBooleanTrue pour générer des informations sur les symboles dans l'objet .symbols renvoyé
generateSyntaxFileBooleanVrai pour générer un fichier de syntaxe pour la complétion de code dans le dossier \Resources\en.lproj du projet
generateTypingMethodsText"reset" ou "append" pour générer des méthodes de typage. Si la valeur est "append", les déclarations de variables existantes ne seront pas modifiées (comportement de la fenêtre du compilateur). Si la valeur est "reset", les déclarations de variables existantes seront supprimées au préalable.
plugins4D.Folder objectDossier de plug-ins à utiliser à la place du Dossier de plug-ins du projet courant. Cette propriété n'est disponible qu'avec la syntaxe projectFile.
targetsCollection de chaînesValeurs possibles : "x86_64_generic", "arm64_macOS_lib". Passez une collection vide pour exécuter la vérification syntaxique uniquement
typeInferenceText"all" : Le compilateur déduit les types de toutes les variables non explicitement déclarées, "locals" : Le compilateur déduit le type des variables locales non déclarées explicitement, "none" : Toutes les variables doivent être explicitement déclarées dans le code (mode legacy), "direct" : Toutes les variables doivent être explicitement déclarées dans le code (direct typing).
warningsCollection d'objetsDéfinit le statut des warnings
[].majorNumberNuméro principal du warning, avant le point
[].minorNumberNuméro secondaire du warning, après le point
[].enabledBooleanStatut d'activation du warning

Note: Lorsque l'attribut warnings n'est pas défini dans l'objet options, la commande Compile project utilise les statuts de génération de warnings par défaut définis dans les paramètres.

Résultat

L'objet renvoyé par Compile project possède jusqu'à trois propriétés :

PropriétéTypeDescription
successBooleanVrai si la sauvegarde a été effectuée avec succès, sinon faux.
errorsCollection d'objetsDisponible uniquement en cas d'erreur ou de warning. Collection d'objets décrivant les erreurs de compilation ou les warnings
[].isErrorBooleanErreur si True, sinon warning
[].messageTextMessage d'erreur
[].codeObjectobjet code
[].lineNumberNuméro de ligne de l'erreur dans le code. Pour les méthodes de classe, le numéro de ligne dans la fonction
[].lineInFileNumberNuméro de ligne dans le fichier (différent de "line" pour les méthodes de classe, et prend en compte la ligne de préfixe %attributes)
symbolsObjectDisponible uniquement si l'option generateSymbols est fixée à True :
symbols.interprocessVariablesObjectListe de toutes les variables interprocessus
symbols.interprocessVariables.variablesCollectionCollection d'objets variables
symbols.interprocessVariables.sizeNumber
symbols.processVariablesObjectListe de toutes les variables process
symbols.processVariables.variablesCollectionCollection d'objets variables
symbols.processVariables.sizeNumber
symbols.localVariablesCollection d'objetsListe des variables locales par méthode
symbols.localVariables[].codeObjectobjet code
symbols.localVariables[].variablesCollectionCollection d'objets variables
symbols.methodsCollection d'objetsListe des méthodes
symbols.methods[].codeObjectobjet code
symbols.methods[].callCountNumberNombre de fois où cette méthode a été appelée
symbols.methods[].paramsCollectionCollection de types de paramètres (codes numériques des types de valeurs)
symbols.methods[]. threadSafeBooleanIndique si cette méthode est thread safe

Pour plus d'informations, voir Outils de compilation.

Objets variables

interprocessVariables.variables et processVariables.variables contiennent des objets ayant la structure suivante :

PropriétéTypeDescription
nameTextNom de la variable
typenumberType de la variable (comme la commande Value type)
arrayDimensionnumberPour les tableaux uniquement : 1 pour les tableaux mono-dimensionnels, 2 pour les tableaux bidimensionnels
codeObjectPour les variables process et interprocess : description de l'endroit où la variable a été définie

Objet code

La propriété code dans methods.code et errors.code est un objet avec les propriétés suivantes :

PropriétéTypeDescription
typeText"projectMethod", "formObjectMethod", "formMethod", "databaseMethod", "triggerMethod", "executeOnServer" (lors de l'appel d'une méthode projet avec l'attribut Execute on Server), "executeFormula" (lors de l'exécution d'une formule via PROCESS 4D TAGS ou de l'évaluation d'une formule dans un document 4D Write Pro), "class", "classFunction", "formObjectExpression" (pour les erreurs survenant dans les expressions associées à des objets formulaire)
pathTextChemin d'accès de la méthode (même format que METHOD OPEN PATH)
file4D.FileFichier de méthode
Retourné en fonction de la valeur de la propriété type:
methodNameTextMéthode
tableNumberNuméro de la table (retourné pour un trigger, une méthode formulaire table ou une méthode objet de formulaire table)
formNameTextNom du formulaire (renvoyé pour une méthode de formulaire)
objectNameTextNom de l'objet du formulaire (renvoyé pour une méthode objet)
propertyNameTextNom de la propriété de l'objet du formulaire (renvoyé pour une expression de l'objet du formulaire)
classNameTextNom de classe
functionNameTextNom de la fonction de classe
databaseMethodNumberIndice de méthode base

Exemples

Pour effectuer un contrôle de syntaxe uniquement, passez une collection vide au paramètre targets :

 var $status : Object
var $options:={}
$options.targets:=New collection //Collection vide pour le contrôle syntaxique
$status:=Compile project($options)

Compilez le projet courant en utilisant uniquement les options de compilateur définies dans les Paramètres de Structure :

 var $status : Object
$status:=Compile project

Sur un Mac Silicon, compilez le projet courant uniquement pour ARM :

 var $status : Object
var $options:={}
$options.targets:=New collection("arm64_macOS_lib")
$status:=Compile project($options)

Compilez un projet autre que le projet courant :

 var $status : Object
var $projectFile: 4D.File
$projectFile:=Folder(fk documents folder).file("Databases/myApp/Project/myApp.4DProject")
$status:=Compile project($projectFile)

Compilez un projet et déclarez son composant :

 var $status : Object
var $component : 4D.File
var $options:={}
$component:=Folder(fk documents folder).file("Components/myComponent.4dz")
$options.components:=New collection($component)
$status:=Compile project($options)

Désactivez les warnings 518.1 et 518.2 lors de la compilation de votre projet :

var $options:={}
$options.warnings:=[]
$options.warnings.push({major: 518; minor: 1; enabled: False})
$options.warnings.push({major: 518; minor: 2; enabled: False})
var $result:=Compile project($options)

Voir également

BUILD APPLICATION

Propriétés

Numéro de commande1760
Thread safe