Robotlegs 技术文档

1. 安装指南

下载

Robotlegs 是一个用于 Flash 和 Flex 的 ActionScript 应用程序框架。你可以通过访问 Robotlegs 官方网站 下载框架。

开发环境

Robotlegs 推荐使用 IntelliJ IDEA 进行开发。你可以通过以下步骤配置开发环境：

1. 安装 IntelliJ IDEA。
2. 配置 Flex SDK，确保使用 Flex 4.6 SDK 或更高版本。
3. 导入 Robotlegs 项目到 IntelliJ IDEA 中。

构建工具

Robotlegs 支持使用 ANT、Maven 和 Buildr 进行构建。以下是使用 ANT 进行构建的步骤：

1. 复制 user.properties.eg 文件并重命名为 user.properties。
2. 编辑 user.properties 文件，指向你的本地 Flex SDK。
3. 运行以下命令进行构建：

   ant package
   

2. 项目的使用说明

创建上下文（Context）

在 Robotlegs 中，创建一个应用程序或模块需要实例化一个 Context。以下是创建上下文的示例代码：

纯 ActionScript

_context = new Context()
    .install(MVCSBundle)
    .configure(MyAppConfig, SomeOtherConfig)
    .configure(new ContextView(this));

Flex

<fx:Declarations>
    <rl2:ContextBuilder>
        <mvcs:MVCSBundle/>
        <config:MyAppConfig/>
    </rl2:ContextBuilder>
</fx:Declarations>

上下文初始化

如果提供了 ContextView，上下文会在提供的视图进入舞台时自动初始化。如果没有提供 ContextView，则需要手动初始化上下文：

_context = new Context()
    .install(MyCompanyBundle)
    .configure(MyAppConfig, SomeOtherConfig)
    .initialize();

3. 项目 API 使用文档

配置文件示例

以下是一个简单的应用程序配置文件示例：

public class MyAppConfig implements IConfig
{
    [Inject]
    public var injector:IInjector;

    [Inject]
    public var mediatorMap:IMediatorMap;

    [Inject]
    public var commandMap:IEventCommandMap;

    [Inject]
    public var contextView:ContextView;

    public function configure():void
    {
        // Map UserModel as a context enforced singleton
        injector.map(UserModel).asSingleton();

        // Create a UserProfileMediator for each UserProfileView
        // that lands inside of the Context View
        mediatorMap.map(UserProfileView).toMediator(UserProfileMediator);

        // Execute UserSignInCommand when UserEvent.SIGN_IN
        // is dispatched on the context's Event Dispatcher
        commandMap.map(UserEvent.SIGN_IN).toCommand(UserSignInCommand);

        // Add Main View to the Context View
        contextView.view.addChild(new MainView());
    }
}

中介者示例

以下是一个中介者的示例：

public class UserProfileMediator extends Mediator
{
    [Inject]
    public var view:UserProfileView;

    override public function initialize():void
    {
        // Redispatch an event from the view to the framework
        addViewListener(UserEvent.SIGN_IN, dispatch);
    }
}

命令示例

以下是一个命令的示例：

public class UserSignInCommand extends Command
{
    [Inject]
    public var event:UserEvent;

    [Inject]
    public var model:UserModel;

    override public function execute():void
    {
        if (event.username == "bob")
            model.signedIn = true;
    }
}

4. 项目安装方式

使用 ANT 构建

1. 复制 user.properties.eg 文件并重命名为 user.properties。
2. 编辑 user.properties 文件，指向你的本地 Flex SDK。
3. 运行以下命令进行构建：

   ant package
   

使用 Maven 构建

请参考 Maven-README 文件中的说明进行构建。

使用 Buildr 构建（适用于 OSX）

1. 安装 XCode 3 或 4。
2. 检查 RubyGems 版本，如果版本低于 1.3.6，则更新 RubyGems。
3. 安装 Bundler 并运行 bundle install 安装依赖。
4. 运行 bundle exec buildr test 构建 Robotlegs 并运行测试。
5. 打开测试报告 reports/flexunit4/html/index.html。

通过以上步骤，你可以成功安装和使用 Robotlegs 框架。