AppFuse項目的主要目的是幫助你加速web應用程序的開發。下面說明如何利用它創建一個新工程的基本步驟。
1. 安裝 J2SE 1.4.2+ 並設置環境變量JAVA_HOME指向J2SE所在的目錄。
2. 下載源程序報或者從CVS(cvs -d :pserver:[email protected]:/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開發程序。
安裝的可選項
注意: 安裝程序會修改 Eclipse classpath, 但是不會是理想的方法。 你需要人工修改它。