您無法使用最新版 dev_appserver.py,在本機執行已終止支援的執行階段應用程式。如要繼續使用封存的 dev_appserver.py 版本,請按照本指南的指示操作。
您可以使用本機開發伺服器模擬在實際工作環境中執行 App Engine 應用程式,也可以使用該伺服器存取 App Engine 舊版套裝服務。模擬環境會強制執行幾項沙箱限制 (例如設有使用限制的系統功能和執行階段語言模組匯入服務),但不包含要求逾時或配額等其他限制。
App Engine 適用的 SDK 所含程式庫提供多項服務 (包括 Datastore、Memcache 和工作佇列),而本機開發伺服器也會在本機中執行這些服務的工作,以便進行模擬。在開發伺服器中執行應用程式時,仍可使用 Google API HTTP 端點對正式基礎架構進行遠端 API 呼叫。
事前準備
如要下載 devapp_server.py 的封存版本,請按照下列步驟操作:
從封存中,下載包含
dev_appserver.py伺服器的壓縮資料夾,適用於支援期限已屆滿的執行階段。將目錄內容解壓縮到本機檔案系統,例如
/home目錄。您可以在google_appengine/目錄中找到dev_appserver.py。
設定本機開發伺服器
如要執行本機開發伺服器工具,請設定下列項目:
確認您已安裝 Python 2 解譯器,且版本為 2.7.12 以上。
在殼層中,將
DEVAPPSERVER_PYTHON環境變數設為 Python 2 解譯器的路徑。在解壓縮下載的封存檔案後,找出
/google_appengine/資料夾下的dev_appserver.py工具,例如:DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py
執行本機開發伺服器
設定本機開發伺服器並為應用程式建立 app.yaml 設定檔後,即可使用 dev_appserver.py 指令在本機執行應用程式。
如要啟動本機開發伺服器:
如果您使用 --port 選項指定自訂通訊埠,請務必在瀏覽器中開啟該通訊埠。
如要透過指令列停止本機伺服器,請按下下列按鍵:
- macOS 或 Linux:Control+C
- Windows:Control+Break
指定應用程式 ID
偵測應用程式執行階段環境
使用本機 Datastore 服務
使用郵件服務
本機開發伺服器可透過 SMTP 伺服器或安裝於本機的 Sendmail 來傳送呼叫 App Engine 郵件服務的電子郵件。
使用 SMTP
如要透過 SMTP 伺服器來啟用郵件支援功能,請叫用 dev_appserver.py,如下所示:
python2 DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py --smtp_host=smtp.example.com --smtp_port=25 \
--smtp_user=ajohnson --smtp_password=k1tt3ns PATH_TO_YOUR_APP
取代:
- DEVAPPSERVER_ROOT,其中包含您解壓縮
devapp_server.py封存版本的資料夾路徑。 --smtp_host、--smtp_port、--smtp_user和--smtp_password選項,並提供自己的設定值。- 將 PATH_TO_YOUR_APP 替換為應用程式的路徑。
使用 Sendmail
如要透過 Sendmail 啟用郵件支援功能,請叫用 dev_appserver.py,如下所示:
python2 DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py --enable_sendmail=yes PATH_TO_YOUR_APP
取代:
- DEVAPPSERVER_ROOT,其中包含您解壓縮
devapp_server.py封存版本的資料夾路徑。 - 將 PATH_TO_YOUR_APP 替換為應用程式的路徑。
本機伺服器會使用 sendmail 指令,以安裝的預設設定傳送電子郵件訊息。
使用網址擷取服務
應用程式使用 URL Fetch API 發出 HTTP 要求時,本機開發伺服器會直接從您的電腦發出要求。如果您是使用 Proxy 伺服器來存取網站,本機伺服器中的 URL Fetch 行為可能會與實際工作環境 App Engine 不同。
使用 Users 服務
App Engine 提供使用者服務,可簡化應用程式的驗證和授權程序。本機開發伺服器會使用本身的登入和登出頁面模擬 Google 帳戶的行為。
指令列引數
如需本機開發伺服器指令選項,請參閱本機開發伺服器選項。