为 EaselJS 生成 Haxe extern

Question

作为 JavaScript 和 Haxe 的新手，这可能有一个简单的答案，但我发现 Haxe 在 GoogleCode 上有 EaselJS 的 externs 端口，但它们已经过时并对应于早期版本。我已经能够修复编译时发生的错误，但我仍然担心我没有捕获所有新变量和函数名称。

我的问题是：有没有一种简单的方法来为像 EaselJS 这样的大型 JS 库生成外部程序？

Answer 1

您可能想看看 Joshua Granick 使用 BuildJS 所做的工作：

http://www.joshuagranick.com/blog/2011/10/14/use-buildjs-to-make-externs-for-haxe-js-automatically/

基本上有一个工具名为 JSDuck，它应该编译 JavaScript 库的文档，并且可以输出为 JSON。他使用 JSON 的输出，结合他的“buildjs”库来构建 haxe extern。

他将其用于 Sencha Touch，我将其用于 ExtJS，但这两者都是 Sencha 产品，并且众所周知，它们的编码风格可与 JSDuck 配合使用。您可以使用 EaselJS 尝试一下，如果它有效，那么 BuildJS 应该会生成非常准确的外部文件。

否则，您可以尝试找到原始 EaselJS extern 的作者，看看他们是否可以提供更新，或者帮助您创建准确的更新。您可以使用邮件列表或 Google 群组轻松联系大多数 haxe 开发人员：

http:// /groups.google.com/group/haxelang?hl=zh-CN

Answer 2

我的答案有点晚了，但您可以在这里找到 EaselJs 的最新（v0.5.0）外部：

https: //github.com/Fintan/easelhx

我使用 BuildHx (https://github.com/jgranick/buildhx) 生成它们，它现在能够解析 YUIDoc 注释，然后通过移植来测试它们EaselJs 源附带的一些代码示例。

Answer 3

是的，我确实尝试安装 Joshua 的工具，但我遇到了 JSDuck 的问题。

在您链接到的示例中，JSDuck 应该有一个 --json 参数，但最新版本似乎已弃用该参数。我正在尝试其他一些使用配置文件的方法：

{    
"--out": "out",
"--guides": "json",
"--warnings": ["all"],
"--": [
    "src/easeljs/"
]}

但这不起作用。无论我尝试什么，指南参数似乎都会失败。

创建 json 文件给了我这个输出：

C:/Users/mycmp/AppData/Local/Temp/ocr374A.tmp/lib/ruby/gems/1.8/gems/jsduck-3.3.0/lib/jsduck/json_duck.rb:36:in `read': Permission denied - K:/Vault/Haxe/myproj/json (Errno::EACCES)

所以我不知道下一步该做什么。如果能让很多图书馆都能使用这个功能那就太好了。

顺便说一下，我使用的是最新的 JSDuck 和 Windows 7。