为Flash Builder 4创建包含ASDoc的SWCs

来源页面: http://blogs.adobe.com/jasonsj/2010/04/build_swcs_with_asdoc_for_flash_builder_4.html
资讯原标题: Build SWCs with ASDoc for Flash Builder 4
资讯原作者: Jason San Jose

你可能早已经知道Flash Builder 4已经添加ASDoc支持了。我们可以在代码提示、鼠标悬停在代码上时以及在ASDoc视图中看到ASDoc。我们已经内置支持显示以下各项的ASDoc内容:

• Flex 4 SDK
   
• playerglobal.swc 和 airglobal.swc
   
• 当前工作区中引用的库项目
   
• 当前项目中的ASDoc内容
   

但是，如果你没有发布你的源代码的话，你是不能发布捆绑有ASDoc的SWCs的。

Gaurav写了一篇不错的博文来详细介绍SDK怎么样使用Ant来包含ASDoc，他使用了framework.swc作为例子。你应该认识到，用SDK捆绑ASDoc有所不同，这样做是为了创造本地特有的资源包，它包含了本地特有的ASDoc内容。这对于用户的意义是在Flash
Builder的ASDoc内容已经本地化了。

对于大多数不需要本地化他们的文档的库开发者来说，这个过程更加简单。

我已经将一个作为例子的库项目放在出来了，你可以下载，它里面有一个简单的Ant脚本，你可以放到你的项目上去用。这个脚本主要是运行ASDoc工具、解压你的SWC，然后将ASDoc DITA文件捆绑到SWC上，而不用创建一个单独的资源包。

Download:ExampleFatSWC.fxpl - http://blogs.adobe.com/jasonsj/ExampleFatSWC.fxpl

在Flash Builder:
1. File> Import, Flash Builder > Flash Builder Project
2. 浏览到FXPL文件
3. 完成
4. 右键单击build.xml文件并选择Run As > Ant Build
5. 那个"fat"SWC已经在你的/bin文件夹下随时可以共享了

当你的用户添加SWC到他们的项目库路径下时，他们会看到ASDoc内容，而无须额外的操作。

记住，要想在Flash Builder中运行Ant，你将需要去合适的更新网站下载Eclipse Java Development Tools。对于Eclipse 3.5或者Flash Builder Standalone用户，访问http://download.eclipse.org/releases/galileo 并查找"Eclispe Java Development Tools"。