qooxdoo1.0 manual

Hello world:

这个教程是教你怎么样一步步地使用qooxdoo来创建出你的第一个应用的。

创建框架：

要求：

请确认你已经读了”要求“的细节。重述一下，自由几个要求需要满足来做qooxdoo应用开发：

客户端：任何主要的浏览器

服务器端：任何能解析http的后端。在开发期间可以使用本地文件系统。

操作系统：任何

工具：python

下载：

到官网下载最新稳定的 SDK

安装：

解压SDK档

创建你的应用：

很容易通过跨平台的工具create-application.py来创建你自己的应用。它将在你指定的目录建立一个骨架应用，一切都会根据你的qooxdoo框架版本来自动配置。

以win32为例子：

让我们在C盘创建一个叫做custom的应用，假设我们的SDK在C:\qooxdoo-0.8.3-sdk :

C:\qooxdoo-0.8.3-sdk\tool\bin\create-application.py --name=custom --out=C:

运行你的应用：

现在你的应用已经建立了，让我们产生一个可以在浏览器中打开的版本。到新创建的应用目录下，使用自动建立过程：

cd C:/custom
generate.py source-all

请注意，附加的source-all目标是在qooxdoo 0.8.1中引入的 。常规的source目标现在只包含那些你的应用需要的qooxdoo类，而不是全部的类。

在应用被产生之后，在浏览器中打开source/index.html文件来运行你的应用并点按钮：



 

写应用代码：

文件夹source/class包含你所有的应用类。新建的应用 ，只有一个文件custom/Application.js。在编辑器或开发环境中打开它。

其中的main()方法包含你骨架应用的所有代码。即使你在做任何qooxdoo编程之前，你也应该能了解这些代码做了什么。熟悉一下代码并改变它，比如，改变按钮的标签，将按钮移动到其他位置或者增加一个按钮。

要看到改变，你必须在浏览器中刷新 ，比如按下F5。开发中，没有必要重新创建叫做"source"版本的应用。只有当你引入了新的类或者类之间的依赖赶边了之后，你将必须重新生成你的应用。这样，在刷新你的浏览器之前执行generate.py source-all（包含所有的源类）或者generate.py source（只包含需要的类）。

Debugging：

在你新的应用中你可能已经注意到下面的代码：

if (qx.core.Variant.isSet("qx.debug", "on"))
{
qx.log.appender.Native;
qx.log.appender.Console;
}

这个代码打开两个不同方式的日志。比如捕获并打印出你的应用的操作信息。

qx.log.appender.Native使用客户端原生的日志功能，比如FF中的Firebug(使用F12切换)。如果你的浏览器没有利于开发的日志，qx.log.appender.Console为所有的浏览器提供这一功能：这个控制台在你的浏览器中的一快区域中打印出日志信息。它也包含一个交互的js壳(使用F7来切换)：

封闭两种日志类的原因在下一部分中会被详细解释。它保证日志仅仅在开发版本中被打开。它将会在部署版本中被自动关闭。

Deployment

qooxdoo应用的开发版本被叫做"source"版本，部署版本叫做"build"版本。很容易就能创建：

generate.py build

成功执行之后，从build文件夹中打开index.html。你虽然看不到和之前的有什么变化，但是它应该更快了。

不同于source版本的需要大量的没有修改的js文件，build版本只需要加载一个优化了的js文件。大量的调试代码也在build版本创建时被移除了。

API Reference

generate.py api

Unit Testing

generate.py test