AppFuse項目的主要目的是幫助你加速web應用程序的開發。下面說明如何利用它創建一個新工程的基本步驟。

1.      安裝 J2SE 1.4.2+ 并設置環境變量JAVA_HOME指向J2SE所在的目錄。

2.      下載 源程序報或者從CVS(cvs -d :pserver:guest@cvs.dev.java.net:/cvs co appfuse)中檢出appfuse模塊。

注意: 你可以使用the all-in-one installer 一次性下載安裝AppFuse 1.8, Ant 1.6.2, Tomcat 5.0.28 和 MySQL 4.1.11 (for Windows)。查看相關的 README.txt 文件可以了解更多信息。

3.      安裝 Install Ant 1.6.2+ 并設置 ANT_HOME 環境變量。 安裝 Tomcat 4.1.x+ (推薦使用Tomcat 5.0.28) 并設置 CATALINA_HOME 環境變量指向對應的Tomcat安裝目錄。 參閱我的文章 設置開發環境 可以了解在哪里下載到這些程序并且可以了解我通常如何安裝配置這些程序。

4.      安裝 MySQL 3.23.x+ (推薦使用 4.1.7).

注意: 如果你使用 MySQL 4.1.7, 確定正確設置了 UTF-8 字符集和 InnoDB 表類型。 這里說明如何設置 。

5.      設置本機的 SMTP server 或者修改 mail.properties 文件(在 web/WEB-INF/classes 目錄下) 和 build.properties 文件(在根目錄下 -- 給 log4j 消息使用) 以使用一個已有的smtp server - 默認值是 localhost。

6.      把文件 lib/junit3.8.1/junit.jar 拷貝到 $ANT_HOME/lib目錄下。

注意: 你可能會發現在 $ANT_HOME/lib目錄已經有一個 ant-junit.jar 文件了. 這個 jar 包不是 JUnit 類庫, 而是 Ant 的 junit task 實現，在執行Ant junit task時會使用你新增的這個junit.jar 文件。

7.      如果你計劃使用 iBATIS (代替 Hibernate) 或者 struts 以外的 web framework, 現在安裝它們 (安裝指令下面可以查到)。安裝完成以后, 在appfuse目錄下運行 ant new 。會提示你輸入application name, database name 和 package name。完成這些操作以后會在appfuse同級目錄家里一個包含新程序所需要的全部文件的以你輸入的application name命名的目錄。

警告: 請不要在輸入的application name, database name 和 package name使用 "test", 包含 "appfuse" 的名稱 或者 以數字作為起始字符的名稱，否則將會導致任務無法正常執行，此外使用兩個破折號 (-) 會造成結果混亂。

8.      切換到這個新的工程目錄并且運行 ant setup (或者運行 ant setup-db setup-tomcat deploy) 創建數據庫，配置tomcat并發布你的新應用程序。創建數據庫的任務只有在你的root用戶密碼為空的情況下才能工作。需要的話你可以修改 build.properties 文件if necessary. 需要 安裝設置幫助setup?

9.      若你細想要進行測試以確定所有程序工作良好，運行 ant test-all - 在運行這個任務的時候確定 Tomcat 沒有啟動。 接下來, 運行 ant test-reports - 運行結束后會顯示消息告訴你如何查看產生的報告。

在你確認你正確的完成了上述步驟以后 - 瀏覽一下 指南 了解如何使用appfuse開發程序。

安裝的可選項

如果你希望使用 iBATIS 作為持久化framework, 查看extras/ibatis目錄下的 README.txt 文件或者運行 ant install-ibatis。

如果你希望使用 Spring 作為web framework, 查看 extras/spring 目錄下的 README.txt 文件或者運行 ant install-springmvc。

如果你希望使用 WebWork 作為web framework, 查看extras/webwork 目錄下的 README.txt 文件或者運行 ant install-webwork。

如果你希望使用 JSF 作為web framework, 查看 extras/jsf 目錄下的 README.txt 文件或者運行 ant install-jsf。

如果你希望使用 Tapestry 作為web framework, 查看 extras/tapestry 目錄下的 README.txt 文件或者運行 ant install-tapestry。

如果你想寫腳本自動基于Appfuse創建并測試自己的工程。在CVS上面有兩個我已經寫好的用來測試的腳本供參考： spring+ibatis 和 webwork 。 注意在實際開發過程中最好不要使用 "appfuse" 作為工程名 因為可能會造成不必要的查找/替換。

如果你不希望安裝 iBATIS, Spring MVC, WebWork, JSF 和 Tapestry - 你應該在把它們檢入前刪除extras下的相關目錄。

注意: 安裝程序會修改 Eclipse classpath, 但是不會是理想的方法。 你需要人工修改它。