JavaScool:SpecJavaScoolBuilder : Différence entre versions

De Sciencinfolycee
Aller à : navigation, rechercher
m
m
 
(4 révisions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
 
[[Catégorie:JavaScoolDev]] __NOTOC__
 
[[Catégorie:JavaScoolDev]] __NOTOC__
 
JavaScoolBuilder effectue les actions suivantes :
 
JavaScoolBuilder effectue les actions suivantes :
 
 
# Crée un répertoire de travail dit «cible»
 
# Crée un répertoire de travail dit «cible»
 
#* dont l'arborescence correspond au fichier jar final
 
#* dont l'arborescence correspond au fichier jar final
 
+
#* Ce fichier est de nom .build par défaut
 
# Déploie dans la cible
 
# Déploie dans la cible
 
#* les classes Java de la plateforme Javas'Cool
 
#* les classes Java de la plateforme Javas'Cool
Ligne 11 : Ligne 10 :
 
#* les classes et fichiers des proglets à compiler
 
#* les classes et fichiers des proglets à compiler
 
#** y compris les classes présentes dans les fichiers Jar des répertoires des proglets
 
#** y compris les classes présentes dans les fichiers Jar des répertoires des proglets
 
+
# Pour chaque proglet
 
+
## Teste que les fichiers de la proglet vérifient les [[JavaScool:DocCreationProglet|spécifications demandées]].
 
+
## Traduit tous les fichierscontenant de la [[JavaScool:DocumentsHml|documentation Hml]] en fichier HTML, selon les conventions suivantes:
 +
##* fichier d'extension <tt>.xml</tt> documentation en HML
 +
##* fichier d'extension <tt>.htm</tt> production en HTML3 de la documentation
 +
##*** fichier temporaire suceptible d'être détruit
 +
##* fichier d'extension <tt>.html</tt> autre fichier source HTML
 +
## Génère les doc Java et une version colorisée des sources Java (en option)
 +
# Compile tous les fichiers Java en fichier <tt>.class</tt>
 +
# Crée les fichiers jars de sortie
 +
#* les fichiers sources des proglets et les fichiers compilés et traduits
 +
#* les autres classes java permettant de les faire fonctionner.
 +
## fichier <tt>javascool-proglets.jar</tt> avec tous ces éléments
 +
## fichier <tt>javascool-proglet-xxx.jar</tt> pour chaque proglet.
 +
# Nettoie le dossier cible.
  
 
== Discussion ==  
 
== Discussion ==  
  
 +
* Le dossier de la proglet dans le sketchbook ne doit pas contenir de sous-dossiers
  
* Créer un jar contenant les fichiers .java de la proglet compilés. Les fichiers Panel.java et Functions.java sont optionnels, il est donc possible qu'aucune source java ne soit présente
+
* Les fichiers Panel.java et Functions.java sont optionnels, il est donc possible qu'aucune source java ne soit présente pour une proglet.
* Créer un dossier src dans le jar final (dans le dossier de la proglet) contenant les sources java. Ce dossier doit être présent même si aucune source java n'est trouvée
 
* Convertir tous les fichiers .xml du dossier de la proglet en .htm et les mettre dans le jar directement dans le dossier de la proglet : ces fichiers ne doivent pas être insérés dans le sketchbook.
 
* Aucun fichier ne doit être inséré ou modifié dans le sketchbook
 
* Tous les dossiers temporaires doivent être supprimés à la fin du javascoolbuilder, ou au pire au lancement suivant de javascoolbuilder
 
* Le fichier proglet.pml doit être présent et converti en fichier .php dans le dossier de la proglet dans le jar
 
* Le fichier proglet.pml doit aussi être copié dans le dossier de la proglet dans le jar, ainsi que tous les fichiers non-java et non-xml du sketchbool.
 
* Le dossier de la proglet dans le sketchbook ne doit pas contenir de sous-dossiers
 
  
Autrement dit :
+
* Le jar final (dans le dossier de la proglet) contient pour chaque fichier <tt>*.java</tt>
 +
** Les fichiers <tt>*.class</tt> de la compilations
 +
** Un fichier <tt>*.html</tt> correspondant à la javadoc et un fichier <tt>*.java.html</tt> du fichier correspondant à une version colorisée du source.
  
* Les fichiers requis sont :
+
* Les dossiers et fichiers du sketchbook restent inchangés, tout est généré dans le dossier cible
** proglet.pml
+
** Ces dossiers ne doivent contenir que les sources <tt>*.java</tt> et <tt>.xml</tt> (à l'exclusion des <tt>*.class</tt>, <tt>.htm</tt>, ..).
** help.xml
 
* Les fichiers devant être copiés tel quel dans le dossier de la proglet dans le jar sont :
 
** proglet.pml
 
** Tous les fichiers qui ne vérifient aucune des regex preg suivantes :
 
*** <nowiki>#^.+\.xml$#</nowiki>
 
*** <nowiki>#^.+\.java$#</nowiki>
 
* Les fichiers devant être copiés dans un sous-dossier 'src' du dossier de la proglet dans le jar sont :
 
** Tous les fichiers qui vérifient une des regex preg suivantes :
 
*** <nowiki>#^.+\.xml$#</nowiki>
 
*** <nowiki>#^.+\.java$#</nowiki>
 
* Les fichiers devant être générés puis copiés dans le dossier de la proglet dans le jar sont :
 
** proglet.pml -> proglet.php
 
** <nowiki>*.xml -> *.htm</nowiki>
 
** <nowiki>*.java -> *.class</nowiki>
 
  
Après l'exécution de javascoolbuilder, le dossier maproglet du sketchbook reste inchangé
+
* Le fichier proglet.pml doit être présent
 +
** Il est aussi converti en fichier .php pour son usage sur le site web

Version actuelle datée du 24 août 2011 à 09:46

JavaScoolBuilder effectue les actions suivantes :

  1. Crée un répertoire de travail dit «cible»
    • dont l'arborescence correspond au fichier jar final
    • Ce fichier est de nom .build par défaut
  2. Déploie dans la cible
    • les classes Java de la plateforme Javas'Cool
    • les classes et fichiers des proglets externes
      • c'est à dire celles qui sont présentes dans les fichiers Jar du répertoire du sketchbook
    • les classes et fichiers des proglets à compiler
      • y compris les classes présentes dans les fichiers Jar des répertoires des proglets
  3. Pour chaque proglet
    1. Teste que les fichiers de la proglet vérifient les spécifications demandées.
    2. Traduit tous les fichierscontenant de la documentation Hml en fichier HTML, selon les conventions suivantes:
      • fichier d'extension .xml documentation en HML
      • fichier d'extension .htm production en HTML3 de la documentation
          • fichier temporaire suceptible d'être détruit
      • fichier d'extension .html autre fichier source HTML
    3. Génère les doc Java et une version colorisée des sources Java (en option)
  4. Compile tous les fichiers Java en fichier .class
  5. Crée les fichiers jars de sortie
    • les fichiers sources des proglets et les fichiers compilés et traduits
    • les autres classes java permettant de les faire fonctionner.
    1. fichier javascool-proglets.jar avec tous ces éléments
    2. fichier javascool-proglet-xxx.jar pour chaque proglet.
  6. Nettoie le dossier cible.

Discussion

  • Le dossier de la proglet dans le sketchbook ne doit pas contenir de sous-dossiers
  • Les fichiers Panel.java et Functions.java sont optionnels, il est donc possible qu'aucune source java ne soit présente pour une proglet.
  • Le jar final (dans le dossier de la proglet) contient pour chaque fichier *.java
    • Les fichiers *.class de la compilations
    • Un fichier *.html correspondant à la javadoc et un fichier *.java.html du fichier correspondant à une version colorisée du source.
  • Les dossiers et fichiers du sketchbook restent inchangés, tout est généré dans le dossier cible
    • Ces dossiers ne doivent contenir que les sources *.java et .xml (à l'exclusion des *.class, .htm, ..).
  • Le fichier proglet.pml doit être présent
    • Il est aussi converti en fichier .php pour son usage sur le site web