GAEO 正體中文文件

最新協作平台活動

教學‎ > ‎

create-applications


[!]  注意

如果你在 Mac 下使用 eazy_install 安裝 GAEO,setuptools 會在 /usr/local/bin 下建一個 symlink 到 .py,指令會略有不同,例如 gaeo.py 會變成 
gaeo

使用 gaeo.py 建立 GAEO 專案

在工作目錄(例如: ~/Works) 鍵入:

gaeo.py hello

hello 為專案名稱,gaeo.py 會自動建立名稱為 hello 的目錄。 然後你會在 ~/Works/hello 找到如下內容:



GAEO 專案結構說明

  • app.yaml, favicon.ico, main.py
app.yamlmain.py 為 Google App Engine application 主要的設定檔,詳細使用方法請閱讀。  在專案建立時,GAEO 會在 main.py 產生必須的程式碼,在絕大多數的狀況中,你不會需要修改 main.py
由於部份瀏覽器會自動存取 favicon.ico 而在Develope Server 中產生無意義的 404 Error 訊息 ,因此 GAEO 會產生一個空的 favicon.ico 來避開這個狀況。
  • application/
MVC 中的 controllers, models, and templates。 這部份會在後面的章節詳加說明。
  • assets/
GAEO 會在 app.yaml 幫你設定好圖片、CSS、Javascript 的靜態位置 ( assets/img, assets/css, assets/js )。例:你可以透過瀏覽 http://<HOST>/img/foo.png 來存取你放在 assets/img 目錄下的 foo.png 圖片。 CSS 及 Javascript 亦同.
  • gaeo/
主要的 GAEO 函式庫。升級新版的 GAEO 只需要置換此目錄。 若想使用開發中的最新版本,請使用 SVN Checkout  http://google-app-engine-oil.googlecode.com/svn/trunk/gaeo .
  • plugins/ (2.0版本後加入)
Gaeo 會自動執行 Gae Application 下的 plugins 裡的 pacakge ,並且當成 Gaeo 的 Plugin。舉個例子,若你要建立一個 MemberPlugin,第一步便是在 plugins 目錄下建立一個 member 目錄,並且把 Plguin 的程式寫在 plugins/member/__init__.py 裡,MemberPlugin 要使用的 model , 靜態檔案如 CSS / HTML / Javascript 則放在 plugins/member/ 目錄裡。  這部份會在後面的章節詳加說明。

GAEO 架構


執行 App Engine 開發伺服器

若已經正確安裝 Google App Engine SDK, 在應用程式目錄裡鍵入以下命令。

dev_appserver.py .

或是透過各平台的的 Launcher ( Launcher in MAC )。



然後打開瀏覽器,並連到 http://localhost:8080/ , 如果看到以下畫面,代表你成功了!