AsWing 入门

环境准备
说白了AsWing就是一套用AS3写成的类库，所以只要有编译AS3程序的环境，就能使用AsWing。

从编译环境来说基本就是2种，一个是Flash CS3，另一个就是 flex sdk。开发工具就很多了，官方的有 FlashCS3，Flex Builder(推荐用FB3)，或者使用开源的FlashDevelop（支持使用flash和flex sdk编译），甚至手动调用mxmlc编译。

有了开发环境，那么我们就要下载AsWing开发包，并且配置我们的开发工具。

可以到 http://code.google.com/p/aswing/downloads/list 下载AsWing开发包。

找到 aswing_a3_1.2_fx.zip 或 aswing_a3_1.2_fl.zip 其中 1.2 表示版本号，一般下载最新的就行。后面的 fx 或 fl 代表适合的编译环境。一般如果用flex sdk的话就下载fx结尾的包。用flashCS3的话就下载fl结尾的。

当然你也可以通过svn客户端取出最新的AsWing代码，具体方法就不再赘述了，svn地址见：http://www.aswing.org/?page_id=4 。

下面具体介绍下在FlexBuilder3和FlashCS3中的配置方法。其他工具雷同。本人使用Windows操作系统，其他系统下的操作方式基本一致。

FlexBuilder3:
将压缩包解压后，找到里面的aswing_a3_1.2.zip，解压，将 AsWingA3/bin 目录中的 AsWingA3.swc 复制到你存放AS代码库的目录。比如我将其放在 E:/AS3 目录中。然后再FB3中新建一个ActionScript项目，右键该项目打开项目属性窗口，选择ActionScript Build Path，然后切换到 Library path，点击 Add SWC… 浏览到刚才复制的那个文件，按照我刚才存放的路径就是 E:/AS3/AsWingA3.swc，然后点击OK即可。
Flash CS3
同样先解压然后找到aswing_a3_1.2.zip并解压，由于Flash IDE不支持使用纯AS打包的SWC作为编译库路径，所以我们先将AsWingA3整个目录复制到所需位置，如 E:/AS3。
然 后打开Flash CS3，点击菜单栏中的 编辑 并打开 首选参数窗口点击左边列表中的ActionScript，然后点下方的 ActionScript 3.0 设置… 打开类路径设置窗口，将AsWing的src目录添加进去，按照我的文件路径就是将 E:\AS3\AsWingA3\src 这个路径添加进去，然后点确定就可以了。
P.S.当然FB3也可以使用目录作为编译路径，就是在Library path 旁的 Source path中添加一个 AsWing的src目录。

第一个例子-Hello World！
FB中在刚才建的ActionScript项目中新建一个ActionScript class文件，输入下面的代码。

package {
import flash.display.Sprite;

import org.aswing.AsWingManager;
import org.aswing.FlowLayout;
import org.aswing.JButton;
import org.aswing.JFrame;
import org.aswing.JOptionPane;
import org.aswing.event.AWEvent;

public class HelloAsWing extends Sprite {

    private var myFrame:JFrame;
    private var myButton:JButton;

    public function HelloAsWing() {
        AsWingManager.initAsStandard(this);

        myButton = new JButton("Click Me");
        myButton.addActionListener(__buttonClicked);

        myFrame = new JFrame(this, "My Frame");
        myFrame.getContentPane().setLayout(new FlowLayout());
        myFrame.getContentPane().append(myButton);

        myFrame.setSizeWH(300, 200);
        myFrame.show();
    }

    private function __buttonClicked(e:AWEvent):void {
        JOptionPane.showMessageDialog("Hello", "Hello, World!");
    }
}
}

如果是使用Flash CS3，可以先新建一个ActionScript文件，输入代码后，保存为HelloAsWing.as，然后新建一个Flash (ActionScript3.0)文件，将该fla文件保存在与HelloAsWing.as的同一级目录中，然后将fla的文档类设置为 HelloAsWing。
实例详细分析
使用AsWing，主程序不需要基于任何应用程序框架，AsWing的UI组件都从flash原生的Sprite扩展而来，所以几乎每一个AsWing组件都能被单独放到DisplayObjectContainer中并能正常使用。
我们的主程序仅需继承Sprite即可，下面分析一下构造函数中的代码。

AsWingManager.initAsStandard(this);

建议在使用AsWing程序之前先调用这个方法，该方法封装了一些常用功能，调用了AsWingManager的setRoot方法，用于设置容纳AsWing组件的容器，这里的this就代表了当前AsWing组件的root。另外还会设置一些系统参数，如 align，scaleMode等。

myButton = new JButton("Click Me");
myButton.addActionListener(__buttonClicked);

JButton 是AsWing中基本的按钮组件，这里新建了一个JButton实例，并设置按钮的Label，第二句代码给按钮添加一个事件监听，当点击按钮后就会触发，这里的addActionListener是AsWing设计成简化了事件监听的写法，当然也可以写成这样 myButton.addEventListener(AWEvent.ACT, __buttonClicked);。
AwEvent是AsWing中最基本的事件类，ACT事件类型表示一些基本组件的触发事件类型，如JButton的鼠标点击事件，JTextField的回车事件等。这里按钮点击后就会执行 __buttonClicked 事件处理函数，函数中代码稍后讨论。

myFrame = new JFrame(this, "My Frame");
myFrame.getContentPane().setLayout(new FlowLayout());
myFrame.getContentPane().append(myButton);

JFrame是常用的窗口组件，有类似操作系统窗口的基本特性，如最小/大化，关闭，缩放，拖动能功能。JFrame的第一个参数指示该窗口所在的容器，第二个参数设置窗口头部的label（即title）。
getContentPane()方法获取JFrame容纳其他组件的容器，向JFrame中添加组件记得不要直接调用JFrame的append方法，JFrame 真正容纳其他组件的不是本身，而是其内部的一个容器，用getContentPane()方法获取。
每个容器排列组件的方式都由Layout控制，setLayout就是设置容器的布局方式，关于布局请参考《AsWing布局管理入门》。
然后就是调用容器的append方法将刚才的按钮加入到JFrame的容器中。

myFrame.setSizeWH(300, 200);
myFrame.show();

这两句代码就比较简单了，设置JFrame的尺寸，并让JFrame显示出来。可能你发现没有使用addChild方法，没关系，JFrame继承 JPopup，所有基于JPopup的组件，AsWing都会自动替你添加到DisplayList中，调用show() 方法就可以设置为可见。

下面看下很简单的事件处理函数

private function __buttonClicked(e:AWEvent):void {
JOptionPane.showMessageDialog("Hello", "Hello, World!");
}

JOptionPane是一个类似Alert的组件，showMessageDialog() 方法即显示一个消息框，第一个参数为消息框的title，第二个参数设置消息内容的字符。

结束语
如今基于flashplayer的RIA技术非常流行，要开发这样的应用程序就免不了会用到与用户交互的UI组件，AsWing正是这样一套强大的组件 库，提供了常用的基本组件，开发者也可能很容易扩展出自己特制的组件。AsWing的灵活使得开发者不会被特定的条件约束，你可以在整个项目中完全使用 AsWing作为GUI交换组件，也可以仅把AsWing的某一个组件用在你的项目中，帮助你快速的得到所需的UI界面。
AsWing的开发者还在不断的改进AsWing，使其更强大，易用。
本文仅介绍了最基本的AsWing使用，其更多强大的性能正等着你来发掘，请参考其他AsWing相关教程。

下载资源
AsWing 下载列表 http://code.google.com/p/aswing/downloads/list
官方下载页，包括svn代码库地址 http://www.aswing.org/?page_id=4
参考资料
AsWing 官方网站 http://www.aswing.org/
API 文档 http://doc.aswing.org/a3/
案例展示 http://www.aswing.org/?page_id=7

评论

2 楼 damoqiongqiu 2011-11-16  

为神马文档没有离线下载的，求离线的文档，求楼主赐文档：[e-mail]

1 楼 zltian 2010-03-25