====== Starling Builder 扩展指南 ======

你可以在无需重新编译编辑器的情况下扩展Starling Builder的功能。

请参考extension仓库
https://github.com/yuhengh/starling-builder-extensions

目前来说（v0.8），编辑器支持以下两个扩展

  * EmbeddedComponents.swf
  * EmbeddedTheme.swf

===== 编译扩展测试工程 =====

=== IntelliJ IDEA ===

  * 下载安装 AIR SDK 19+ 和 IntelliJ IDEA Ultimate Edition
  * 复制代码仓库: <code>git clone https://github.com/yuhengh/starling-builder-extensions --recursive</code>
  * 在IntelliJ下，通过点击File -> Open打开工程，选择starling-builder-extensions目录
  * 点击菜单File -> Project Structure -> SDKs, 创建一个名为AIRSDK的FLEX/AIR SDK
  * 点击菜单Run -> Edit Configurations, 创建一个Flash App Run/Debug Configuration 并选择 test build config
  * 运行刚创建的Run/Debug configuration

=== Flash Builder ===

  * 下载安装 AIR SDK 19+ 和 Flash Builder 4.7
  * 复制代码仓库: <code>git clone https://github.com/yuhengh/starling-builder-extensions --recursive</code>
  * 点击菜单File -> New -> ActionScript Library Project, 选择starling-builder-extensions文件夹
  * 设置ActionScript Build Path如下

|Source path|starling-builder-editor/src, starling-builder-editor/starling-builder-engine/src, starling-builder-editor/tests/src, tests/src, theme/src, ui-components/src|
|Library path|libs|

  * 右键点击 tests/src/starlingbuilder/demo/Main.as -> Set as Default App
  * 运行工程

{{:builder:test_component.png?750|}}

===== 构建扩展库swf文件 =====

=== IntelliJ IDEA ===

  * 下载安装 AIR SDK 19+ 和 IntelliJ IDEA Ultimate Edition
  * 复制代码仓库: <code>git clone https://github.com/yuhengh/starling-builder-extensions --recursive</code>
  * 在IntelliJ下，通过点击File -> Open打开工程，选择starling-builder-extensions目录
  * 通过点击Build -> Rebuild Project重建工程，把构件好的库文件（swf文件）复制到 YOUR_WORKSPACE/libs 目录下
  * 如果你刚增加／修改完自定义组件，请通过点击Workspace -> Delete template override删除自定义模版
  * 重新读取 Starling Builder

=== 用Ant构建 ===

  * 下载安装 AIR SDK 19+ 和 Apache Ant
  * 复制代码仓库: <code>git clone https://github.com/yuhengh/starling-builder-extensions --recursive</code>
  * 打开文件starling-builder-extensions/buildscript/build.properties, 修改airsdk.root指向你的AIR sdk目录
  * 命令行下cd buildscript进入目录然后输入ant开始构建
  * 把构件好的库文件（swf文件）复制到 YOUR_WORKSPACE/libs 目录下
  * 如果你刚增加／修改完自定义组件，请通过点击Workspace -> Delete template override删除自定义模版
  * 重新读取 Starling Builder

<note important>
注意：由于项目使用git子模块(submodule)管理依赖，请使用git clone --recursive克隆仓库，不要直接下载zip文件，否则会获取不到子模块
</note>

==== EmbeddedComponents.swf ====

如果你需要创建你自己的UI组件，你可以把它们编译进这个扩展里面

你可以从以下位置找到默认的的 EmbeddedComponents.swf
https://github.com/yuhengh/starling-builder-extensions/blob/2.0/deliverable/EmbeddedComponents.swf

更多信息请查看
[[builder:custom_component_cn|自定义UI组件]]


==== EmbeddedTheme.swf ====

如果你需要创建自己的feathers主题，你可以把它编译进这个扩展里面

你可以从以下位置找到默认的的 EmbeddedTheme.swf
https://github.com/yuhengh/starling-builder-extensions/blob/2.0/deliverable/EmbeddedTheme.swf

更多信息请查看
[[builder:theme_cn|自定义feathers主题]]