My favorites | 中文(繁體) | Sign in
英文版或許有比此中譯版新的內容

使用 Eclipse 專用的 Google 外掛程式

跟開發其他 servlet 網路應用程式一樣，您可以使用 Eclipse 開發環境，輕鬆開發您的 Java「應用服務引擎」應用程式。而「Eclipse 專用的 Google 外掛程式」將使一切更加容易。這個外掛程式可讓您在 Eclipse 建立、測試與上傳「應用服務引擎」應用程式。

「Eclipse 專用的 Google 外掛程式」也可以使用 Google Web Toolkit (GWT) 開發應用程式，並在「應用服務引擎」或任何其他環境中執行。

這篇文章將說明如何安裝「Eclipse 專用的 Google 外掛程式」、如何建立新的「應用服務引擎」專案，以及如何使用 Eclipse 的執行開發伺服器除錯。文章也會描述如何使用這個外掛程式，將應用程式專案上傳至「應用服務引擎」。

如需外掛程式的詳細資訊，包括外掛程式在 Google Web Toolkit 專案的使用，請參閱「Eclipse 專用的 Google 外掛程式」文件。


取得 Eclipse

您可以從 Eclipse 網站 (英文網站) 取得 Eclipse。「Java EE 開發人員專用的 Eclipse IDE」包含所有開發網路應用程式所需的元件。

「Eclipse 專用的 Google 外掛程式」目前提供 Eclipse 3.3 (Europa) 和 Eclipse 3.4 (Ganymede) 的版本。

開發網頁時，除了「Eclipse 專用的 Google 外掛程式」，我們也建議您使用 Web Tools Platform (WTP) 外掛程式。請參閱 Web Tools Platform 網站 (英文網站)。WTP 提供許多功能，包括 JSP 和 HTML 檔案的編輯模式。

安裝 Eclipse 專用的 Google 外掛程式

您可以使用 Eclipse 的 Software Update (軟體更新) 功能，安裝「Eclipse 專用的 Google 外掛程式」。

如要使用 Eclipse 3.4 (Ganymede) 安裝外掛程式：

  1. 選取 [Help] (說明) 功能表 > [Software Updates...] (軟體更新...)，即可開啟 [Software Updates and Add-ons] (軟體更新和附加元件) 視窗。
  2. 選取 [Available Software](可用軟體) 標籤，再按一下 [Add Site...] (新增網站...) 按鈕，即可開啟 [Add Site] (新增網站) 視窗。然後，在 [Location] (位置) 輸入 Eclipse 3.4 版本外掛程式的安裝位置： 
    http://dl.google.com/eclipse/plugin/3.4
    按一下 [OK] (確定)。對話方塊隨即關閉，而新的位置會加到可用軟體的清單中。

  3. 按一下新的安裝位置旁邊的三角形，然後按一下 [Google] 旁邊的三角形，即可顯示安裝選項。勾選 [Google Plugin for Eclipse 3.4] (Eclipse 3.4 專用的 Google 外掛程式) 以及 [Google App Engine Java SDK] (Google 應用服務引擎 Java SDK) 旁邊的方塊。如要在應用程式使用 Google Web Toolkit，您也可以選取 [Google Web Toolkit SDK]。按一下 [Install...] (安裝...) 按鈕。按照提示接受服務條款，並安裝外掛程式。

    注意：因為 Eclipse 會更新相依性，所以外掛程式的安裝程序需要幾分鐘才能完成。如需詳細資訊，請參閱「常見問題」。

  4. 安裝完畢之後，Eclipse 會提示您重新啟動。按一下 [Yes] (是)。Eclipse 會重新啟動。外掛程式完成安裝。

Eclipse 3.3 (Europa) 外掛程式的安裝程序也很類似，但是出現的提示不同，而安裝位置也不一樣。「Eclipse 3.4 專用的 Google 外掛程式」的位置如下所示：

  • http://dl.google.com/eclipse/plugin/3.3

如需「軟體更新」的詳細資訊，請參閱 Eclipse 文件。

建立專案

如要建立新的「應用服務引擎」專案：

  1. 選取 [File] (檔案) 功能表 > [New] (新增) > [Web Application Project] (網路應用程式專案) (如果您找不到這個功能表選項，請選取 [Window] (視窗) 功能表 > [Reset Perspective...] (重設視景)，再按一下 [OK] (確定)，然後重試 [File] (檔案) 功能表)。或者，按一下工具列中的 [New Web Application Project) (新增網路應用程式專案)：新增網路應用程式專案按鈕，
  2. 即可開啟 [New Web Application Project] (新增網路應用程式專案) 精靈。在 [Project name] (專案名稱) 輸入專案的名稱，例如輸入 Guestbook 代表「入門指南」所述的專案。在 [Package] (套件) 輸入適當的套件名稱，例如 guestbook。
  3. 如果您使用的不是 Google Web Toolkit，請取消勾選 [Use Google Web Toolkit]。確定您已勾選 [Use Google App Engine] (使用 Google 應用服務引擎)。
  4. 如果您是透過「軟體更新」安裝「應用服務引擎 SDK」， 這個外掛程式已經過設定‧將使用安裝的 SDK。如果您想使用個別安裝的「應用服務引擎 SDK」，請按一下 [Configure SDKs...] (設定 SDK...)，然後按照提示新增含 appengine-java-sdk/ 目錄的設定。
  5. 按一下 [Finish] (完成)，以建立專案。

精靈會建立一個專案的目錄結構，包括存放 Java 來源檔案的 src/ 目錄，以及 war/ 目錄，可用於存放編譯的類別以及應用程式、程式庫、設定檔、靜態檔 (例如影像 和 CSS) 以及其他資料檔。精靈也會建立一個 servlet 來源檔案以及兩個設定檔。完整的目錄結構如下：

Guestbook/
  src/
    guestbook/
      server/
        GuestbookServlet.java
    META-INF/
      jdoconfig.xml
    log4j.properties
    logging.properties
  war/
    WEB-INF/
      lib/
        ...App Engine JARs...
      appengine-web.xml
      web.xml
    index.html

war/ 目錄採用 WAR 標準配置包裝網路應用程式。(SDK 尚未支援 WAR 封存檔案)。Eclipse 外掛程式會使用這個目錄執行開發伺服器，以及部署應用程式至「應用服務引擎」。

建置您的專案時，Eclipse 會在 war/WEB-INF/ 中建立 classes/ 目錄，然後將編譯的類別檔案放到裡面。Eclipse 也會將在 src/ 中所發現的非來源檔複製到 war/WEB-INF/classes/，包括 META-INF/、log4j.properties 以及 logging.properties 檔案。war/ 目錄的最終內容會構成您的應用程式，可用於測試與部署。

如需進一步瞭解外掛程式所建立的新專案，請參閱「入門指南」。

執行專案

「應用服務引擎 SDK」包含一個網頁伺服器，可以在模擬的環境中測試您的應用程式。「Eclipse 專用的 Google 外掛程式」會將新的項目加到 [Run] (執行) 功能表， 以啟動這個伺服器。

如要在 Eclipse 除錯工具裡面的網頁伺服器執行應用程式，請選取 [Run] (執行) 功能表的 [Debug As](除錯方式) > [Web Application] (網路應用程式)。Eclipse 會建置專案，再切換到 [Debug] (除錯) 視景，即可啟動伺服器。如果伺服器啟動成功，將在「控制台」顯示多個訊息，包括類似下列的訊息：

The server is running at http://localhost:8080/

如要自訂伺服器啟動方式，您可以建立一個「網路應用程式」類型的「執行/除錯」設定。

如要測試外掛程式所建立的新應用程式，請按照上述步驟啟動伺服器，然後在您的瀏覽器開啟下列 URL (選擇適用於您的應用程式的 URL 路徑)：

透過 Eclipse，您可以讓伺服器繼續在除錯工具中執行，同時可以變更原始碼、JSP、靜態檔案以及 appengine-web.xml。儲存原始碼的變更時，Eclipse 會自動編譯類別，然後嘗試將類別動態插入執行中的網頁伺服器。在大部分的情況下，您只需要在瀏覽器重新載入頁面，即可測試新版本的程式碼。開發伺服器會自動辨識 JSP、靜態檔案以及 appengine-web.xml 的變更，這些變更不需重新啟動伺服器即可生效。如果您變更 web.xml 或其他設定檔，您必須停止再重新啟動伺服器，變更才會生效。

如要停止伺服器，請確定已選取 [Debug] (除錯)，再按一下 [Terminate] (終止) 按鈕：Eclipse 終止按鈕。

上傳至 Google 應用服務引擎

「Eclipse 專用的 Google 外掛程式」會在 Eclipse 工具列新增數個按鈕。「應用服務」部署按鈕會將您的應用程式上傳至「應用服務引擎」：應用服務引擎部署按鈕。

第一次上傳應用程式之前，您必須透過「管理控制台」，向「應用服務引擎」註冊應用程式 ID。註冊應用程式 ID，然後編輯 appengine-web.xml 檔案，並變更 <application>...</application> 元素以納入新的 ID。

按一下「應用服務引擎」部署按鈕，Eclipse 即會提示您輸入管理員帳戶使用者名稱 (您的電子郵件地址) 和密碼。輸入帳戶資訊，再按一下 [Upload](上傳) 按鈕完成上傳。Eclipse 會從 appengine-web.xml 檔案取得應用程式 ID 和版本資訊，然後上傳 war/ 目錄的內容。

如要測試您的「應用服務引擎」應用程式，請瀏覽下列 URL：

  • http://<your application ID>.appspot.com/guestbook

執行命令列工具

「應用服務引擎 Java SDK」工具的部分功能必須透過命令列直接執行工具，才能使用。如果您已使用 Eclipse 安裝 SDK，您可以從 Eclipse 外掛程式安裝目錄執行這些工具。

SDK 位於 Eclipse 安裝目錄的 plugins/com.google.appengine.eclipse.sdkbundle_VERSION/ 底下，其中 VERSION 為 SDK 的版本識別碼。在這個目錄中，appengine-java-sdk/bin/ 子目錄包含工具。

注意：如果您使用的是 Mac OS X 或 Linux，您必須先授予命令檔執行權限，才能執行命令檔。舉例來說，如要授予 appcfg.sh 執行權限，請從 appengine-java-sdk/bin/ 目錄輸入下列命令：chmod u+x appcfg.sh

如需命令列專屬功能的詳細資訊，請參閱「上傳與管理」。