javascript - 使用 coffeescript 抑制 qooxdoo 中的 "Unknown global symbol"警告

Question

我将 qooxdoo 与谷歌地图 API 结合使用。我实际上是将它与 coffeescript 结合使用，但在我转向 coffeescript 之前我遇到了同样的问题(尽管我怀疑 coffeescript 没有帮助)。

当我构建项目时，我得到了很多这样的行:

  - Warning: myproj.App (22,50): Unknown global symbol used: 'google'
  - Warning: myproj.App (22,76): Unknown global symbol used: 'google.maps'
  - Warning: myproj.App (23,21): Unknown global symbol used: 'google'
  - Warning: myproj.App (23,47): Unknown global symbol used: 'google'
  - Warning: myproj.App (23,74): Unknown global symbol used: 'google.maps'
  - Warning: myproj.App (15,18): Unknown global symbol used: 'google.maps.LatLng'

我找到了很多对 @ignoreUndefined 或 @ignore 的引用来摆脱这个，所有这些都应该放在这样的 javadoc 注释中:

/**
 * @ignore(google.*)
 */

但是，我一直无法让它工作。我已经尝试过@ignoreUndefined 和@ignore，带括号和不带括号，单独使用 google，使用 google.，使用 google*，使用google.*，带有明确的 google.maps.LatLng(以及所有其他的)和一些其他变体。在 coffeescript 中，我尝试将其全部放在 ### block 中，也尝试放在文件顶部的 block 中，如下所示:

`/**
  * @ignoreUndefined google
  */`

或

`/** @ignore(google) */`

(反引号将它直接插入 javascript 源代码中，不受干扰)。

我真正想做的是在 config.json 中添加一些内容，告诉它停止提示 google。*(这比每个文件更简单，因为它会出现在每个文件中) ，但我找不到办法做到这一点。这开始成为一个问题，因为我在 Unknown global symbol used: 'google...

的页面中遗漏了真正的错误

谁能告诉我我做错了什么？

---

编辑

感谢理查德，我现在可以正常使用它了。如果它对其他人有用，我的 config.json 看起来像这样(删除了不相关的位):

{
    ...

    "config-warnings" :
    {
        "job-shadowing": ["common", "lint", "source-all", "build"]
    },

    "jobs" :
    {
        "build" :
        {
            "run" :
            [
                "coffee-compile",
                "build-resources",
                "build-script",
                "build-files"
            ]
        },
        "source-all" :
        {
            "run" :
            [
                "coffee-compile",
                "source-all-script"
            ]
        },
        "common":
        {
            "lint-check": {
                "allowed-globals": [
                    "google"
                ]
            }
        },
        "lint":
        {
            "lint-check": {
                "allowed-globals": [
                    "google"
                ]
            }
        },
        "coffee-compile" :
        {
            "extend": ["common"],
            "shell" :
            {
                "command": "coffee --bare --compile --output ./source/class/myapp/ ./coffee/myapp/*.coffee"
            }
        }
    }
}

Answer 1

我假设您正在使用 qooxdoo 3.0(当前的 github master 分支 - 尚未发布但很快)它引入了 @ignore 语法(取代旧的 #ignore句法)。我在我的 config.json 中让它像这样工作:

{
  "config-warnings" :
  {
    "job-shadowing" : ["source"],
  },

  ...

  "jobs" :
  {
    ...

    "source" :
    {   
      "lint-check" : { 
        "allowed-globals" : [ 
           "google"
        ]   
      }   
    }   
  }
}

像这样更改 config.json 应该也适用于 qooxdoo 2.1.1。

继续阅读:

• > http://manual.qooxdoo.org/3.0/pages/development/api_jsdoc_at_ignore.html
• > http://manual.qooxdoo.org/3.0/pages/development/api_jsdoc_ref.html#ignore
• > http://manual.qooxdoo.org/3.0/pages/tool/generator/generator_config_ref.html#config-warnings
• > http://manual.qooxdoo.org/3.0/pages/tool/migration/migration_guide.html#compiler-hints