JavaScool:SpecJavaScoolBuilder : Différence entre versions
De Sciencinfolycee
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 | ||
− | * | + | * 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 <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 | + | * 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 <tt>*.java</tt> et <tt>.xml</tt> (à l'exclusion des <tt>*.class</tt>, <tt>.htm</tt>, ..). | |
− | |||
− | |||
− | ** | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | * | ||
− | |||
− | |||
− | |||
− | |||
− | + | * 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 :
- 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
- 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
- Pour chaque proglet
- Teste que les fichiers de la proglet vérifient les spécifications demandées.
- 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
- Génère les doc Java et une version colorisée des sources Java (en option)
- Compile tous les fichiers Java en fichier .class
- 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 javascool-proglets.jar avec tous ces éléments
- fichier javascool-proglet-xxx.jar pour chaque proglet.
- 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