Compilation et minification des fichiers JavaScript dans le composant Administration système

Pourquoi et quand exécuter cette tâche

Pour compiler et minifier des fichiers JavaScript sur la console d'administration du système, procédez comme suit :

Procédure

  1. Exécutez la commande jscompile pour afficher les avertissements de compilation JavaScript éventuels à l'aide de la commande sci_ant.sh dans le répertoire <Install>/bin. Cette commande fonctionne avec le fichier jsUtil.xml stocké dans le même répertoire. Elle peut inclure les propriétés suivantes :
    Remarque : Cette étape est facultative. Elle n'est pas indispensable pour effectuer une minification.
    • gis.install : Chemin du répertoire d'installation.
    • srcDir : Répertoire source.
    • errorOnly : Indique si vous souhaitez afficher tous les avertissements et les erreurs (false) ou uniquement les erreurs (true). La valeur par défaut est false.
    • format : Format de sortie, à savoir (h) pour html et (t) pour texte. La valeur par défaut est t. Si errorOnly a pour valeur true, html (h) est la seule option valide.
    • outputFile : Chemin du fichier de sortie. Si le chemin du fichier n'est pas indiqué ou n'existe pas, tous les avertissements sont envoyés à la sortie standard.
    • warningOptions : Options d'avertissement (séparées par des virgules). Options par défaut : [onevar, undef, forin, debug, browser, eqeqeq, newcap, evil]. Pour connaître toutes les options d'avertissement, voir http://www.jslint.com/

      Par exemple :

      ./sci_ant.sh -f jsUtil.xml jscompile -Dgis.install=<répertoire_installation> -DsrcDir=
      <répertoire_installation>/repository/eardata/sma/war/sma
      Remarque : Si vous utilisez sci_ant.sh, gis.install devient facultatif.
  2. Regroupez les fichiers dans un même fichier en minifiant les fichiers à l'aide de la commande sci_ant.sh du répertoire <répertoire_installation>/bin. Cette commande fonctionne avec le fichier jsUtil.xml stocké dans le même répertoire. Elle peut inclure les propriétés suivantes :
    • gis.install : Chemin du répertoire d'installation.
    • jsbDir : Chemin du répertoire JSB (obligatoire).
    • minify : Indique si les fichiers doivent être minifiés (true/false). La valeur par défaut est true (minification des fichiers). Cette option est facultative.
    • srcDir : Répertoire source. Ce répertoire est utilisé si l'attribut d'entrée n'est pas indiqué dans JSB. Cette option est facultative.
    • destDir : Répertoire de destination. Ce répertoire est utilisé si l'attribut d'entrée n'est pas indiqué dans JSB. Cette option est facultative.
    • createIndividualFile : Indique si vous souhaitez créer des fichiers distincts (true/false). La valeur par défaut est false (pas de fichiers distincts créés). Cette option est facultative.
    • jscompile : Indique si vous souhaitez afficher les avertissements/erreurs JavaScript (true/false). La valeur par défaut est true (affichage des erreurs).

      Par exemple :

      ./sci_ant.sh -f jsUtil.xml minify-js -Dgis.install=<répertoire_installation>
      -DsrcDir=<répertoire_installation>/repository/eardata/sma/war
      -DjsbDir=<répertoire_installation>/repository/eardata/sma/war/builder
      -DdestDir=<répertoire_installation>/repository/eardata/sma/war
      Remarque : Si vous utilisez sci_ant.sh, gis.install devient facultatif.