上传您的应用程序

This item was filled under [ GAE使用入门 ]

您可以使用管理控制台在 App Engine 中创建和管理应用程序。为您的应用程序注册了应用程序 ID 后,即可使用名为 appcfg.py 的 SDK 中提供的命令行工具将其上传到您的网站。

注意:截至本文档编写之时,还无法在 App Engine 中删除应用程序。很快就会添加该功能。在此次预览期间,您最多可注册 10 个应用程序 ID。如果您不想在本教程中用掉一个您分配的应用程序 ID,那么,您可以只阅读本部分,并在以后准备上传第一个应用程序时参考本部分。

注册应用程序

您可以从位于以下网址的 App Engine 管理控制台创建以及管理 App Engine 网络应用程序:

http://appengine.google.com/

使用您的 Google 帐户登录到 App Engine。如果您没有 Google 帐户,可以使用电子邮件地址和密码创建一个 Google 帐户

要创建新应用程序,请单击 [创建应用程序] 按钮。请按照说明注册一个应用程序 ID,即一个对该应用程序唯一的名称。如果您选择使用免费的 appspot.com 域名,那么该应用程序的完整网址将为 http://application-id.appspot.com/。您还可以为您的应用程序购买一个顶级域名,或使用一个您已注册的顶级域名。

编辑 app.yaml 文件,然后将 application: 设置的值从 helloworld 更改为您注册的应用程序 ID。

上传应用程序

要将您完成的应用程序上传到 Google App Engine,请运行以下命令:

appcfg.py update helloworld/

在提示下输入您的 Google 用户名和密码。

现在您就可以看到您的应用程序在 App Engine 上运行了。如果您创建了免费的 appspot.com 域名,那么您网站的网址将以您的应用程序 ID 开头:

http://application-id.appspot.com

Bookmark and Share

Hello, World!

This item was filled under [ GAE使用入门 ]

Google App Engine 应用程序使用 CGI 标准与网络服务器进行通信。当服务器收到来自应用程序的请求时,它使用环境变量和标准输入流(对于 POST 数据)中的请求数据运行应用程序。为了做出响应,应用程序会向标准输出流写入响应,包括 HTTP 标头和内容。

让我们开始构建显示简短消息的小型应用程序。

创建简单请求处理程序

创建名为 helloworld 的目录。该应用程序的所有文件都驻留在该目录中。

helloworld 目录中,创建名为 helloworld.py 的文件,并赋予其以下内容:

print 'Content-Type: text/plain'
print ''
print 'Hello, world!'

该 Python 脚本会对带有 HTTP 标头(描述内容、空行和消息 Hello, world!)的请求作出响应。

创建配置文件

App Engine 应用程序中包含名为 app.yaml 的配置文件。除其他内容外,文件还介绍了哪个处理程序脚本应用于哪个网址。

helloworld 目录中,创建名为 app.yaml 的文件,内容如下:

application: helloworld
version: 1
runtime: python
api_version: 1

handlers:
- url: /.*
  script: helloworld.py

从上到下,该配置文件描述了有关该应用程序的以下内容:

  • 应用程序标识符为 helloworld。当您在用 App Engine 注册应用程序的最后步骤时,您将选择唯一标识符,然后更新该值。在开发过程中,该值可以是任意内容。暂时将其设置保留为 helloworld
  • 这是该应用程序代码的版本号 1。如果您在上传新版本的应用程序软件之前调整了该内容,App Engine 将会保留之前的版本,并可让您使用管理控制台回滚到之前的版本。
  • 该代码运行于 python 运行时环境中,版本为 [1]。将来可能支持其他运行时环境和语言。
  • 对路径与正则表达式 /.*(所有网址)匹配的网址的所有请求应由 helloworld.py 脚本进行处理。

该文件的语法为 YAML。有关配置选项的完整列表,请参阅 app.yaml 参考

测试应用程序

用处理程序脚本和配置文件将每个网址映射到处理程序后,应用程序就完成了。您可以立即用 App Engine SDK 附带的网络服务器对其进行测试。

用以下命令启动网络服务器,向其提供到 helloworld 目录的路径:

google_appengine/dev_appserver.py helloworld/

网络服务器正在运行,在端口 8080 监听请求。通过在网络浏览器中访问以下网址测试应用程序:

有关运行开发网络服务器的详细信息(包括如何更改它使用哪个端口),请参阅开发网络服务器参考,或使用 --help 选项运行命令。

重复开发

您可以在开发应用程序时保持网络服务器运行。网络服务器将自动查看您源文件中的更改,并在必要时重新加载它们。

立即尝试:保持网络服务器运行,然后编辑 helloworld.py 以将 Hello, world! 更改为其他内容。重新加载 http://localhost:8080/ 以查看更改。

要关闭网络服务器,请确保终端窗口处于活动状态,然后按 Control-C(或您的控制台上相应的 [break] 键)。

您可以使网络服务器在本教程的其余部分时保持运行。如果您需要停止它,可以通过运行以上命令再次重新启动它。

下一步…

您现在完成了 App Engine 应用程序!您可以立即部署该简单问候并与全球用户共享。但是在部署之前,让我们考虑使用网络应用程序框架来更轻松地添加功能。

Bookmark and Share

开发环境

This item was filled under [ GAE使用入门 ]

使用 App Engine 软件开发套件 (SDK) 为 Google App Engine 开发和上传应用程序。

SDK 包含模拟 App Engine 环境的网络服务器应用程序,其中包括数据库的本地版本、Google 帐户,以及使用 App Engine API 从您的计算机直接抓取网址和发送电子邮件的功能。SDK 可在采用 Python 2.5 的任意计算机上运行,并且有适合 Windows、Mac OS X 和 Linux 的版本。

如有必要,请从 Python 网站为您的平台下载和安装 Python 2.5。Mac OS X 10.5 Leopard 用户已安装 Python 2.5。

下载 App Engine SDK。按照下载页面中的说明在计算机上安装 SDK。

对于本教程,您将使用两个来自 SDK 的命令:

对于 Windows 用户:Windows 安装程序会将这些命令置于命令路径中。安装后,您可以从命令提示符运行这些命令。

对于 Mac 用户:Google App Engine 启动程序会将这些命令包含在应用程序中。您可以通过从 [GoogleAppEngineLauncher] 菜单中选择 [Make Symlinks...] 将这些命令置于命令路径中。或者,您可以使用启动程序来运行开发网络服务器并部署您的应用程序,而不必运行命令。

如果您使用 SDK 的 Zip 归档版本,您将在 google_appengine 目录中找到这些命令。

通过本地开发环境,您可以在向外界推出 App Engine 应用程序之前对其进行全面的开发和测试。让我们写一些代码。

Bookmark and Share

简介

This item was filled under [ GAE使用入门 ]

欢迎使用 Google App Engine!创建 App Engine 应用程序非常简单,只需几分钟时间,而且是免费的:立即上传您的应用程序并与用户共享,不需要支付费用也不需要承担什么义务。

在本教程中,您将创建一个简单的留言簿应用程序,使用户可以在公共信息板上发布消息。用户可以匿名发布,也可以使用其 Google 帐户发布。

留言簿应用程序会演示如何使用 App Engine 数据库、如何将 App Engine 应用程序与 Google 帐户集成,以及如何使用 App Engine 中附带的名为 webapp 的简单 Python 网络框架。应用程序还会演示如何使用 Django 模板引擎。

要开始开发 Google App Engine 应用程序,您必须先下载并设置 App Engine 软件和开发套件。

Bookmark and Share