创建您第一个应用

这章将介绍怎么在一起网上创建和配置Facebook应用，怎样在你的主机上面进行设置。 本文不讨论实际的应用开发过程，你可以参考一起网上的Facebook开发代码案例。使用这些案例，你能够在一起网的开发者中快速的创建一个最基础的Facebook应用。 下面章节介绍创建一个Facebook应用的具体步骤，包括：

• 准备你的应用服务器
• 在一起上添加开发者这个模块.
• 在一起上设置你的Facebook应用.
• 开发你的Facebook应用 (本文不描述).
• 管理和配置你的一起网Facebook应用.

你可以把你的Facebook应用部署在任何环境，一起网和其他第三方开发者即将提供针对不同环境的客户端开发包

• ASP.NET
• ASP (VBScript)
• ColdFusion
• C++
• C#
• D
• Emacs Lisp
• Java
• JavaScript
• Lisp
• Perl
• PHP
• Python
• Ruby on Rails
• VB.NET

目前一起网提供PHP的客户端开发包。你可以从下面地址获取： PHP开发包下载

你选择好环境以后，你需要准备好Facebook应用所在的服务器

为了使你的应用能够在一起网正常工作，你可以采取下面步骤配置的你服务器。

• 确保你的服务器支持HTML，即通过浏览器能够访问你服务器上面的文件。
• 把相应的一起网的Facebook客户端开发包上传到你的服务器。例如，如果你将开发PHP应用，你的客户端开发包在[1]。解压缩压缩包，并且上传PHP文档到你的服务器上面。你需要在你的应用中包含这些包。
• 如果你的应用存储用户信息或者应用信息，请安装数据库，例如MYSQL。更多MYSQL的信息可以在下述地址获取：[2].
• 确保你能够写和平台无关的数据库程序。

你可以在左侧栏点击“个性应用”或者访问[3]进入“我的应用页面”，

点击“成为开发者”按钮可以添加开发者模块。
你添加开发者模块以后，你可以在页面左侧栏看到“开发者”应用，进入开发者页面。

在应用开发者页面，你可以：

• 请求最多100API keys，配置你的应用设置，创建和管理的你已经开发好的Facebook应用。
• 通过开发者群组和其他开发者联系，了解开放平台的新鲜事。
• 获取你需要的参考资料， 包括客户端开发包的链接，能够帮助你开始开发的案例源码和案例应用。

你添加Facebook开发者应用到你的帐户以后，你可以创建你的第一个Facebook应用。除去编码的话，创建一个应用是非常简单的。

1. 在一起网的开发者首页，点击“创建Facebook应用”，在“应用名称”栏输入应用名称，名称最多20个字符，包括英文、汉字和数字。
2. 点击并且阅读《一起网开放平台协议》，确认接受请点击接受单选框，然后才能继续添加应用。。
3. 请在开发者联系Email中输入你的开发者Email，一起网将通过这个地址和你联系应用的相关事宜。这个邮箱地址仅一起网能够查看。这一栏的缺省设置是你的注册邮箱，如果你想修改这个信息，请在该栏输入新的邮箱信息。
4. 请在用户支持Email一栏填写Email信息。你的应用用户可以通过这个邮箱把他们的意见发送给你。该栏的默认地址是你的一起网注册邮箱，你可以在这里修改成其他邮箱。
5. Callback URL一栏，输入你服务器上面的目录地址，这个地址你将创建你的应用。Callback URL有两个功能：
   • 这个页面是用户成功进入你的应用后，重定向跳转的页面地址。
     

     注意：进入一个应用不同于安装一个应用，因为用户可以不安装就进入你的应用。进入应用是指用户鉴权后，你的应用能够获取基础的用户信息，而添加一个应用是指用户吧这个应用添加到他/或者她的一起网帐户下。

   • 这个URL地址也作为你在一起网的Canvas页内容（你的应用的主页）
     
6. 在Canvas Page URL一栏，输入你期望的应用名称。一起网建议你的应用名称和你的URL地址部分保持一致。Canvas Page URL地址必须是唯一的。
   Canvas Page URL提供了应用在一起网平台框架内整合的途径，虽然实事上应用的代码并不在一起网上。Canvas Page内嵌在一起网框架中，在Canvas Page URL下的任何开发都将通过Callback URL来传递。
   Canvas Page也是FBML翻译的所在。FBML不会在你的服务器上被转换，它仅在一起网上转换。这也就是你的应用需要被加载到一起网的原因。
   例如：如果你的Callback RUL是 example.com/， 而你的Canvas Page URL是 apps.yiqi.com/pokewall/，那么apps.qiyiq.com/pokewall/poke.php将向 example.com/poke.php发起请求。
7. 如果你使用FBML来描述你的Canvas Page，选择使用FBML单选框。如果你不使用FBML而是仅计划使用你自己的主机来程序Canvas Page，选择使用iframe单选框。你的Canvas page 将被作为一个内部的frame嵌入到用户的profile中。
   如果你使用了FMBL作为你的Canvas page，一起网服务器将转化你的应用内容，然后呈现给用户。
8. 如果你的应用将通过浏览器访问，请选择Website应用类型。否则，如果你的应用可以下载并且在桌面运行，请选择Desktop类型。
9. 在IP Addresses一栏输入和一起网通信的你的应用服务器IP地址，多个IP地址，请通过逗号分隔每个IP地址。
10. 在TOS URL一栏，输入你的应用使用的协议地址。用户必须接受你的协议以后才能够安装你的应用，然后访问应用。
11. 如果你的应用通过iframe呈现，你可以通过选择Iframe高度来确定需要指定高度还是需要自适应的高度。在Canvas page，自适应高度的Iframe在加载的时候，会自动调整它的大小来适合页面的剩余空间，不过当内容变更时，应用也不能调整Iframe的大小。

一旦用户安装了你的应用之后，下面章节将介绍怎么设定一起网的处理步骤：

1. 你需要指定“安装后跳转地址”，当用户安装后了应用到一起网上之后，将跳转到这个页面。
2. 在“默认FBML”一栏，你可以提供一些默认的FBML代码，当用户安装后你的应用到Profile的时候，这些代码将显示在用户的profile页，之后其他FBML可以显示在用户的Profile页。这仅是应用添加后的默认占位信息，如果你不指定默认FBML，除非你在应用中调用profile.setFBML，否则你的应用将不会显示在Profile页。
3. 如果你仅仅是为了测试的目的，想要限制你的应用仅可以被开发者安装，选择“开发者模式”单选框。

一旦你完成了配置安装选项，你就已经为配置在一起网上的集成选项做好了准备。

你可以为你的应用添加定义集成选项，当用户添加你的应用到他的帐户的时候将生效。

1. 如果你的应用发送消息附件，在Callback URL一栏，输入在你的服务器上保存附件内容的回调地址
2. 当你的应用被安装的时候，指定安装后的动作，选择“私有安装”来设定安装时不做新鲜事通知，不在个人客厅的新鲜事中显示出来。

设置完成后，点击“保存”按钮来保存创建Facebook应用的信息。

在一起网创建了Facebook应用以后，你需要完成应用图标上传，以便用户更好的识别和了解你的应用：

1. 在应用属性页点击编辑图标链接，进入图标编辑窗口。
2. 在图标编辑窗口上传应用对应的图标和ICON

应用图标分为大图标和小图标两种，分别使用情况如下：
* 大图标：大小为48x48，其他用户在应用大全，开发者在开发者首页，这些初次认识到你的应用的场合会用到大图标。
* 小图标：大小为16x16，当用户已经安装您的应用以后在“我的应用”、“侧边栏”，你自己在开发者首页，这些已经熟悉您的应用的场合会用到小图标。

当你完成了应用的基本信息以后，你可以通过应用说明访问应用的试用和说明页面：

1. 你可以在应用属性页，点击链接应用说明，进入应用的试用和说明页面。
2. 点击安装应用，你就可以试用你的应用。
   
   
3. 当你已经安装过应用，应用的说明页面直接显示“转到”按钮，你可以直接点击它进入应用的Canvas页面。

你也可以直接把应用的说明页面地址发送给好友，让他帮忙你一起来试用测试。<br/>一起网的应用试用具有次数限制，当试用用户超出限制后，会应用说明会显示下面信息：

一旦你已经完成了应用的基本信息和图片信息后，你可以在“应用属性页”点击提交应用，经过管理员审批以后，您的应用就可以正式在应用大全中可见了。 管理员审批应用会根据你的应用预览情况，试用情况对你的应用综合评价，如果应用有什么问题或者长时间得不到审批，你可以直接和应用管理员联系。

你可以修改应用的基础配置，点击“编辑应用”链接，将弹出新的应用编辑页面，在这里你可以修改你的应用基础设置、安装设置和集成设置。

你可以编辑应用说明，在应用属性页点击“编辑应用说明链接”，将弹出编辑应用说明页，在这里，你可以：

1. 输入应用说明图片
2. 输入应用说明
3. 输入应用开发者网址
4. 输入应用开发者说明

你可以在应用属性页查看应用的说明信息，点击“应用说明”链接，会弹出应用说明页面：

1. 当应用没有发布和不通过状态，且满足人数的限制，可以通过“应用说明”页来试用应用，你可以把该页面的地址推荐给好友。
2. 当应用已经发布，可以通过“应用说明”来安装应用。
3. 当应用在试用状态，且已经超出人数限制，则会包含提醒信息。