AppFuseQuickStart_fr

This is version 4. It is not the current version, and thus it cannot be edited.
[Back to current version]   [Restore this version]

1. Installez J2SE 1.4.2+ et configurez la variable d'environnement JAVA_HOME vers le répertoire où vous l'avez installé.

1. Téléchargez les sources ou réalisez un checkout du module appfuse du CVS (cvs -d :pserver:[email protected]:/cvs co appfuse).
   NOTE: Vous pouvez également télécharger AppFuse 1.8, Ant 1.6.2, Tomcat 5.0.28 and MySQL 4.1.11 (for Windows) en utilisant l'installeur tout-en-un. Lisez le fichier README.txt pour plus d'informations.
2. Installez Ant 1.6.2+ et configurez la variable d'environnement ANT_HOME. Installez Tomcat 4.1.x+ (version 5.0.28 recommandée) et configurez la variable d'environnement CATALINA_HOME pour qu'elle pointe vers le répertoire d'installation de Tomcat. Allez voir mon environnement de développement pour avoir les liens vers ces packages et pour voir ou j'ai l'habitude de les installer.
3. Installez MySQL 3.23.x+ (version 4.1.7 recommandée).
   NOTE: Si vous utilisez MySQL 4.1.7, vérifiez que vous utilisez l'UTF-8 character set et une table de type InnoDB. Comment faire?.
4. Configurez un serveur SMTP en local ou modifiez le fichier mail.properties (dans le répertoire web/WEB-INF/classes) et le fichier build.properties (à la racine -- pour les messages log4j ) pour qu'ils pointent vers une congiguration existante - Par défaut vers localhost.
5. Copiez lib/junit3.8.1/junit.jar vers $ANT_HOME/lib.
   NOTE: Vous allez peut-être voir un fichier ant-junit.jar dans $ANT_HOME/lib. Ce jar n'est pas la librairie JUnit mais il est utilisé par la tâche JUnit Ant qui utilisera le fichier junit.jar que vous venez de placer dans ce répertoire.
6. Si vous prévoyez d'utiliser iBATIS (à la place d'Hibernate) ou un framework web autre que Struts, utilisez les instructions suivantes.
7. Lancez ant new à partir du répertoire appfuse. Vous serons alors demandé un nom d'application, un nom de base de données et un nom de package. Après les avoir saisise, un répertoire contenant votre nouvelle application web sera crée dans le même répertoire que celui d'Appfuse.
   WARNING: Certaines valeurs pour le nom de l'application ne fonctionneront pas - ne pas utiliser "test", ou une valeur comprenant "appfuse" ou une valeur commencent avec un chiffre. De même, deux tirets (-) dans le nom poseront problème.
8. Allez dans le répertoire de votre nouveau projet et exécutez ant setup (ou ant setup-db setup-tomcat deploy) pour créer la base de données, configurer Tomcat et déployer votre application. La configuration de la base de données fonctionnera uniquement si l'utilisateur de base n'a pas de mot de passe. Vous pouvez le modifiez dans le fichier build.properties si nécessaire. Besoin d'assistance pour la configuration de mysql ?
9. Si vous voulez tester et être sûr que tout fonctionne, exécutez ant test-all - vérifiez que Tomcat soit stoppé quand vous lancez la commande. Ensuite, exécutez ant test-reports - Une fois la tâche réalisée, un message vous indiquant comment voir les rapports générés.

Après avoir confirmé votre installation via les étapes précédentes - Allez voir Tutorials pour apprendre comment développer avec AppFuse.

Optional Installations

• Si vous preferez utiliser iBATIS comme framework de persistance, lisez le fichier README.txt dans extras/ibatis ou exécutez ant install-ibatis.
• Si vous préférez utiliser Spring comme framework web, lisez le fichier README.txt dansextras/spring or run ant install-springmvc.
• Si vous préférez utiliser WebWork comme framework web, lisez le fichier README.txt dans extras/webwork ou exécutez ant install-webwork.
• Si vous préférez utiliser JSF comme framework web, lisez le fichier README.txt dans extras/jsf or executez ant install-jsf.
• Si vous préférez utiliser Tapestry comme framework web, lisez le fichier README.txt dans extras/tapestry ou exécutez ant install-tapestry.

• Si vous désirez, vous pouvez écrire un script pour automatiser la création et le test de votre projet. Il y a en de nombreux sur le CVS que j'utilise pour les tester: spring+ibatis etwebwork. Utiliser "appfuse" comme nom pour un projet réel est une mauvaise idée car l'application remplacera certaines choses qu'elle ne devrait pas..
• Si vous ne désirez pas installer iBATIS, Spring MVC, WebWork, JSF or Tapestry - Vous pouvez supprimer leurs installations dans le répertoire extras avant de lancer l'installation.