設定 Eclipse 來運用 Google App Engine 進行 Python 2 的開發與偵錯作業

使用 Eclipse 和 PyDev 外掛程式開始進行本機開發與偵錯作業。這項設定可讓您以偵錯模式在本機執行 App Engine 應用程式,並透過 Eclipse 的偵錯功能設定中斷點並逐步執行程式碼。PyDev 外掛程式提供能與 App Engine 搭配使用的協助工具功能,包括建立新手專案及部署應用程式。

事前準備

  1. 如果您尚未安裝 Python,請安裝 Python 2.7不確定目前安裝的版本嗎?
  2. 從 SDK 下載頁面的「Optional」專區安裝 Python 專用的原始 App Engine SDK

檢查 Python 版本

如要檢查安裝的 Python 版本為何,請執行下列指令:

python --version

安裝 Eclipse

下列操作說明假設您要安裝的是以 Eclipse Neon (4.6) 為基礎的 Eclipse IDE for JavaScript and Web Developers。請使用 Eclipse Installer 輕鬆執行安裝程序。

  1. 安裝 Eclipse Installer
  2. 在 Eclipse Installer 中,依序點選 [Eclipse IDE for JavaScript and Web Developers] 套件和 [Install]。

    使用 Eclipse Installer 安裝 Eclipse。螢幕擷圖。

  3. 安裝作業完成之後,請點選 [Launch]

  4. 在 Eclipse 啟動後,指定工作區位置或接受預設值。

安裝 PyDev

安裝 Eclipse 後,您應安裝 PyDev 外掛程式以將 Eclipse 當做 Python IDE 使用。

  1. 在 Eclipse 中,依序點選 [Help] > [Eclipse Marketplace]
  2. 在「Find」 欄位中,指定「PyDev」。

    在 Eclipse 市集中找到並安裝 PyDev。螢幕擷圖。

  3. 按一下 [Install] 並完成安裝精靈。

  4. 系統出現提示時,重新啟動 Eclipse。

設定專案

  1. 依序點選 [File] > [New] > [Project] 以建立新專案。

  2. 在「Select a wizard」頁面,選取 [PyDev Google App Engine Project]

    選取 Pydev 專案精靈。螢幕擷圖。

  3. 在「PyDev Project」頁面中,為專案命名。接著,點選 [Please configure an interpreter before proceeding],讓 Eclipse 設定預設解譯器。

    如果 Eclipse 找不到 Python 2.7 解譯器,請點選 [Click here to configure an interpreter not listed] 連結來設定解譯器。

  4. 按一下「Google App Engine」頁面中的 [Browse],並找到先前安裝 App Engine SDK 的目錄。在哪裡?

    在建立專案時指定 App Engine SDK 的位置。螢幕擷圖。

  5. 點選 [Next] 繼續設定基本專案,或是點選 [Finish] 開啟空白專案。

  6. 如要設定專案,請指定專案 ID。如要查看專案 ID,則請前往 GCP 主控台。如果您尚未登錄專案,可以指定暫時名稱。系統會將這個名稱列入專案的 app.yaml 檔案,您可以之後再視情況決定是否變更。

  7. 選擇新手範本。建議:使用 Hello World 範本來產生 app.yaml 檔案和簡易 Python 指令碼。您之後可以使用自己慣用的架構 (例如 Flask 或 Django) 執行開發作業。

SDK 的預設位置

macOS
如果使用 Google App Engine 啟動器安裝 SDK,啟動器啟動時,系統會提示您建立 symlink。如果您已建立 symlink,預設位置為:
/usr/local/google_appengine
如果您並未建立 symlink,預設位置為:
/Applications/GoogleAppEngineLauncher.app/Contents/Resources/GoogleAppEngine-default.bundle/Contents/Resources/google_appengine
Linux
您擷取下載的 SDK zip 檔案的位置。
Windows
C:\Program Files (x86)\Google\google_appengine\

匯入程式庫以供 Eclipse 辨識

設定專案後,您可以選擇程式碼依據的程式庫。您不僅需要將程式庫匯入專案,設定專案載入這個程式庫,還需要指示 Eclipse 使用這個程式庫。

要讓 Eclipse 辨識匯入的程式庫:

  1. 將資料庫匯入專案。
  2. 編輯 Eclipse 專案的屬性:對專案按一下滑鼠右鍵,然後選取 [Properties]
  3. 在對話方塊的導覽窗格中選取 [PyDev - PYTHONPATH]
  4. 如果您是在專案的子資料夾 (例如「lib」) 中管理資料庫,請點選 [Add source folder]

接著,Eclipse 會將您指定的資料庫新增至 Python 路徑,以便解析匯入項目。

在偵錯模式中啟動應用程式

您可以在 Eclipse 的偵錯模式中執行應用程式,以在程式碼中設定中斷點。執行這些指令行時,處理作業會暫停,讓您可以檢查程式碼並逐步完成執行作業。這項功能在開發應用程式時相當實用。

設定偵錯設定

您初次在偵錯模式中啟動應用程式時,系統會建立偵錯設定,方便您之後執行或為建構作業新增參數而調整設定。

  1. 在專案瀏覽器中,對專案名稱按一下滑鼠右鍵,然後依序選取 [Debug As] > [PyDev: Google App Run]。

    主控台檢視畫面中應該會開啟並顯示開發伺服器的系統輸出內容,包括應用程式執行的網址。

  2. 前往主控台中顯示的網址,確認應用程式正在運作。根據預設,應用程式會從 http://localhost:8080 開始執行。如果您使用的是 Hello World 新手範本,應該會在瀏覽器中看見「Hello, world!」的字樣。

偵錯模式現在會在 Eclipse 中執行。您同時也建立了偵錯設定,之後您如果離開 Eclipse,或需要停止並重新啟動偵錯工具,也能再次執行。

設定中斷點以逐步執行程式碼

偵錯工具開始運作之後,您即可設定中斷點來逐步完成程式碼執行工作。

  1. 開啟 Eclipse 專案中的檔案。舉例來說,如果您使用的是新手範本,請開啟 helloworld.py 檔案。

  2. 找到您要設定中斷點的程式碼,然後對程式碼旁的行數按一下滑鼠右鍵,再選取 [Add Breakpoint]

    您對 Eclipse 中的行數按一下滑鼠右鍵時,系統顯示的內容選單。螢幕擷圖。

    設定中斷點的程式碼行會出現綠色圓圈。

  3. 返回瀏覽器並開啟網址,以便執行已設定中斷點的程式碼行。觸發中斷點之後,Eclipse 會詢問您是否要切換為偵錯模式。

  4. 如果系統提示您切換至偵錯模式,請按一下 [Yes]。這個模式會提供程式碼偵錯專用的視圖,包括「Variables」視圖。

    Eclipse IDE 偵錯模式的完整螢幕擷圖,當中包含多個偵錯視圖。

    在變數檢視器中,您可以檢查程式碼目前定義的物件與變數。

    選單列按鈕可提供下列控制功能:

    • 繼續執行的圖示 繼續執行,直到遇到下一個中斷點或完成執行作業。
    • 繼續執行的圖示 前往較低層級的程式碼,例如方法。
    • 逐行瀏覽的圖示 逐行瀏覽目前的程式碼,而非前往較低層級的程式碼。
    • 返回較高一層程式碼的圖示 返回較高層級的程式碼。如果您前往較低層級的程式碼,可以選擇直接返回較高層級的程式碼,而不必等到較低層級的程式碼執行完畢才返回發出呼叫的程式碼。
    • 終止執行的圖示 終止執行作業。
    • 略過剩餘中斷點的圖示 略過剩餘的中斷點。
  5. 按一下「繼續」圖示 (繼續圖示) 繼續進行程序,並允許開發伺服器將簡單的「Hello, World!」回應傳送至瀏覽器。

完成偵錯之後,如果您想要切換回 PyDev 模式,請依序選取 [Window] > [Perspective] > [Open Perspective] 和 [Pydev]。或者,您也可以點選 Eclipse 右上角的 PyDev 圖示:

顯示在 Eclipse 中快速切換功能的圖示

透過 Eclipse 部署應用程式

您可以使用 Eclipse 專用的 PyDev 外掛程式從工作區部署應用程式。

  1. 使用 Google Cloud Platform 主控台設定 Google Cloud Platform 專案:

    選取或建立 GCP 專案並確認其包含 App Engine 應用程式:

    前往 App Engine

    如果專案中已經有 App Engine 應用程式,系統會開啟「Dashboard」(資訊主頁)。如果沒有的話,系統會提示您選擇 App Engine 應用程式的存放地區

    提示:專案 ID 會變為應用程式網址的一部分,例如 http://[YOUR_PROJECT_ID].appspot.com

  2. 在 Eclipse 中編輯 app.yaml 檔案並變更 GCP 專案 ID 的 application 元素值。

  3. 在 PyDev Package Explorer 或 Project Explorer 視圖中,對專案資料夾按一下滑鼠右鍵,然後依序選取 [PyDev Google App Engine] > [Upload]

    在專案上按一下滑鼠右鍵而顯示 App Engine 的 PyDev 上傳選項的內容選單圖片

    如果這是您第一次執行 App Engine SDK 管理指令,系統會提示您授權 SDK 來授予工具存取權限,以便修改 App Engine 應用程式。按一下 [Allow]

    瀏覽器視窗顯示「The authentication flow has completed」並返回 Eclipse 之後,您就可以關閉瀏覽器視窗。

  4. 透過「Manage Google App Engine」對話方塊確認應用程式上傳成功:

    確認上傳步驟與上傳成功的對話方塊螢幕擷取畫面

  5. 前往 http://[YOUR_PROJECT_ID].appspot.com,您應該可以看見應用程式正在提供流量。

後續步驟

設定好開發環境後,您可以透過下列主題開始使用 App Engine:

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Python 2 適用的 App Engine 標準環境