本頁說明如何使用或修改 Google Visualization Java 程式庫，以及如何為專案開放原始碼貢獻心力。
目錄
相關規定
您必須具備下列元件，才能使用 Google 視覺化 Java 程式庫：
- 一個 Protocol 容器和 會 WhatsApp API 2.4 或更高版本。最常用的 CR 容器之一是 Apache Tomcat，內含 剖析 API 的元件。如要下載 5.5 版的二進位檔，請參閱 http://tomcat.apache.org/download-55.cgi。您只需安裝核心模組。您還需要 Tomcat 才能完成教學課程章節：開始使用、使用外部資料儲存庫，以及定義功能和事件流。
- Java Development Kit 6.0 以上版本。
注意：您也可以使用 JDK 5.0 版。不過，您必須從程式庫中每個覆寫介面方法的方法中移除
@Override。這是因為 JDK 6.0 版中的@Override註解行為有所變更。
依附元件
資料來源 Java 程式庫具有下列依附元件。該程式庫已通過下列版本測試；其他版本或許也能接受，但並未經過測試。
包含在來源或下載項目中：
- icu4j 4.0.1 版。
- Jakarta Commons lang 版本 2.4。
- Jakarta Commons Logging 1.1.1 版。
- Google 集合程式庫 1.0 版。
- javacc 4.2 版。 只有在要編譯程式庫時，才需要這麼做，例如在修改程式庫時，詳情請參閱下文。
- opencsv 1.8 版。只有在要使用 CSV 資料來源時，才需要執行此操作。
未包含在來源或下載項目中：
- 如要搭配 mySQL 資料庫使用
SqlDataSourceHelper類別，執行階段環境中還需要mysql.jar。詳情請參閱 http://www.mysql.com/products/connector/j/。
使用提供的程式庫
本節說明如何在不需要修改時，使用視覺化 Java 程式庫。這項程序會因建構系統而異：
如果使用 Maven，請使用下列設定在視覺化程式庫中設定依附元件：
- 群組 ID：com.google.visualization
- 構件 ID：視覺化資料來源
- 版本號碼：請使用專案頁面中列出的最新版本編號。
如果使用其他建構系統：
- 從專案頁面下載程式庫 ZIP 檔案，將檔案解壓縮，然後視建構系統需要的檔案納入專案中。
執行範例
JAR 範例檔案會與程式庫 JAR 一併包含在可下載的 ZIP 檔案中。如需執行範例的操作說明，請參閱開始使用頁面。
修改程式庫
如要修改程式庫程式碼，您必須從開放原始碼代管網站下載原始碼，然後著手建立。在這之前，請先參閱專案頁面上「程式碼授權」一節提供的授權資訊，確認該用途是否符合規定。
下載及建構程式庫的步驟如下：
- 按照開放原始碼專案頁面中「來源」>「結帳」分頁的說明，使用 SVN 下載原始碼。
- 建構程式碼。如果是在 Maven 中建構，請使用來源提供的 pom.xml 檔案。如果使用 Apache Ant 進行建構，請按照後續提供的操作說明進行 (請注意，程式碼已使用 Ant 1.7.0 版進行測試；如果您有舊版 Ant，可能需要升級)
Ant 版本說明
1. 修改建構屬性：
- 前往所選安裝目錄的
build-src子目錄。 - 使用文字編輯器開啟
build.properties檔案，然後進行下列變更：- 編輯
servlet-api.jar屬性以指向servlet-api.jar檔案。舉例來說，如果您已將 Tomcat 安裝到tomcat_home目錄中的c:磁碟，就必須按照以下方式指定servlet-api.jar屬性：
servlet-api.jar=C:/tomcat_home/common/lib/servlet-api.jar注意：在檔案路徑中使用正斜線，而非反斜線，即使使用 Windows 也無妨
- 如要使用自己的上述依附元件副本，請編輯同一個 build.properties 檔案中的路徑。
- 編輯
2. 建構程式庫：
前往檔案中的 build-src 子目錄，輸入下列其中一個值：
ant datasource：建構資料來源程式庫ant example：建構範例ant- 建構資料來源和範例ant test：建構並執行資料來源程式庫測試。修改程式庫時非常實用。
為開放原始碼專案貢獻心力
如要修改開放原始碼專案，您必須取得該專案的提交權限。傳送電子郵件至 google-visualization-api@googlegroups.com，詢問有關如何提交變更的權限和操作說明。