用opensocial开发sns游戏 (2)

2008-12-21, 06:14

从零开始认识google app engine、opensocial和51开发环境

一、首先我们从google app engine开始，因为这将是我们所有代码放置的地方。
（可参考Google App Engine使用入门）
1、配置开发环境
这里要做的事情主要包括安装Python、GoogleAppEngine的SDK。注意Python的版本是2.5.x，更新的版本有可能会有一些小错误。
2、申请GoogleAppEngine（可参考这位朋友的Google App Engine 申请注册指南）
申请过程是需要填一个手机号码的，虽然网上常说只支持中国联通，但是我的移动的号码也是成功申请到了。申请成功以后登录appengine.google.com，使用你的google账号登录后点击Create an Application按钮建立一个新项目。例如我的项目名称是akane2002helloworld，请将你申请的时候所用的名字记下来，因为开发和以后访问都需要用到这个名字。我这个名字对应的网址就是akane2002helloworld.appspot.com。
3、开始使用GAE（google app engine的缩写，免得每次都写那么长）
因为我们现在的目的还只是熟悉GAE，就从Hello World开始吧。在GAE SDK的安装目录里面有一个new_project_template目录，实际上这就是一个完成了的Hello World程序。经过简单的修改就能在你自己的空间运行。这个目录里面有三个文件，其中app.yaml这个文件是每个GAE项目都有的，定义了项目的主要配置。内容如下：

application: new-project-template
version: 1
runtime: python
api_version: 1
 
handlers:
- url: .*
  script: main.py

其中第0行是项目的名称，这里就需要把new-project-template换成你在第2步中申请时所用的名字，对于我来说就是akane2002helloworld。然后后面几行的意思都一目了然，最后在handlers：后面的两行的意思是对于访问我的站点的任意url（*为通配符），都交给main.py这个文件来处理。
再看看main.py这个文件：

import wsgiref.handlers
from google.appengine.ext import webapp
class MainHandler(webapp.RequestHandler):
  def get(self):
    self.response.out.write('Hello world!')
 
def main():
  application = webapp.WSGIApplication([('/', MainHandler)],
                                       debug=True)
  wsgiref.handlers.CGIHandler().run(application)
 
if __name__ == '__main__':
  main()

需要注意的是python是以缩进来代替大括号标识代码段的。这段代码的意思就是，对于路径'/'的访问，通过MainHandler这个函数返回一个“Hello world！”的信息。也就是说，对http://akane2002helloworld.appspot.com的访问，将得到一个Hello world!的返回信息。
4、将代码上传
如果你和我一样是在windows下开发的话，在“开始”“运行”中进入cmd命令行模式，然后来到上一步中所提到的这三个文件的目录。运行下面的命令：

appcfg.py update .

这句话的意思是把当前目录的代码上传至GAE的空间。到这里我们就完成了一个基本的运行在GAE上的Hello world网络应用。
到这里，如果你要检查你是否都做对了，就访问你一下你申请的应用的地址——http://yourapplicationname.appspot.com，如果在页面上出现了一个Hello world！，那么你就可以继续下面的步骤了。

二、OpenSocial
（可参考OpenSocial Tutorial）
每个OpenSocial的应用实际上都是通过一个xml文件来定义的。这里我们又将遇到OpenSocial的helloworld例子，随便利用一个好用的文本编辑器（我用EditPlus）建立一个helloworld.xml文件，内容如下：

<?xml version="1.0" encoding="UTF-8" ?>
<Module>
  <ModulePrefs title="Hello World!">
    <Require feature="opensocial-0.8" />
  </ModulePrefs>
  <Content type="html">
    <![CDATA[
      Hello, world!
    ]]>
  </Content>
</Module>

这一段代码定义了该应用的标题是Hello World！内容是一段html，仅包含Hello, world!。
这就完成了一个最基本的OpenSocial应用，向每个访问这个应用的人显示Hello world！
但是现在，这段OpenSocial的代码还仅仅在你的电脑上，接下来我们要将其放入你申请的GAE应用中，使得51.com能够直接访问到。
这时我们需要为我们的GAE应用添加一个静态目录，所谓静态目录就是指能够直接用url访问到的目录。比如刚才我们的app.yaml和main.py文件，虽然他们是在我们应用的根目录下，但是我们通过http://yourappname.appspot.com/main.py是无法访问到这个文件的。
于是我们新建一个static目录，将刚刚写好的helloworld.xml放入这个目录。然后把app.yaml中的代码改动如下：

application: yourappname
version: 1
runtime: python
api_version: 1
 
handlers:
- url: /static
  static_dir: static
 
- url: /.*
  script: helloworld.py

这里加入的两行代码的意思是，对于形如http://yourappname.appspot.com/static/aaa.bbb这样的url，那么把它当作一个静态文件来访问，也就是能够直接得到static目录中的aaa.bbb文件。于是，我们再次使用appcfg.py update . 命令将新加入的helloworld.xml更新上去。这时，我们应该能直接用浏览器访问到http://yourappname.appspot.com/static/helloworld.xml这个文件了。

三、申请51.com应用
（参考51的开始帮助）
首先你登入51.com后进入添加小应用的页面，在51自己开发的应用中找到“工具”这一项，然后把“开发者”和“开发工具”这两个应用加入自己的边栏方便以后调用。进入“开发者”应用，点击右上角的“创建一个新应用”，这时会有一个表格让你填写，大多数内容你可以随意填写，因为你可以在后面随时更改，值得注意的有以下几点：
1、回调地址。
对于OpenSocial开发的应用来说，这里填写你的OpenSocial应用对应的xml文件的地址即可。就是http://yourappname.appspot.com/static/helloworld.xml这个路径。
2、画布地址。
这个实际上可以理解成你的应用在51.com上的路径，如果你在这里填写aabbcc，那么以后任何人都可以通过apps.51.com/aabbcc来访问你的应用。
3、程序方式选择。
对于OpenSocial开发的应用，这里当然要选OpenSocial。
4、图标
51.com申请应用时最麻烦的就是这一步，你必须自己弄三个不同大小的图片文件上传作为你的应用在不同场合会出现的图标。
当你填完所有的项目并点击“提交”后，一个应用就成功的创建了。这也就完成了当前这篇教程的全部内容。要检查是否一切顺利，请通过http://apps.51.com/aabbcc访问你申请的应用（aabbcc为你的画布地址），这时，如果Hello world！出现在你的51页面上，那么意味着你已经完成了这一课要做的所有事情。